Steps

Importing YAML configuration file into HCL DevOps Velocity

Import the YAML configuration file into HCL DevOps Velocity by using any one of the following methods:

Method 1: Using GitHub plug-in

Integrate HCL DevOps Velocity with a GitHub repository that contains the ucv.yml file to import the YAML configuration file into HCL DevOps Velocity.

Perform the following steps to import the YAML configuration file using GitHub plug-in:

1. Log in to HCL DevOps Velocity.
2. Click Settings>Integrations.
3. In the Installed tab, click Add Integration for the installed GitHub plug-in.
   Note: If the GitHub plug-in is not installed, go to Available tab and click Install for GitHub plug-in.

4. Enter the details in the required fields to add GitHub integration.

5. Click Add to save the details and enable the integration.
   The YAML configuration file from the GitHub repository is automatically synced to HCL DevOps Velocity and displayed under Settings>External config pipeline.

Method 2: Using user interface

You can import the YAML configuration file into HCL DevOps Velocity using user interface if it is not hosted in a GitHub repository.

Perform the following steps to add YAML configuration file using user interface:

1. Log in to HCL DevOps Velocity.
2. Click Settings>External Config Pipeline.
3. Click Download sample yaml to download the sample YAML file.
4. Edit the sample file with the actual values of your configuration.
5. Click Add new config file.

6. Add New Config dialog opens.
7. Click Choose file to select the edited file.

8. Click Confirm to upload the file.

9. The uploaded YAML configuration file is displayed in the list.

10. To edit the existing YAML configuration file, perform the following steps:
    1. Click overflow menu of the YAML configuration file and then click Edit.
    
11. The existing YAML configuration file will download.

12. Edit the downloaded YAML configuration file.

13. Click overflow menu of the YAML configuration file which you have edited and then click Update.
    Update config dialog opens.

14. Click Choose file to select the edited file.

15. Click Confirm to upload the file.

16. The updated YAML configuration file is displayed in the list.

Applying YAML configuration file

Once you have the YAML configuration file in HCL DevOps Velocity, perform the following steps to apply the configuration:

1. Log in to HCL DevOps Velocity.
2. Click Settings>External Config Pipeline.
3. Choose the required YAML configuration file in the list and click right angle bracket to preview the configuration details.

4. Click Apply for the required YAML configuration file.
5. Click overflow menu for the required YAML configuration file and then click View Logs to view the logs of the applied YAML configuration file.

Configuration properties

The YAML configuration file is used to define configuration settings for automating the initial setup process for integrating various CI/CD tools into HCL DevOps Velocity.

YAML File Structure

The following table describe the properties used to define the configuration in the YAML file.

Integrations

The following table describe the properties that you must define under integrations:

Configuration Object

The following table describe the properties that you must define under configs :

The following table describe the properties that you must define under configs :For additional configuration properties depending on integration type, navigate to the respective plug-in and look for the general configuration properties section for more details.

Sample YAML configuration file

Following is the sample YAML configuration file with existing integrations:

version: 0.0.1
integrations:
  - tenant_id: 12345-12345
    name: Valuestream 1
    attributes:
      appEnvOrder:
        - DEV
        - QA
        - PROD
      directSync: true
      auto-config: true
      integrationId: 12345-12345
      team: Dev Team
      applications:
        - TL5
      applicationids:
        - 12345-12345
    type: ucv-ext-launch
    

• To filter a pipeline by application in a value stream, add “applications” and “teams” to map the value stream to a team.
• If `integrationId` is specified, then `configs` is optional. `name` parameter to override value stream name.
• Set the `directSync` attribute to “true” to enable direct synchronization during execution (currently it is supported only for devops deploy plugin).
• If `directSync` is enabled, the `applicationids` property is mandatory to selectively sync the required applications.

Replace the property values in the sample file with the actual values specific to your configuration.

Customizing YAML configuration file

Perform the following steps to customize the YAML configuration file for your required integrations:

1. Open the YAML configuration file in a text editor.
2. Update version property with the appropriate version number.
3. Under integrations property, add or remove any property as required.
4. For each integration, add type, attributes, and configs property. name is optional if you want to overwrite the valuestream name.
5. In valuestream, to filter the pipeline based on the application, add applications and teams to map valuestream against the team.
6. Under configs property, you must add the required properties based on the integration type. If integrationId is specified then configs is optional.
7. To order the environment while syncing, use the appEnvOrder property.
8. Set the auto-config attribute to true for enabling automatic setup of pipeline applications processes and environments after creating a new integration.
9. Save the YAML configuration file.

Compatibility Matrix

The following table lists the compatibility versions of the YAML Executor plug-in and Velocity