Skip to main content

Check out Port for yourselfย 

Set up your service catalog

Now that your tools are connected to your portal, you can start creating your service catalog and add some users and teams to your organization.

This page will explain some basic concepts and describe the process of onboarding assets to your portal.

Service catalogโ€‹

Every Port account comes with a set of default blueprints.
Three of these blueprints are designed to help you create a rich and dynamic service catalog:

  1. _service
  2. _workload
  3. _environment

To help you onboard services, workloads and environments, the Set up service catalog page in your portal contains several actions for you to execute.

These actions will create entities, with rich context from the tools you've integrated.

For example:
Say you've integrated GitHub, Jira, and Pagerduty.
When onboarding a service via the action, you will be able to select the relevant GitHub repository, Jira project, and Pagerduty service related to that service.

This will create a single service entity, with relations to the relevant entities you selected, serving as a single component to track & manage the service.

Users & teamsโ€‹

Two other default blueprints are designed to help you manage users, teams, and ownership in your portal:

  1. _user
  2. _team

To help you onboard users and teams, the Set up users & teams page in your portal contains several actions for you to execute.

These actions will create entities, with rich context from the tools you've integrated.

Onboard your userโ€‹

First, execute the Onboard your user action.
This will create a user entity with context of your user accounts in other tools you've integrated.

Now that you've onboarded your user, some components in your portal will be populated with data.

For example, the table named Track your open pull requests in the Plan my day page is configured to display pull request entities that were opened by the logged in user (in this case, you).
This table should now be populated with PRs from your Git provider.

Onboard teamsโ€‹

Use the Onboard new team action to create a new team entity and add your user to it.
Now that your user is a member of a team, widgets in the My team page will be populated with data.

Onboard more usersโ€‹

To see what components in your portal look like with more than one user, use the Onboard user action to add users to your Port organization.

If you want to create users without inviting them to the portal just yet, make sure the Invite to Port toggle is disabled when executing the action.

User & team management

The user and team blueprints are powerful components that can be leveraged for many use cases, such as ownership definition, RBAC definition, dynamic visualization, and more.

Read more about them in the User & team management page.

Next step - automatic discoveryโ€‹

Proceed to the next step to learn how to manage your catalog automatically, creating and updating components based on changes in data from your tools.