Provisioning Release Templates in Backstage Using YAML

This guide explains how to provision Release Templates using YAML configuration files and the XL CLI actions in Backstage. You can provide Inline YAML or use files stored in a GitHub repository.

Prerequisites

• Install Custom actions. For more information, see Scaffolder Backend Module Digital.ai for more details.
• Install RoadieHQ to use the fs:write action.
• The app-config.yaml file is configured with environment-specific hostnames, target and tokens.
• XL CLI is installed and accessible in the Backstage action context.
• A GitHub repository is available if using repository-based YAML files.

Set Up Templates in Backstage

You can set up and preview templates in Backstage using either local files or GitHub integration. Choose the option that works best for your environment.

Option 1: Use Local Files

1. Copy the xl-cli-yaml-inline folder to the examples folder in your Backstage root directory.
2. Add the following to your app-config.yaml file:

  - type: file
    target: ../../examples/xl-cli-yaml-inline/template.yaml
    rules:
      - allow: [ Template ]
  - type: file
    target: ../../examples/xl-cli-github/template.yaml
    rules:
      - allow: [ Template ]

3. Restart the Backstage.

   Once set up, you can preview the templates in the Backstage catalog.

   . .

Option 2: Use GitHub Integration

1. Set up the GitHub integration support. For more information, see Github integration

  integrations:
    github:
      - host: github.com
        This is a Personal Access Token or PAT from GitHub. You can find out how to generate this token, and more information
        about setting up the GitHub integration from the Github Integration guide above
        token: <token>

2. Restart the Backstage.

3. In your localhost, open catalog-import and import both templates using their GitHub URLs:

   Inline YAML Template

   GitHub YAML Template

   note

   These are example templates. Use them for reference only.

   After import, the templates will appear in your Backstage catalog. You can then preview them.

   Once set up, you can preview the templates in the Backstage catalog.

   . .

Action Parameters

The action reads configuration from app-config.yaml and runs XL CLI commands to apply the YAML.

Parameter	Description
product	Operation type: xl-deploy or xl-release.
releaseInstance	Name of the Release instance (required only when product is xl-release).
yamlFilePath	Path to the YAML file. This can be inline content or a GitHub file path.

Provision Release Template Using Inline YAML

1. In the Backstage sidebar, click on Create and select Provisioning Digital.ai Release by applying Inline YAML using the XL CLI tile.

2. Select xl-release as the product.

3. Paste the YAML content inline.

4. Select the Release instance.

5. Specify the file path where the YAML file should be stored.

6. Click Review to confirm your inputs.

   

7. Click Create to start template creation.

This will create resources as defined in your YAML configuration.
For example, you can create templates in xl-release based on the provided YAML.

This will create resources, in this case Release templates, as defined in your YAML configuration.

Provision Release Template Using YAML from GitHub

1. In the Backstage sidebar, click on Create and select the Provisioning Digital.ai Release by applying YAML from GitHub using the XL CLI tile.

2. Select xl-release as the product.

3. Provide the GitHub URL in the provided field.

4. Select the Release instance.

5. Specify the file path where the YAML file should be stored.

6. Click Review to confirm your inputs.

   

7. Click Create to start template creation.

This will create resources, in this case Release templates, as defined in your YAML configuration.