Do You Need The Service Catalog?by Jay Cuthrell
This week we take a look at service catalog frameworks, the internal developer platform (IDP), and developer experience (DevX).
To understand the concept of a service catalog, it is important to consider that, historically, an _IT service catalog_ is typically associated with a web based portal for end users (knowledge workers) to request common IT services. Essentially, the IT service catalog is meant to enable orderly requests for anything from software (application/licenses) to a device (PC/mobile/etc.) to support (technical/business) to infrastructure (servers, storage, networking, cloud, etc.).
Today, the evolution of the IT service catalog continues as new technologies like progress indicators, conversational chat bots with ML/AI, and realtime language translation. Further, there are multiple ISV suppliers of solutions that have pivoted to SaaS offerings that originated from IT buyer persona roots, HR buyer persona roots, and a newer set of players with software development buyer persona roots or similarly cloud native origins as donations to the Cloud Native Computing Foundation (CNCF).
Of course, not all end users are the same and there are different needs that might not be as common but that are very important — such as the needs of software application developers as end users. For that reason, the notion of a _software team specific_ service catalog is of growing importance as more companies embrace digital transformation and express their businesses through increasingly sophisticated software applications.
As a recap, Fudge Sunday briefly covered the concept of a service catalog in Build a Cloud Platform Foundation and IDP Clearly Now. However, a shorter definition for service catalog is available on internaldeveloperplatform.org that is loosely based on a similar _developer portal_ definition from Gartner… but here’s my wordier take to bridge developer portal and service catalog and platform engineering:
A Service Catalog is an exhaustively curated self-service list of developer empowering capabilities that is easily discovered, accessed, and consumed as a foundational part of developer experience such as an internal developer platform or developer portal supported by a platform engineering team.
Over time, interest in improving overall DevX is growing regardless of which phrase we choose to use. However, the key consideration is that developers are the newest audience to satisfy for all aspects of providing better DevX.
Now, if the service catalog is the goal, the next step is to plan and find the right toolchain to help populate and present a service catalog. The toolchain might be a service catalog framework, a service catalog product, or even a third-party managed service catalog SaaS itself.
At this point, you might be wondering what a service catalog or a developer portal might look like. That’s a natural curiosity and the most important thing to remember is that the _look and feel_ will ultimately depend on the needs of the developers meant to be served and how well the curated elements are presented by the platform engineering team.
Luckily, the growing importance of the service catalog and IDP topic has resulted in simultaneously growing bodies of content to satisfy curiosity for what is possible. In addition, internal platform engineering toolchain projects within digitally native organizations are being exported outside as open source projects entering the sandbox with many incubated to graduated within the CNCF.
In fact, there are now multiple service catalog, developer portal, and IDP options that can be considered as a project to adopt or to be consumed as a service (IDPaaS). Here are just a few examples that are publicly accessible showcases.
- Backstage Community offers a showcase demo with no email required and also has a YouTube channel in addition to being an Incubating Project on the CNCF Landscape
- Janus Community offers a showcase demo with no email required and also has a YouTube channel
- Port offers a showcase demo with no email required and also has a YouTube channel _Update 22-May-2023: Roni Florman shared a catalog setup video by Viktor Farcic_ 🙏
- Mia-Platform offers a demo but you’ll need to share your company email or check out their YouTube channel
- Humanitec offers a demo but you’ll need to share your company email or check out their YouTube channel
- Roadie offers a demo but you’ll need to share your company email or check out their YouTube channel
- OpsLevel offers a demo but you’ll need to share your company email or check out their YouTube channel
- Cortex offers a demo but you’ll need to share your company email
- configure8 offers a demo but you’ll need to share your company email
They key concept each of these options represents is the variety of choices in pursuit of improving DevX. For groups of practitioners and business leaders focused on software development, there exists a spectrum of increasingly opinionated choices from open source projects to service catalog frameworks to IDP to IDPaaS.
During the link gathering for this issue of the newsletter, several YouTube videos described what it takes to get a developer portal stood up, populate the service catalog, get the IDP adopted, and not become a cautionary tale of thinking everything will be a batteries included outcome. It was hard to pick just one but please take time to check out each video for the wide range of lessons learned:
- Lessons learned from Taras Mankovski
- Lessons learned from Alan Barr
- Lessons learned from Dominik Rose
- Lessons learned from Austin Lamon
So, what will be the next big thing in service catalog frameworks, IDP, IDPaaS, and DevX?
Until then… Place your bets!
I am linking to my disclosure.
✍️ 🤓 Edit on Github 🐙 ✍️
Get Fudge Sunday each week