Dela via

Azure DevOps CLI i Azure Pipeline YAML

Azure DevOps-tjänster

Om du vill använda Azure DevOps CLI med en YAML-pipeline kan du använda Azure DevOps-tillägget eller använda AzureCLI-uppgiften. Microsoft-värdbaserade Windows- och Linux-agenter är förkonfigurerade med Azure CLI och Azure DevOps CLI-tillägget. Azure DevOps CLI-tillägget kör az devops kommandon.

Du kan autentisera med antingen en PAT eller använda den AzureCLI@2 uppgiften med en tjänstanslutning. Att använda en tjänstanslutning är det säkrare alternativet eftersom du inte behöver hantera autentiseringsuppgifter manuellt.

Autentisera med Azure DevOps

Vissa Azure DevOps CLI-kommandon, till exempel az devops configure och az devops --help, kräver ingen autentisering. De ansluter inte till Azure DevOps. De flesta kommandon interagerar med Azure DevOps och kräver autentisering.

Du kan autentisera med hjälp av System.AccessToken-säkerhetstoken som används av den körande pipelinen genom att tilldela den till en miljövariabel som heter AZURE_DEVOPS_EXT_PAT, enligt följande exempel.

Att använda System.AccessToken kräver att man har en PAT. Som ett säkrare alternativ kan du använda AzureCLI@2 task för att populera en tjänstanslutning.

- bash: |
    az pipelines build list --organization '$(System.TeamFoundationCollectionUri)' --project '$(System.TeamProject)'
  displayName: 'Show build list'
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)

Om du har flera steg som kräver autentisering lägger du till AZURE_DEVOPS_EXT_PAT miljövariabeln i varje steg.

För mer information om omfattningen av säkerhetstoken som används av den körande pipelinen, se på Åtkomst till arkiv, artefakter och andra resurser.

Mer information om autentisering med hjälp av en personlig åtkomsttoken (PAT) finns i Logga in med en personlig åtkomsttoken.

Logga in på Azure DevOps CLI med Windows- och Linux-värdbaserade agenter

Microsoft-värdbaserade Windows- och Linux-agenter är förkonfigurerade med Azure CLI och Azure DevOps CLI-tillägget.

I följande exempel visas hur du loggar in på Azure DevOps och kör några kommandon. I det här exemplet används avbildningen ubuntu-latest Microsoft-värddriven agent. Du kan ersätta den med någon av de andra Windows- eller Linux-värdbaserade avbildningarna.

Det här exemplet autentiserar med Azure DevOps CLI. Den använder säkerhetstoken System.AccessToken som används av pipelinen som körs.

trigger:
- main

pool:
  vmImage: 'ubuntu-latest'

steps:
- bash: az --version
  displayName: 'Show Azure CLI version'

- bash: az devops configure --defaults organization='$(System.TeamFoundationCollectionUri)' project='$(System.TeamProject)' --use-git-aliases true
  displayName: 'Set default Azure DevOps organization and project'

- bash: |
    az pipelines build list
    git pr list
  displayName: 'Show build list and PRs'
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)

Installera Azure DevOps CLI-tillägget med macOS-värdagenter

MacOS Microsoft-värdbaserade agenter har Azure CLI installerat men inte Azure DevOps CLI-tillägget. Om du vill installera Azure DevOps CLI-tillägget kör du följande kommando i pipelinen innan du gör några Azure DevOps CLI-anrop.

# Install Azure DevOps extension
- bash: az extension add -n azure-devops
  displayName: 'Install Azure DevOps extension'

Uppgradera azure CLI-version för värdbaserad agent

Microsoft-värdbaserade agenter distribuerar vanligtvis veckouppdateringar till programvaran i de virtuella miljöerna. För vissa verktyg används den senaste versionen vid tidpunkten för distributionen. I andra fall låses verktyget till specifika versioner.

  • Om du vill kontrollera den medföljande programvaran och deras versioner för Microsoft-värdbaserade agenter, inklusive den installerade versionen av Azure CLI och Azure DevOps CLI-tillägget, följer du länkarna Inkluderad programvara i tabellen Programvara .
  • Information om hur du kontrollerar den aktuella versionen för Azure CLI finns i Installera Azure CLI.

Du kan uppgradera Azure CLI på dina värdbaserade avbildningar genom att köra följande kommandon i pipelinen.

# Specify python version
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x'
    architecture: 'x64'

# Update to latest Azure CLI version
- bash: pip install --pre azure-cli
  displayName: 'Upgrade Azure CLI'

Installera Azure DevOps CLI-tillägget villkorligt

Om din pipeline körs på flera Microsoft-värdbaserade avbildningar av virtuella datorer, varav vissa inte har Azure DevOps CLI-tillägget installerat, kan du installera villkorligt.

trigger:
- main

# Run on multiple Microsoft-hosted agent images
strategy:
  matrix:
    linux24:
      imageName: "ubuntu-24.04"
    linux22:
      imageName: "ubuntu-22.04"
    mac15:
      imageName: "macos-15"
    mac14:
      imageName: "macos-14"
    mac13:
      imageName: "macos-13"
    windows2025:
      imageName: "windows-2025"
    windows2022:
      imageName: "windows-2022"
  maxParallel: 3

pool:
  vmImage: $(imageName)

steps:
- bash: az --version
  displayName: 'Show Azure CLI version'

# Install Azure DevOps CLI extension only on macOS images
- bash: az extension add -n azure-devops
  condition: contains(variables.imageName, 'mac')
  displayName: 'Install Azure DevOps extension'

# Azure DevOps CLI extension call that does not require login or credentials
# since it configures the local environment
- bash: az devops configure --defaults organization='$(System.TeamFoundationCollectionUri)' project='$(System.TeamProject)' --use-git-aliases true
  displayName: 'Set default Azure DevOps organization and project'

# Call that does require credentials, use the System.AccessToken PAT
# and assign to AZURE_DEVOPS_EXT_PAT which is known to Azure DevOps CLI extension
- bash: |
    az pipelines build list
    git pr list
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)
  displayName: 'Show build list and PRs'

Azure DevOps CLI med lokalt installerade agenter

Du kan använda följande metoder för att installera eller uppgradera Azure DevOps CLI i din lokala agent.

Installera Azure CLI och Azure DevOps CLI-tillägget manuellt

Det går snabbare att installera Azure CLI- och Azure DevOps CLI-tillägget på din lokala agent när du etablerar den virtuella datoravbildningen för agenten än att installera dem varje gång pipelinen körs.

Information om hur du installerar Azure CLI på din egen värdbaserade agentbild finns i Installera Azure CLI. Det finns separata instruktioner för Windows, Linux och macOS.

När du har installerat Azure CLI installerar du Azure DevOps CLI-tillägget.

Installera Azure CLI- och Azure DevOps CLI-tillägget i din pipeline

Följande exempel på hur du konfigurerar Azure CLI och Azure DevOps CLI-tillägget på en lokalt installerad agent med hjälp av en pipeline har följande förutsättningar.

# Specify python version if you have side-by-side versions
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x'
    architecture: 'x64'

# Update pip to latest
- bash: python -m pip install --upgrade pip
  displayName: 'Upgrade pip'

# Update to latest Azure CLI version, min version required for Azure DevOps is 2.10.1
- bash: pip install --pre azure-cli
  displayName: 'Upgrade Azure CLI'

Installera Azure CLI DevOps-tillägget:

  • Azure CLI version 2.10.1 eller senare är installerat.
  • Det finns en version av bash installerad i agentmiljön och i sökvägsmiljön. En bash-installation krävs för att använda bash-uppgiften.
# Install Azure DevOps extension
- bash: az extension add -n azure-devops
  displayName: 'Install Azure DevOps extension'

# Now you can make calls into Azure DevOps CLI
# ...

I följande exempel installeras Azure CLI följt av Azure DevOps CLI-tillägget.

steps:
# Specify python version if you have side-by-side versions
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x'
    architecture: 'x64'

# Update pip to latest
- bash: python -m pip install --upgrade pip
  displayName: 'Upgrade pip'

# Update to latest Azure CLI version, min version required for Azure DevOps is 2.10.1
- bash: pip install --pre azure-cli
  displayName: 'Upgrade Azure CLI'

# Install Azure DevOps extension
- bash: az extension add -n azure-devops
  displayName: 'Install Azure DevOps extension'

# Now you can make calls into Azure DevOps CLI
# ...

Tilldela resultatet av ett Azure DevOps CLI-anrop till en variabel

Om du vill lagra resultatet av ett Azure DevOps CLI-anrop till en pipelinevariabel använder du syntaxen task.setvariable som beskrivs i Ange variabler i skript. I följande exempel hämtas ID:t för en variabelgrupp med namnet Fabrikam-2023 och det här värdet används i ett efterföljande steg.

variables:
- name: variableGroupId

trigger: none

pool:
  vmImage: "ubuntu-latest"

steps:
- bash: az devops configure --defaults organization='$(System.TeamFoundationCollectionUri)' project='$(System.TeamProject)' --use-git-aliases true
  displayName: 'Set default Azure DevOps organization and project'

- bash: echo "##vso[task.setvariable variable=variableGroupId]$(az pipelines variable-group list --group-name Fabrikam-2023 --query [].id -o tsv)"
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)
  displayName: 'Get Fabrikam-2023 variable group id'

- bash: az pipelines variable-group variable list --group-id '$(variableGroupId)'
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)
  displayName: 'List variables in Fabrikam-2023 variable group'

Autentisera med en tjänstanslutning

När du använder en tjänstanslutning tillhandahåller tjänstanslutningen nödvändiga autentiseringsuppgifter för Azure CLI- och Azure DevOps CLI-kommandon i den AzureCLI@2 uppgiften utan att kräva manuell hantering av autentiseringsuppgifter i pipelinen.

Note

När du använder en tjänstanslutning för autentisering med AzureCLI@2måste du manuellt lägga till tjänstens huvudnamn i din Azure DevOps-organisation.

Det här kodexemplet definierar en ny parameter, serviceConnection, med namnet på en befintlig tjänstanslutning. Den parametern refereras till i AzureCLI@2 aktiviteten. Uppgiften listar alla projekt (az devops project list) och pooler (az pipelines pool list).

trigger:
  - main

parameters:
- name: serviceConnection
  displayName: Azure Service Connection Name
  type: string
  default: my-service-connection

steps:
  - task: AzureCLI@2
    condition: succeededOrFailed()
    displayName: 'Azure CLI -> DevOps CLI'
    inputs:
      azureSubscription: '${{ parameters.serviceConnection }}'
      scriptType: pscore
      scriptLocation: inlineScript
      inlineScript: |
        Write-Host "Using logged-in Azure CLI session..."
        Write-Host "$($PSStyle.Formatting.FormatAccent)az devops configure$($PSStyle.Reset)"
        az devops configure --defaults organization=$(System.CollectionUri) project=$(System.TeamProject)
        az devops configure -l

        Write-Host "`nUse Azure DevOps CLI (az devops) to list projects in the organization '$(System.CollectionUri)'..."
        Write-Host "$($PSStyle.Formatting.FormatAccent)az devops project list$($PSStyle.Reset)"
        az devops project list --query "value[].{Name:name, Id:id}" `
                               -o table

        Write-Host "`nUse Azure DevOps CLI (az pipelines) to list pools in the organization '$(System.CollectionUri)'..."
        Write-Host "$($PSStyle.Formatting.FormatAccent)az pipelines pool list$($PSStyle.Reset)"
        az pipelines pool list --query "[].{Id:id, Name:name}" `
                               -o table
      failOnStandardError: true

Tilldela resultatet av ett Azure DevOps CLI-anrop till en variabel

Om du vill lagra resultatet av ett Azure DevOps CLI-anrop till en pipelinevariabel använder du syntaxen task.setvariable som beskrivs i Ange variabler i skript. I följande exempel hämtas ID:t för en variabelgrupp med namnet kubernetes och det här värdet används i ett efterföljande steg.

trigger:
  - main

variables:
- name: variableGroupId

parameters:
- name: serviceConnection
  displayName: Azure Service Connection Name
  type: string
  default: my-service-connection

steps:
  - task: AzureCLI@2
    condition: succeededOrFailed()
    displayName: 'Azure CLI -> DevOps CLI'
    inputs:
      azureSubscription: '${{ parameters.serviceConnection }}'
      scriptType: pscore
      scriptLocation: inlineScript
      inlineScript: |
        Write-Host "Using logged-in Azure CLI session..."
        Write-Host "$($PSStyle.Formatting.FormatAccent)az devops configure$($PSStyle.Reset)"
        az devops configure --defaults organization=$(System.CollectionUri) project=$(System.TeamProject)
        az devops configure -l

        $id = az pipelines variable-group list --group-name kubernetes --query [].id -o tsv
        Write-Host "##vso[task.setvariable variable=variableGroupId]$id"

  - task: AzureCLI@2
    condition: succeededOrFailed()
    displayName: 'Azure CLI -> DevOps CLI'
    inputs:
      azureSubscription: '${{ parameters.serviceConnection }}'
      scriptType: pscore
      scriptLocation: inlineScript
      inlineScript: |
        Write-Host "Using logged-in Azure CLI session..."
        az pipelines variable-group variable list --group-id '$(variableGroupId)'

Fler exempel på hur du arbetar med variabler, inklusive att arbeta med variabler mellan jobb och faser, finns i Definiera variabler. Exempel på den frågesyntax som användes i föregående exempel finns i Köra frågor mot Azure CLI-kommandoutdata med hjälp av en JMESPath-fråga.

Relaterat innehåll