azdo-classic-to-yaml

Azdo Classic Release Pipeline to Yaml

This JavaScript package library extracts varibale groups, task groups and classic release pipleine as Yaml files.

Installation

1. Run below commands to create package.json file and install azdo-classic-to-yaml.

npm init && npm i azdo-classic-to-yaml

2. Add "generate": "node ./node_modules/azdo-classic-to-yaml/generate.js" in package.json file

{
  "name": "demo",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "generate": "node ./node_modules/azdo-classic-to-yaml/generate.js"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "azdo-classic-to-yaml": "^1.0.1"
  }
}

3. Create .env file and update with your ORGANIZATION, PROJECT and PAT. (https://dev.azure.com/ORGANIZATION/PROJECT)

• How to create PAT

ORGANIZATION=
PROJECT=
PAT=

4. Run below command. This will generate yaml file in pipelines folder.

npm run generate

Environment Variables

Name	Description	Required	Default
AZURE_VSRM_URL	Azure VSRM URL	Optional	https://vsrm.dev.azure.com
AZDO_ENV_URL	Azdo environment url	Optional	https://dev.azure.com
ORGANIZATION	Organization Name	Yes	N/A
PROJECT	Project Name	Yes	N/A
PAT	Public Access Token	Yes	N/A

Generated YAML files

• Variable Groups - ./pipelines/varibalegroups/*.yaml
• Task Groups - ./pipelines/taskgroups/*.yaml
• Release Pipeline - ./pipelines/*.yaml

Known Issues:

• This supports only for classic release pipelines and gives you simple template structure.
• Pre and Post approval flows are not covered and recommended to use deployment strategies with approval.
• connectedServiceNameARM: $(az_service_connection) needs to be replaced with azureSubscription: $(az_service_connection) in some places.
• Task groups needs to be updated with parameters - $(az_service_connection) to ${{ parameters.az_service_connection }}
• Needs cleanup and fixes.

Samples:

name: "Release Pipeline 1"
trigger: none
paremeters: []
variables: []
resources:
  pipelines: []
  repositories: []
stages:
  - stage: Development
    variables: []
    jobs:
      - job: Bundle - DEV
      - job: AKS Deployment - DEV
      - job: DB Migration - DEV
  - stage: Integration
    variables: []
    jobs:
      - job: AKS Deployment  - INT
      - job: DB Migration - INT 
      - job: Post Deploy Testing - INT