Services
Services are a named group of resources, environments, repository, and people. It can be dependent (upstream or downstream) on other services. As an example, there may be a “Credit card processing” service that is dependent on a “logging service”.
Create a Service
To add a new service, click on the + Add Service button in the upper right corner of the Services Summary view.
There are four "types" of services you can create:
Standard Service: This is a service that is connected to a repo that you "own".
Monorepo Service: This is a service that is in a subdirectory of repo that you "own".
External Service: This is a service where you are not owners of the code repo (maybe it's another group within your company or a 3rd party service)
General Item: This is a generic item that you can use for anything that provides a service into your infrastructure. We kept it wide open to fit the many needs of our customers. You could make it a person or outside consulting group (just some of the ideas our customers have had).
Standard Service
Select Standard Service on the top and then complete the necessary information below. You will be required to select a Repository that you have already set up the credentials for. (See Credentials section for more information on how to do that.) Click on Create once complete.
Monorepo Service
Select Monorepo Service on the top and then complete the necessary information below. Select a repo that has already been configured and then you will see a drop down field that allows you to select the subdirectory of that repo that has package information. You can select one of these subdirectories or type in the path if it is not listed. Fill out the rest of the information and click on Create once complete.
If your source control provider is Github, in order for sub-directories to show up automatically, you will need to enable Dependencies for your repository. You can do this in your Github account, by navigating to your project > Insights > Dependency graph > Allow access
External Service
Select External Service on the top and then complete the necessary information below. (NB You will not be asked to provide a repo of the source code and you will not be able to see any package information on the service detail page as you would for a repository you owned). Click on Create once complete.
General Item
Select General Item on the top and then complete the necessary information below. Click on Create once complete.
Working with Services
To view a list of all your services, select Catalog on the top line menu then Services.
In this table you can see a summary of all relevant information about your service:
Name
Owners
Applications
Environments
Accrued Costs
Prior Period Costs
% Change (in costs)
Open PRs
Scorecards
Lifecycle
On-call
Incidents P1
Incidents P2
Incidents P3
Incidents P4
Incidents P5
You can use the Filters button to filters values among all service table columns:
Viewing a Service
If you click on the name of the service, you will open the service detail page. This page's view will depend on the plug-ins you have installed for that particular service. To see how to install a plug-in, check out our Plug-in section. You can also see a visual representation of your service.
The CI/CD tab shows you your CI and CD pipelines for this service, if you have configured the plugin in the service page:
The Environments tab for each service, shows you the different environments for that service. To learn more about how environments work, check out our Environments section.
Adding a Dependency
The Dependencies tab, shows you all the upstream and downstream services connected to this service.
To add a Dependency, click on + Add Dependencies in the upper right corner. Then select whether it is upstream or downstream and then select the service to add.
Enabling Packages
To see the Packages pulled from the repository, click on the Packages tab.
If your source control provider is Github, in order for install dependencies to show up automatically, you will need to enable Dependencies for your repository. You can do this in your Github account, by navigating to your project > Insights > Dependency graph > Allow access
Deploys
When you add a repository provider credential and configure a service with a repository, configure8 will discover information related to this repository deploys from the provider and display under the Deploys tab:
On this page will can see the following information about your deploys:
Name
Status
Description
Status
Actor
Time
Duration
Branch
Filtering is also available for some of the columns.
Deploys are available for the following repository providers:
Azure DevOps
Bitbucket
GitHub
Gitlab
Deployment data is retrieve from the repository provider by configure8 discovery jobs. If you want to have more frequently updated information about deployments data please enable "Auto Discovery" for provider with a shorter period. Manual discovery can also be used to sync immediately.
configure8 discovery job first run will retrieve information about your deployments from no more than 3 days ago.
You can push custom Deployment information via our Deployments API. See the API docs and the API sample.
Editing a Service
To delete a Service, you can select Delete on the Service table Actions (...) or under the Actions menu on the Service Detail page.
Use the right lateral menu to edit general service information:
Owners
Visibility Control (see RBAC)
Viewers
Tags
Applications
Description
Repository
Metadata
Text
Link
JSON
Nickname
Links
API
Dashboard
Diagram
Documentation
Health Check
Logs
Metrics
Other
Runbook
Last updated
