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”.
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).
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.
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
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.
Select General Item on the top and then complete the necessary information below. Click on Create once complete.
To view a list of all your services, select Catalog on the top line menu then Services.
You can expand any service to see a quick view of the service details by clicking on the carrot left of the service name.
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 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.
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.
To see the Install Dependencies pulled from the repository, click on the Install Dependencies 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
To edit or delete a Service, you can select Edit under the Actions menu on the Service Detail page.
Then fill in or edit any information you would like to change.
For each service, you can also create your own Metadata mappings. Select the Type from the drop down menu, the name of the Metadata you want to associate with this service and its value. Types of Metadata include:
Select Done when finished making your edits.
Copyright © 2022 configure8, Inc. All rights reserved.