LeanIX Value Stream Management pipeline extension task
DescriptionThe LeanIX pipeline task when used in your Azure DevOps pipeline sends information about your connected repository-project to the LeanIX API and triggers a creation or an update of the LeanIX Fact Sheet related to the project and the environment of your build. Specifications relating to the Fact Sheet are set via the manifest.yml file in your repository and via input parameters of the task, which are explained in more detail below. UsagePrerequisitesmanifest.yml filePlace the manifest.yml file containing the correct information about your project in your project repository. You can use any path you want, this is passed to the LeanIX pipeline task as an input parameter. miCiCd-init.gradleIn case you are using gradle as dependency manager on your project, you need to put this file in the root of your repository. It will be provided to you by LeanIX. Secret LeanIX API tokenIn the “Edit”-section of your pipeline in which the LeanIX task is used, a secret must be created, the value of which is a valid LeanIX token for the host that is used in the task. For the use of secrets in Azure DevOps pipelines see also Define variables - Azure Pipelines Adding the task to your Azure DevOps pipelineIf you want to add the LeanIX task to a Azure DevOps pipeline, you can either use the example pipeline code listed below or use the search field for tasks in the edit mode of your Azure DevOps pipeline. For more information on how to use tasks, see also Key concepts for new Azure Pipelines users and the related pages. In the search field search for “LeanIX” and click on the upcoming result task. In the appearing input dialog for the task specify the input parameters according to the description of the parameters below on this page. Of course you can also use environment variables as input parameters here ( Define variables - Azure Pipelines ). Monitoring of pipeline runsThe monitoring of the pipeline including the LeanIx task can be done in the runs overview belonging to the pipeline or for continuous monitoring you can see also Add continuous monitoring to your release pipeline- Azure Monitor . Simple example pipeline with the LeanIX DevOps taskThe input parameters used in the example are explained in more detail in the "Inputs" section. In the example the token to access the LeanIX API (see also section “Secret LeanIX API token) is hidden in the secret variable $(apitoken).
Mandatory and optional definitionsThe steps and assignments carried out in the example are necessary for the use of the LeanIX task. In addition to the input parameters of the task under “inputs:” to be set correctly, you can choose the following values yourself:
Inputsapi-tokenRequired The LeanIX API token for secure access to the LeanIX connector API on the chosen host. Use the variable you specified in the pipeline variables for it here. hostRequired The LeanIX host where the connector is located that you want the task to connect to, e.g.: eu.leanix.net manifest-pathRequired The path to the LeanIX manifest in your repository. Default: /lx-manifest.yml dependency-managerRequired Type of the dependency manager used for the project. Supported possible values: NPM, MAVEN, GRADLE, NUGET. stageThe stage the pipeline is triggered for. Default: production versionRequired The current version the pipeline is triggered for. allow-failureFlag that indicates whether the entire pipeline is allowed to continue if an error occurs in the LeanIX task. "True" means, the pipeline continues upon error in the task, "false" makes it exit with error. Default: true |