AzureResourceGroupDeployment@1 - Tugas Penyebaran Grup Sumber Daya Azure v1

Artikel
06/11/2024

Gunakan tugas ini untuk menyebarkan, memulai, menghentikan, dan menghapus Grup Sumber Daya Azure.

Tugas ini tidak digunakan lagi; gunakan AzureResourceGroupDeployment@2.

Sintaks

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

Input

ConnectedServiceNameSelector - Jenis Koneksi Azure
string. Nilai yang diizinkan: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (Azure Classic). Nilai default: ConnectedServiceName.

Wajib diisi. Memilih koneksi layanan yang berisi Langganan Azure untuk penyebaran.

ConnectedServiceName - Langganan Azure
string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceName.

Wajib diisi. Memilih koneksi layanan yang berisi Langganan Azure untuk penyebaran.

ConnectedServiceNameClassic - Langganan Klasik Azure
string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Memilih langganan Azure Classic untuk penyebaran.

action - Tindakan
string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceName. Nilai yang diizinkan: Create Or Update Resource Group, , Select Resource GroupStart (Mulai Virtual Machines), Stop (Hentikan Virtual Machines), Restart (Mulai ulang Virtual Machines), Delete (Hapus Virtual Machines), DeleteRG (Hapus Grup Sumber Daya). Nilai default: Create Or Update Resource Group.

Tindakan yang akan dilakukan pada sumber daya Azure atau grup sumber daya.

actionClassic - Tindakan
string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceNameClassic. Nilai yang diizinkan: Select Resource Group (Pilih Cloud Service). Nilai default: Select Resource Group.

Tindakan yang akan dilakukan pada sumber daya Azure atau layanan cloud.

resourceGroupName - Grup Sumber Daya
string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceName.

Menyediakan nama grup sumber daya.

cloudService - Layanan Cloud
string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Menyediakan nama layanan awan.

location - Lokasi
string. Diperlukan saat action = Create Or Update Resource Group. Nilai yang diizinkan: Australia East, , Brazil SouthAustralia Southeast, Canada Central, Canada East, Central India, Central US, East Asia, East US, East US 2 , Japan East, Japan West, North Central US, South Central USNorth Europe, South India, Southeast Asia, UK South, UK West, West Central USWest Europe, West India, . West USWest US 2 Nilai default: East US.

Lokasi untuk menyebarkan grup sumber daya. Jika grup sumber daya sudah ada dalam langganan, maka nilai ini akan diabaikan.

csmFile - Template
string. Diperlukan saat action = Create Or Update Resource Group.

Menentukan jalur atau pola yang menunjuk ke templat Azure Resource Manager. Pelajari selengkapnya tentang templat Azure Resource Manager. Untuk segera memulai, gunakan templat sampel ini.

csmParametersFile - Parameter Templat
string. Opsional. Gunakan saat action = Create Or Update Resource Group.

Menentukan URL file parameter. Contoh URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Untuk menggunakan file yang disimpan di akun penyimpanan privat, ambil dan sertakan token tanda tangan akses bersama (SAS) di URL templat. Contoh: <blob_storage_url>/template.json?<SAStoken> Untuk mengunggah file parameter ke akun penyimpanan dan menghasilkan token SAS, gunakan tugas penyalinan file Azure atau ikuti langkah-langkah menggunakan PowerShell atau Azure CLI.

Untuk melihat parameter templat dalam kisi, klik di … samping kotak teks ambil alih parameter templat. Fitur ini mengharuskan aturan CORS diaktifkan di sumbernya. Jika templat berada di blob penyimpanan Azure, lihat Berbagi Sumber Daya Lintas Asal untuk mengaktifkan CORS.

overrideParameters - Mengesampingkan Parameter Templat
string. Opsional. Gunakan saat action = Create Or Update Resource Group.

Menentukan parameter templat yang akan diambil alih.

Untuk melihat parameter templat dalam kisi, klik di ... samping kotak teks Ambil Alih Parameter. Fitur ini mengharuskan aturan CORS diaktifkan di sumbernya. Jika templat berada di blob penyimpanan Azure, referensikan string ini untuk mengaktifkan CORS, atau ketik parameter templat untuk mengambil alih di kotak teks.

Contoh: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

Jika nilai parameter memiliki beberapa kata, sertakan kata-kata dalam tanda kutip, bahkan jika Anda meneruskan nilai dengan menggunakan variabel. Contohnya,-name "parameter value" -name2 "$(var)". Untuk mengambil alih parameter jenis objek, gunakan objek JSON yang diurai. Contohnya,-options ["option1"] -map {"key1": "value1" }.

deploymentMode - Mode Penyebaran
string. Diperlukan saat action = Create Or Update Resource Group. Nilai yang diizinkan: Validation (Hanya Validasi), Incremental, Complete. Nilai default: Incremental.

Mode Incremental menangani penyebaran sebagai pembaruan inkremental ke grup sumber daya. Ini meninggalkan sumber daya yang tidak berubah yang ada di grup sumber daya tetapi tidak ditentukan dalam templat.

Complete mode menghapus sumber daya yang tidak ada di templat Anda. Mode lengkap membutuhkan waktu yang relatif lebih lama daripada mode inkremental. Jika waktu tugas habis, pertimbangkan untuk meningkatkan batas waktu atau mengubah ke Incremental mode.

Peringatan

Mode lengkap akan menghapus semua sumber daya yang ada dalam grup sumber daya yang tidak ditentukan dalam templat. Tinjau apakah grup sumber daya yang Anda sebarkan tidak berisi sumber daya yang diperlukan yang tidak ditentukan dalam templat.

Validate mode memungkinkan Anda menemukan masalah dengan templat sebelum membuat sumber daya aktual.

Catatan

Mode ini Validate selalu membuat grup sumber daya, meskipun tidak ada sumber daya yang disebarkan.

Pelajari selengkapnya tentang mode penyebaran.

enableDeploymentPrerequisitesForCreate - Mengaktifkan Prasyarat Penyebaran
boolean. Pilihan. Gunakan saat action = Create Or Update Resource Group. Nilai default: false.

Hanya berlaku ketika grup sumber daya berisi komputer virtual.

Memilih opsi Grup Penyebaran mengonfigurasi agen Grup Penyebaran pada setiap komputer virtual.

Memilih opsi WinRM mengonfigurasi pendengar Windows Remote Management (WinRM) melalui protokol HTTPS pada port 5986 menggunakan sertifikat yang ditandatangani sendiri. Konfigurasi ini diperlukan untuk melakukan operasi penyebaran pada komputer Azure. Jika komputer virtual target didukung oleh load balancer, pastikan aturan NAT Masuk dikonfigurasi untuk port target (5986).

enableDeploymentPrerequisitesForSelect - Mengaktifkan Prasyarat Penyebaran
boolean. Pilihan. Gunakan saat action = Select Resource Group. Nilai default: false.

Hanya berlaku ketika grup sumber daya berisi komputer virtual.

Memilih opsi Grup Penyebaran mengonfigurasi agen Grup Penyebaran pada setiap komputer virtual.

outputVariable - Grup Sumber Daya
string.

Diperlukan saat grup sumber daya yang ada dipilih. Menyediakan nama untuk variabel grup sumber daya. Variabel dapat digunakan $(variableName) untuk merujuk ke grup sumber daya dalam tugas berikutnya, seperti di Tugas PowerShell pada Komputer Target untuk menyebarkan aplikasi.

Hanya valid ketika tindakan yang dipilih adalah Create, Update, atau Select.

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.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: azureps
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	1.103.0 atau lebih tinggi
Kategori tugas	Sebarkan

Bagikan melalui