AzureCLI@1 - Tugas Azure CLI v1

Artikel
06/11/2024

Jalankan perintah Azure CLI terhadap langganan Azure dalam skrip shell saat berjalan di agen Linux atau skrip batch saat berjalan di agen Windows.

Jalankan skrip shell atau batch dengan perintah Azure CLI terhadap langganan Azure.

Sintaks

# Azure CLI v1
# Run Azure CLI commands against an Azure subscription in a Shell script when running on Linux agent or Batch script when running on Windows agent.
- task: AzureCLI@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription. 
    scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
    scriptPath: # string. Required when scriptLocation = scriptPath. Script Path. 
    #inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script. 
    #arguments: # string. Alias: args. Arguments. 
  # Advanced
    #addSpnToEnvironment: false # boolean. Access service principal details in script. Default: false.
    #useGlobalConfig: false # boolean. Use global Azure CLI configuration. Default: false.
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

# Azure CLI v1
# Run a Shell or Batch script with Azure CLI commands against an azure subscription.
- task: AzureCLI@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription. 
    scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
    scriptPath: # string. Required when scriptLocation = scriptPath. Script Path. 
    #inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script. 
    #arguments: # string. Alias: args. Arguments. 
  # Advanced
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

Input

azureSubscription - Langganan Azure
Alias input: connectedServiceNameARM. string. Wajib diisi.

Memilih langganan Azure Resource Manager untuk penyebaran.

scriptLocation - Lokasi Skrip
string. Wajib diisi. Nilai yang diizinkan: inlineScript (Skrip sebaris), scriptPath (Jalur skrip). Nilai default: scriptPath.

Memilih lokasi skrip.

scriptPath - Jalur Skrip
string. Diperlukan saat scriptLocation = scriptPath.

Jalur skrip yang sepenuhnya memenuhi syarat atau jalur yang relatif terhadap direktori kerja default.

inlineScript - Skrip Sebaris
string. Diperlukan saat scriptLocation = inlineScript.

Anda dapat menulis skrip Anda sebaris di sini. Saat menggunakan agen Windows, gunakan pembuatan skrip batch. Gunakan pembuatan skrip shell saat menggunakan agen berbasis Linux. Untuk file batch, gunakan awalan call sebelum setiap perintah Azure. Anda juga dapat meneruskan variabel yang telah ditentukan sebelumnya dan kustom ke skrip ini menggunakan argumen

Lihat contoh berikut. Yang pertama adalah contoh shell dan yang kedua adalah contoh batch:

azure --version || azure account show

call  azure --version || call azure account show

arguments - Argumen
Alias input: args. string.

Argumen diteruskan ke skrip.

addSpnToEnvironment - Mengakses detail perwakilan layanan dalam skrip
boolean. Nilai default: false.

Menambahkan ID perwakilan layanan dan kunci titik akhir Azure yang Anda pilih ke lingkungan eksekusi skrip. Anda dapat menggunakan $servicePrincipalId variabel dan $servicePrincipalKey dalam skrip Anda.

Ini hanya dijalankan ketika titik akhir Azure memiliki skema autentikasi Perwakilan Layanan.

useGlobalConfig - Menggunakan konfigurasi Azure CLI global
boolean. Nilai default: false.

Jika ini salah, tugas ini akan menggunakan direktori konfigurasi Azure CLI terpisah sendiri. Ini dapat digunakan untuk menjalankan tugas Azure CLI dalam rilis paralel .

workingDirectory - Direktori Kerja
Alias input: cwd. string.

Direktori kerja saat ini tempat skrip dijalankan. Jika dibiarkan kosong, input ini adalah akar repositori (build) atau artefak (rilis), yaitu $(System.DefaultWorkingDirectory).

failOnStandardError - Gagal pada Kesalahan Standar
boolean. Nilai default: false.

Jika input ini benar, tugas ini akan gagal ketika ada kesalahan yang ditulis ke aliran StandardError. Kosongkan kotak centang untuk mengabaikan kesalahan standar dan sebaliknya mengandalkan kode keluar untuk menentukan status.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Apa yang baru dalam Versi 1.0:

Mendukung Azure CLI 2.0 baru yang berbasis Python
Bekerja dengan agen lintas platform (Linux, macOS, atau Windows)
Untuk bekerja dengan Azure CLI 1.0 (berbasis node.js), beralihlah ke tugas versi 0.0
Batasan: - Tidak ada dukungan untuk langganan Azure Classic. Azure CLI 2.0 hanya mendukung langganan Azure Resource Manager (ARM).

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.0.0 atau lebih tinggi
Kategori tugas	Sebarkan

Bagikan melalui