azure-devops_pipelines-flows.md

⬅️  Microsoft Azure DevOps

⬅️  Build and Release Flow

⬅️  README

Microsoft Azure DevOps Pipelines flows

all the pipelines definitions and its templates they're defined inside of the directory .azure-pipelines

Abastract flow

view to a single application from inside of the mono repository

Build and deploy to development server

Build and deploy to production server

Build Flows

CI (Continuous Integration) flows

Pull Request

Triggered when there is any new pull request that targets the develop branch

The main goal of this pipeline is to validate the code from the pull request

📝  .azure-pipelines/ci/pull-requests.yml

Branches

Triggered when there is any git push to the master or develop branch

This pipeline will run the validation, build and branch build publish of the applications that needs to be executed

📝  .azure-pipelines/ci/branches.yml

⚠️  to run this pipeline you must have created a GitHub PAT and upload it to the Azure DevOps Pipelines Library as a Secure file. Instructions: Create and use a GitHub PAT

Manually triggered flows

Like the name suggests, this following flow will be triggered manually by the developer on the Azure DevOps

Build storybook

📝  .azure-pipelines/manually/build-storybook.yml

⚠️  to run this pipeline you must have created a GitHub PAT and upload it to the Azure DevOps Pipelines Library as a Secure file. Instructions: Create and use a GitHub PAT

Build all applications

📝  .azure-pipelines/manually/build-all.yml

⚠️  to run this pipeline you must have created a GitHub PAT and upload it to the Azure DevOps Pipelines Library as a Secure file. Instructions: Create and use a GitHub PAT

Build one application

It should be created one by application and use the template .azure-pipelines/manually/templates/build-one.yml

⚠️  to run this pipeline you must have created a GitHub PAT and upload it to the Azure DevOps Pipelines Library as a Secure file. Instructions: Create and use a GitHub PAT

Release Flows

CD - Continuous Deployment

Storybook

.azure-pipelines/cd/storybook.yml it uses the template .azure-pipelines/cd/templates/deploy-one.yml

⚠️  you need to create a service connection under the MS Azure DevOps project settings to connect with the MS Azure Cloud (use the Azure Resouce Manager connection to connect to your MS Azure Cloud subscription. IMPORTANT: use the same name)

⚠️  to run this pipeline you must have created a variable group on the pipelines library (remember to allow the access to all the pipelines):

• cd-vars_storybook which should contains
  • STATUS - it must have the value active to update the Azure Cloud Storage and Azure Could CDN
  • to update the storage
    • azureStorageName
  • to update the cdn
    • azureResourceGroupName - name of the service connection added to the Service connections under the MS Azure DevOps project settings (IMPORTANT: remember to use the same name from the MS Azure Cloud subscription)
    • azureCdnEndpointName
    • azureCdnProfileName

Application

It should be created one by application, environment (prod - production, uat - pre-release/staging or dev - development) and use the template .azure-pipelines/cd/templates/deploy-one.yml

⚠️  you need to create a service connection under the MS Azure DevOps project settings to connect with the MS Azure Cloud (use the Azure Resouce Manager connection to connect to your MS Azure Cloud subscription. IMPORTANT: use the same name)

⚠️  to run this pipeline you must have created two variable groups on the pipelines library (remember to allow the access to all the pipelines):

• cd-vars_$ENV_$appName which should contains
  • STATUS - it must have the value active to update the Azure Cloud Storage and Azure Could CDN
  • to update the storage
    • azureStorageName
  • to update the cdn
    • azureResourceGroupName - name of the service connection added to the Service connections under the MS Azure DevOps project settings (IMPORTANT: remember to use the same name from the MS Azure Cloud subscription)
    • azureCdnEndpointName
    • azureCdnProfileName

Further help

Azure Pipelines

• Learn to Use Variable Groups in Azure DevOps Pipelines | @slalom

• YAML Release Pipelines in Azure DevOps | Microsoft Azure

• Azure Pipelines documentation | Azure DevOps | Microsoft Docs

  • YAML schema reference

  • Template types & usage

  • Use predefined variables

  • Define variables

  • Add & use variable groups

  • Expressions

  • Specify conditions

  • Add stages, dependencies, & conditions

  • Specify events that trigger pipeline builds and releases

  • Deploy Apps to Azure - Connect to Microsoft Azure

• Azure Command-Line Interface (CLI) documentation | Microsoft Docs

  • az storage blob upload-batch

  • az cdn endpoint purge

• Using Templates in YAML Pipelines in Azure DevOps

• Azure DevOps YAML Pipelines | Dave Mateer's Blog

• Azure Pipelines | VS Code extension