OpsLevel Logo
Product
Developer portal
Software catalog
Understand your entire architecture at a glance
Standards
Your guide to safe, reliable software
Developer self-service
Empower developers to move faster, risk-free
Integrations
Connect your most powerful third-party tools
Use Cases
Ownership
Build accountability and clarity into your catalog
Standardization
Set and rollout best practices for your software
Developer Experience
Free up your team to focus on high-impact work
Customers
Resources
All Resources
Our full library of resources
Pricing
Flexible and designed for your unique needs
Podcast
Podcast
Conversations with technical leaders
Blog
Blog
DevOps resources, tips, and best practices
Demo
Demo
Videos of our product and features
Tech talk
Tech talk
Our POV on technical topics
Guide
Guide
Practical resources to roll out new programs and features
DocsLog In
Talk to usTry for free
No items found.
Share this
Table of contents
 
Resources
Blog

Discovering the best developer portal for your org

Insights
DevX
Visibility
Tooling
Automation
Standardization
Platform engineer
Engineering leadership
Catalog
Rubric
Scorecard
Actions
Service Creation
Discovering the best developer portal for your org
Sylvia Fronczak
|
March 10, 2023
Discovering the best developer portal for your org

If you’re investigating developer portals, you may already see the need for one in your organization. 

Perhaps you’ve noticed that onboarding developers to new services takes too long, that teams spend a lot of time in meetings instead of writing software, or that finding documentation and service owners has become increasingly difficult. 

Even if you already recognize the problems, the tough part is finding the solution that works best for your org. There’s an increasing number of tools and platforms, all with their own integrations into your org’s tool suite. Sometimes they’re focused on service discoverability. Other times they focus on operational needs. So how can you bring together all the needs of your org and ensure that you have a holistic solution—not just another tool?

To help you get started, we’ll walk you through considerations for establishing your internal developer portal and how it can meet your needs across your development lifecycle.

Introducing internal developer portals

Internal developer portals (IDPs) provide a central hub for your developers to build, operate, and integrate with tools and services across your developer ecosystem. An IDP offers self-service functionality, documentation, and easy integration to those tools and services.

Implemented correctly, an IDP allows developers to quickly find all information about a given service—including which team owns it, how it impacts other services in the ecosystem, and whether it adheres to the organization’s software standards. This helps developers onboard faster, prioritize work effectively, and self-serve more efficiently day-to-day. 

IDPs and the software lifecycle

Whether your organization follows traditional software development lifecycles (SDLCs) or more modern agile, lean, or continuous lifecycles, the OpsLevel IDP can support all phases:

  • Ideation & Discovery
  • Development
  • Testing
  • Deployment
  • Operation
  • Deprecation

With your IDP and service catalog, you can ensure all the information relevant to your software is in one place. 

Where you want to focus your efforts will depend on your organization’s needs and pain points. Let’s dive into these a bit further to show you what problems they solve.

In a microservice architecture, creating a new service can happen frequently.

Ideation and discovery

During ideation and discovery, we begin to understand the needs for the software we’re about to build. This phase includes analysis of requirements and product-market fit, identifying risks, design of a solution, and prototyping. In some software methodologies, it also involves user interviews, prototyping, and lightweight product testing.

Most importantly, the discovery phase involves setting appropriate goals and metrics for the product.

All of this data will become important as you build out the software product—and with an IDP, you’ll have a central place to store the documentation and track relevant metrics.

Development

Once we know what we’re building and why, development begins. In a microservice architecture, creating a new service can happen frequently—and you may have noticed that many of your teams run into a similar pattern each time. 

When teams create new products or services, they create the code repository, the project, the CI/CD pipeline, and more, all from scratch. Though the team is focused on shipping a new product, they have to first complete this setup work—and it isn’t one of their core competencies. This work is important, but it isn’t done as frequently by your developers.

If the process involves a lot of manual setup, inconsistencies between teams start to develop. For example, between different teams, the CI/CD pipelines may handle secrets differently or use different deployment conventions. These inconsistencies across teams can lead to security vulnerabilities, poor deployment patterns, and support burdens as each team needs to deal with a different snowflake of processes and configuration.

So how can IDPs help? Your IDP can include templates, automation, requirement checks, expectations, and anything else you need to build consistent and standard services. This makes standing up a new service easy. The development team doesn’t have to learn everything about your infrastructure and CI/CD pipelines to start, and new services are guaranteed to use the same standards as existing services.

Building out an IDP that supports service creation can provide the following benefits:

  • Automation - The team won’t spend time repeating boilerplate setup.
  • Standardization - The new service will utilize common configuration standards across your org.
  • Deployment management - Your org can work with a proven and visible deployment pipeline that is automated and has the proper governance built in.
  • Focus on the product - Automating service creation through your IDP allows teams to focus on building the product or service.
  • Improved Speed to market - Teams spend less time on learning the tools and pipelines when shipping new services.

The potential to improve service creation through an IDP doesn’t end there. Next let’s move on to testing and the benefits of IDPs during that phase.

Testing

The testing phase and its place in the SDLC timeline vary based on your software development methodology and your testing strategy. At a minimum, however, automated tests should be an integral part of your approach.

With an IDP, you can also integrate and visualize the maturity of a product or service by setting test coverage goals and automating notifications when those conditions aren’t met.

Deployment

Deployment management was already covered in the development portion above. Your IDP has ensured that teams and products use a consistent deployment pattern. But what else can an IDP provide in the case of deployments?

Ideally, your IDP will also provide visibility into:

  • Recent deployments - knowing when software was deployed helps ensure that the underlying services are kept up-to-date. 
  • Deployment tracking - software deployments that coincide with an outage or incident can provide insight into the root cause.
  • Changes in service metrics and reliability - as you deploy new versions of the software, you want to ensure that your software reliability and quality remain high. Deviations from your expected values may indicate a problem.

Operation and service maturity

Service maturity provides consumers confidence in the quality and operational readiness of your services.  And for the service owners, it ensures that they have visibility into potential quality or standardization gaps of their service.

Why should you incorporate service maturity into your IDP?

  • It provides a central place to not only identify services and APIs, but also where you can understand production behavior and production readiness through integrations with monitoring and quality checks.
  • It can highlight SLOs and track performance of those SLOs.
  • It allows for easier incident management across services.
  • With standardized checks, you can track required changes for security, quality, and other updates across the organization.

Whether your development teams monitor their own services or you have a dedicated operations team, monitoring your service or responding to incidents requires central access to the information most relevant to operations. For example, your IDP can provide a central place to monitor availability and other metrics. The IDP can also include operational information like playbooks, incident logs, and postmortems.

Eventually, successful services need to scale to provide the right level of support for their clients. With an IDP, you can easily contain all the relevant metrics and quality checks that ensure the service moves in the right direction.

Deprecation and retirement

Finally, software services retire over time. Sometimes they’re replaced or rewritten, other times they become unnecessary. To help your organization with this natural process, your IDP can include relevant documentation on deprecating the service. Your client teams can easily find information on deprecation timelines, as well as where to go next. And once again, having one place to go for this information can make things easier for your teams across the org.

Getting started now will make it easier to adopt more platform features later.

Spanning the software lifecycle

Establishing the best developer portal for your organization provides benefits across the software lifecycle, from discovery through deprecation. That means freeing up your developers to onboard faster, self-serve for information, and build and maintain high quality software.

The IDP provides a holistic solution that covers a lot of needs, including integrating your service catalog with your CI/CD, metrics and monitoring, quality checks, and documentation. So when’s the right time to begin investing time into an IDP? Getting started now will make it easier to adopt more platform features later.

Are you ready to explore a solution that will not only meet your needs today, but grow with your needs tomorrow? To begin building the vision for your organization’s IDP, get a demo of OpsLevel.

‍

This post was written by Sylvia Fronczak. Sylvia is a software developer that has worked in various industries with various software methodologies. She’s currently focused on design practices that the whole team can own, understand, and evolve over time.

‍

More resources

Blog
September 19, 2023
by
Fernando Villalba
The OpsLevel Developer Experience (DevEx) series. Part 1: What is DevEx?

Great developer experience (DevEx) is what you get when developers can easily achieve and maintain flow state at work. This article begins a series where we tackle all of the areas that affect flow state and impair your developer experience at your company and provide example metrics and suggestion to help you operate like a potential future unicorn.

Blog
August 31, 2023
by
OpsLevel
August 2023 release notes

This month included an update to our Service Maturity features—to give you even more flexibility—plus more sorting and syncing improvements. Read on to learn more!

Blog
May 31, 2023
by
Haley Hnatiw
May 2023 release notes

See what we’ve shipped in the month of May.

OpsLevel Logo
Subscribe
Join our newsletter to stay up to date on features and releases.
By subscribing you agree to with our Privacy Policy and provide consent to receive updates from our company.
SOC 2AICPA SOC
Product
Software CatalogMaturityIntegrationsSelf-serviceRequest a demo
Company
About usCareersContact UsCustomersPartnersSecurity
Resources
Docs
Blog
Demo
© 1999 J/K Labs Inc. All rights reserved.
Cookie Preferences
Terms of Use
Privacy Policy
Responsible Disclosure
By using this website, you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. View our Data Processing Agreement for more information.
Okay!