Azure CLI görevi

Azure Pipelines

Azure aboneliğine karşı Azure CLı komutlarını içeren bir kabuk veya Batch betiği çalıştırmak için bu görevi kullanın.

Bu görev, Linux, macOS veya Windows işletim sistemleri üzerinde çalışan platformlar arası aracılarda Azure CLı komutlarını çalıştırmak için kullanılır.

Sürüm 2,0 ' deki yenilikler

  • PowerShell ve PowerShell Core betiğini çalıştırmayı destekler
  • PowerShell Core betiği Xplat aracıları (Windows, Linux veya OSX) ile birlikte çalışarak, aracının PowerShell sürüm 6 veya üzeri bir sürüme sahip olduğundan emin olun
  • PowerShell betiği yalnızca Windows Agent ile birlikte çalışarak, aracının PowerShell sürüm 5 veya daha düşük olduğundan emin olun

Önkoşullar

  • Bir Microsoft Azure aboneliği

  • Azure hesabınıza yönelik hizmet bağlantısı Azure Resource Manager

  • Microsoft barındırılan aracılarında Azure CLı önceden yüklenmiş olmalıdır. Ancak özel aracılar kullanıyorsanız, derleme ve yayın aracısını çalıştıran bilgisayarlara Azure CLI 'yı yükleyebilirsiniz . Azure CLı 'nin yüklü olduğu makinede bir aracı zaten çalışıyorsa, tüm ilgili aşama değişkenlerinin güncelleştirildiğinden emin olmak için aracıyı yeniden başlatın.

Görev girişleri

Parametreler Description
azureSubscription
Azure aboneliği
Istenir Dağıtım için bir Azure Resource Manager aboneliği seçin. Bu parametre yalnızca seçili görev sürümü 0 olduğunda gösterilir. Azure CLı görevi v 1.0 yalnızca Azure Resource Manager (ARM) aboneliklerini destekler
scriptType
Betik türü
Istenir Betik türü: PowerShell/PowerShell Core/bat/Shell betiği. Windows Agent üzerinde çalışırken Linux Aracısı veya Batch/PS/pscore betiği üzerinde çalışırken Bash/pscore betiği ' ni seçin. PowerShell Core betiği platformlar arası aracılarda (Linux, macOS veya Windows) çalıştırılabilir
scriptLocation
Betik konumu
Istenir Betiğin yolu: dosya yolu veya satır Içi betik
Varsayılan değer: scriptPath
scriptPath
Betik yolu
Istenir Komut dosyasının (. ps1 veya. bat veya. cmd .ps1 .sh ) veya Linux tabanlı aracı kullanılırken veya varsayılan çalışma dizinine göre bir yoldan oluşan tam yol.
inlineScript
Satır içi betik
Istenir Betiklerinizi buraya satır içinde yazabilirsiniz. Windows Aracısı kullanırken, Linux tabanlı aracılar kullanılırken PowerShell veya PowerShell Core veya Batch Scripting kullanın, PowerShell Core veya Shell Scripting kullanın. Toplu iş dosyaları için, \" \" her Azure komutundan önce önek çağrısını kullanın. Ayrıca, bağımsız değişkenleri kullanarak bu komut dosyasına önceden tanımlanmış ve özel değişkenler geçirebilirsiniz.
PowerShell/PowerShellCore/Shell Için örnek: az--Version az Account Show
Batch Için örnek: çağrı az--sürüm çağrısı az Account Show
arguments
Betik bağımsız değişkenleri
Seçim Betiğe geçirilen bağımsız değişkenler
powerShellErrorActionPreference
ErrorActionPreference
Seçim , PowerShell/PowerShell Core betiğinizin üst kısmındaki $ErrorActionPreference = ' Value ' satırı önüne eklenir
Varsayılan değer: durdur
Seçenekler durdurulur, devam eder ve silentlyContinue
addSpnToEnvironment
Betikteki hizmet sorumlusu ayrıntılarına erişin
Seçim Komut dosyasının yürütme ortamına seçtiğiniz Azure uç noktasının hizmet sorumlusu kimliği ve anahtarını ekler. Şu değişkenleri kullanabilirsiniz: $env: Serviceprincipalıd, $env: Servicesprincipalkey ve $env: Tenantıd . Bu yalnızca Azure uç noktası hizmet sorumlusu kimlik doğrulama şemasına sahip olduğunda kabul edilir
Varsayılan değer: false
useGlobalConfig
Küresel Azure CLı yapılandırmasını kullanma
Seçim Bu yanlışsa, bu görev kendi ayrı Azure CLI yapılandırma dizininikullanır. Bu, Azure CLı görevlerini paralel sürümlerde çalıştırmak için kullanılabilir "
Varsayılan değer: false
workingDirectory
Çalışma dizini
Seçim Betiğin çalıştırıldığı geçerli çalışma dizini. Boş, $ (System. DefaultWorkingDirectory) olan deponun (derleme) veya yapıtların (yayın) köküdür
failOnStandardError
Standart hatada başarısız oldu
Seçim Bu doğruysa, Standarfstream 'e herhangi bir hata yazıldığında bu görev başarısız olur. Durumu anlamak için standart hataları yok Sayın ve çıkış kodlarını kullanan onay kutusunun seçimini kaldırın
Varsayılan değer: false
powerShellIgnoreLASTEXITCODE
$LASTEXITCODE yoksay
Seçim Bu yanlışsa, satır if ((Test-Path -LiteralPath variable:\\LASTEXITCODE)) { exit $LASTEXITCODE } betiğinizin sonuna eklenir. Bu, dış komuttan gelen son çıkış kodunun, PowerShell çıkış kodu olarak yayılmasına neden olur. Aksi takdirde satır, betiğinizin sonuna eklenmez
Varsayılan değer: false

Örnek

Aşağıda, Azure CLı 'nin sürümünü listeleyen ve aboneliğin ayrıntılarını alan bir YAML kod parçacığına örnek verilmiştir.

- task: AzureCLI@2
  displayName: Azure CLI
  inputs:
    azureSubscription: <Name of the Azure Resource Manager service connection>
    scriptType: ps
    scriptLocation: inlineScript
    inlineScript: |
      az --version
      az account show

Aşağıdaki örnek, betiğe bağımsız değişkenlerin nasıl geçirileceğini gösterir.

- task: AzureCLI@2
  displayName: Azure CLI
  inputs:
    azureSubscription: <Name of the Azure Resource Manager service connection>
    scriptType: ps
    scriptLocation: inlineScript
    arguments:
      -Arg1 val1 `
      -Arg2 val2 `
      -Arg3 val3
    inlineScript: |
      az login --allow-no-subscription

Açık kaynak

Bu görev GitHub 'daaçık kaynaktır. Geribildirim ve katılımlar hoş geldiniz.

SSS

Bir aracıya ihtiyacım var mı?

Yapınızı veya sürümünüzü çalıştırmak için en az bir aracınız olması gerekir.

Sorun yaşıyorum. Sorunları nasıl giderebilirim?

Bkz. derleme ve yayın sorunlarını giderme.

Varsayılan bir aracı havuzu seçemiyorum ve derleme veya yayınımı sıraya alamıyorum. Bu Nasıl yaparım? düzeltilsin mi?

Bkz. Aracı havuzları.

NuGet Push görevlerim şu hata ile başarısız oluyor: "hata: yerel veren sertifikası alınamıyor". Bunu nasıl giderebilirim?

Bu, güvenilen kök sertifika eklenerek düzeltilebilir. NODE_EXTRA_CA_CERTS=fileOrtam değişkenini yapı aracıya ekleyebilir veya NODE.EXTRA.CA.CERTS=file görev değişkenini işlem hattınızda ekleyebilirsiniz. Daha fazla ayrıntı için bkz. ortam değişkenleri .