The microsoft/azure-pipelines-yaml repository is a collection of Azure Pipelines YAML templates and examples. It serves as a resource for developers to learn and implement CI/CD pipelines using Azure DevOps, providing best practices and reusable components for various scenarios.

Pros

• Comprehensive collection of YAML templates for different use cases
• Regularly updated with new features and improvements
• Follows best practices for Azure Pipelines implementation
• Provides a starting point for developers to customize their own pipelines

Cons

• May require some Azure DevOps knowledge to fully utilize
• Some templates might be overly complex for simple projects
• Documentation could be more extensive for certain templates
• Limited to Azure Pipelines, not applicable to other CI/CD platforms

Code Examples

Here are a few examples of Azure Pipelines YAML templates from the repository:

1. Basic pipeline for a .NET Core application:

trigger:
- main

pool:
  vmImage: 'ubuntu-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@1

- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(solution)'

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation="$(build.artifactStagingDirectory)"'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

- task: VSTest@2
  inputs:
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

2. Multi-stage pipeline for containerized application:

trigger:
- main

variables:
  dockerRegistryServiceConnection: 'myDockerRegistry'
  imageRepository: 'myapp'
  containerRegistry: 'myregistry.azurecr.io'
  dockerfilePath: '$(Build.SourcesDirectory)/Dockerfile'
  tag: '$(Build.BuildId)'

stages:
- stage: Build
  displayName: Build and push stage
  jobs:  
  - job: Build
    displayName: Build job
    pool:
      vmImage: 'ubuntu-latest'
    steps:
    - task: Docker@2
      displayName: Build and push an image to container registry
      inputs:
        command: buildAndPush
        repository: $(imageRepository)
        dockerfile: $(dockerfilePath)
        containerRegistry: $(dockerRegistryServiceConnection)
        tags: |
          $(tag)

- stage: Deploy
  displayName: Deploy stage
  dependsOn: Build
  jobs:
  - deployment: Deploy
    displayName: Deploy job
    pool:
      vmImage: 'ubuntu-latest'
    environment: 'production'
    strategy:
      runOnce:
        deploy:
          steps:
          - task: KubernetesManifest@0
            displayName: Deploy to Kubernetes cluster
            inputs:
              action: deploy
              manifests: |
                $(Pipeline.Workspace)/manifests/deployment.yml
                $(Pipeline.Workspace)/manifests/service.yml
              imagePullSecrets: |
                $(imagePullSecret)
              containers: |
                $(containerRegistry)/$(imageRepository):$(tag)

Getting Started

To use these YAML templates:

1. Fork or clone the microsoft/azure-pipelines-yaml repository.
2. Choose a template that fits your project needs.
3. Copy the YAML content to your Azure DevOps project.
4. Customize the template according to your project requirements.
5. Commit the YAML file to your repository (typically named azure-pipelines.yml).
6. Set up a new pipeline in Azure DevOps, pointing to your YAML file.
7. Run the pipeline and monitor the results.