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:

• Log in to HCL DevOps Velocity.
• Click Settings>Integrations.
• 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.

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

• 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:

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

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

• Click Confirm to upload the file.

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

• To edit the existing YAML configuration file, perform the following steps:
  • Click overflow menu of the YAML configuration file and then click Edit.
  
  • The existing YAML configuration file will download.
  • Edit the downloaded YAML configuration file.
  • Click overflow menu of the YAML configuration file which you have edited and then click Update.
    Update config dialog opens.
  • Click Choose file to select the edited file.
  
  • Click Confirm to upload the file.
  
  • 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:

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

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

YAML configuration file 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, refer to the Configuration properties section for the plug-ins in HCL DevOps Velocity Plug-ins.

Sample YAML configuration file

Following is the sample YAML configuration file with two integrations:

version: "8.0.0"
integrations:
  - type: ucv-ext-launch
    attributes:
      auto-config: true
    configs:
      name: Launch Integration
      loggingLevel: DEBUG
      deltaTime: '2023-05-15T18:30:00.000Z'
      # Additional integration-specific fields for Launch Integration

  - type: another-integration
    attributes:
      auto-config: true
    configs:
      name: Another Integration
      loggingLevel: INFO
      # Additional integration-specific fields for Another Integration
    

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.
5. Under configs property, you must add the required properties based on the integration type.
6. Set the auto-config attribute to true for enabling automatic setup of pipeline applications processes and environments after creating a new integration.
7. Save the YAML configuration file.