Skip to main content

Publishing to the Self-Service Catalog

Publishing to the Self-Service catalog is a fundamental part of providing self-service access to infrastructure and applications. Enabling Self-Service on an IaC asset or a blueprint makes it visible as a catalog card that other users in the space can launch on their own.

You can enable Self-Service (and its counterpart, Building Block — which instead makes an asset reusable inside the visual blueprint designer, see Blueprint Design) from any of these places:

  1. The Automation Inventory page, under either the IaC Assets or Blueprints tab — each row has its own Self-Service and Building Block toggle columns, so you can flip them in bulk without opening each item.
  2. Inside a blueprint's own details, under its Overview tab — use the Self Service button (it reads Hide from Catalog while the blueprint is published) and the Building Block button (Add to Building Block Library).
  3. Inside an IaC asset's own details page, from the Self-Service toggle in the top bar.

We recommend the following process when publishing an asset or blueprint to the Self-Service catalog:

  1. Head to the Automation Inventory page under Automation and open the item (IaC asset or blueprint) you would like to publish.
  2. Its Catalog Design screen (or, for a full blueprint, the Overview tab) lets you specify:

    1. Display Name: This name can be different than the asset's or blueprint's file name from git.

    2. Icon (labeled Category Icon on an asset's Catalog Design screen): Choose from a list of default icons or upload your own. Notice the icon needs to be in SVG format.

    3. Self Service: Show or hide this blueprint in the Self-Service catalog.

    4. Building Block: Add/remove this blueprint from the Building Block Library.

    5. Labels: These are an important part of additional data designers can add in order to assist consumers when selecting an item from the catalog. In order to create a new label click on Manage Space Labels.

      img

    6. In the dialog click on Create New, specify the label name and color then click save. Now in the Blueprint Labels area the new label will be available.

      img

    7. Instructions (full blueprints only): When adding instructions to the Blueprint (see link) this is where you can see the end user view of the instructions.

      img

    8. Policies (full blueprints only): Set the Blueprint consumption policies according to the description here.

info

Note: The entire process and publishing data is in the scope of the space.