AzureResourceGroupDeployment@2 - Tugas penyebaran grup sumber daya Azure v2

  • Artikel

Sebarkan templat Azure Resource Manager (ARM) ke grup sumber daya dan kelola komputer virtual.

Menyebarkan templat Azure Resource Manager (ARM) ke grup sumber daya. Anda juga dapat memulai, menghentikan, menghapus, dan membatalkan semua Virtual Machines (VM) dalam grup sumber daya.

Sintaks

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.
    #useWithoutJSON: false # boolean. Optional. Use when action = Create Or Update Resource Group. Use individual output values without JSON.Stringify applied. Default: false.

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.

# Azure Resource Group Deployment v2
# Deploy an Azure resource manager (ARM) template to a resource group. You can also start, stop, delete, deallocate all Virtual Machines (VM) in a resource group.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Outputs
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs.

Input

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

Memilih koneksi layanan yang berisi Langganan Azure untuk penyebaran.


action - Tindakan
string. Wajib diisi. Nilai yang diizinkan: Create Or Update Resource Group, Select Resource Group (Konfigurasikan opsi penyebaran komputer virtual), Start (Mulai komputer virtual), Stop (Hentikan komputer virtual), StopWithDeallocate (Hentikan dan batalkan alokasi komputer virtual), Restart (Hidupkan ulang komputer virtual), Delete (Hapus DeleteRG grup sumber daya). Nilai default: Create Or Update Resource Group.

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


resourceGroupName - Grup sumber daya
string. Wajib diisi.

Menyediakan nama grup sumber daya.


location - Lokasi
string. Diperlukan saat action = Create Or Update Resource Group.

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


templateLocation - Lokasi templat
string. Diperlukan saat action = Create Or Update Resource Group. Nilai yang diizinkan: Linked artifact, URL of the file. Nilai default: Linked artifact.

Pilih Artefak tertaut atau URL file.


csmFileLink - Tautan templat
string. Diperlukan saat templateLocation = URL of the file && action = Create Or Update Resource Group.

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

Untuk menyebarkan templat 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 templat (atau templat tertaut) ke akun penyimpanan dan menghasilkan token SAS, gunakan tugas penyalinan file Azure atau ikuti langkah-langkah menggunakan PowerShell atau Azure CLI.

Untuk menampilkan parameter templat dalam kisi, klik di ... samping kotak teks ganti parameter templat. Fitur ini mengharuskan aturan CORS diaktifkan di sumbernya. Jika templat berada dalam blob penyimpanan Azure, lihat Memahami permintaan CORS untuk mengaktifkan CORS.


csmParametersFileLink - Tautan parameter templat
string. Opsional. Gunakan saat templateLocation = URL of the file && action = Create Or Update Resource Group.

Menentukan URL file parameter. Contoh: https://raw.githubusercontent.com/Azure/...

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, Anda dapat menggunakan tugas penyalinan file Azure atau mengikuti langkah-langkah menggunakan PowerShell atau Azure CLI.

Untuk menampilkan parameter templat dalam kisi, klik di ... samping kotak teks ganti parameter templat. Fitur ini mengharuskan aturan CORS diaktifkan di sumbernya. Jika templat berada dalam blob penyimpanan Azure, lihat Memahami permintaan CORS untuk mengaktifkan CORS.


csmFile - Template
string. Diperlukan saat templateLocation = Linked artifact && 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. Pilihan. Gunakan saat templateLocation = Linked artifact && 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 menampilkan parameter templat dalam kisi, klik di ... samping kotak teks ganti parameter templat. Fitur ini mengharuskan aturan CORS diaktifkan di sumbernya. Jika templat berada dalam blob penyimpanan Azure, lihat Memahami permintaan CORS untuk mengaktifkan CORS.


overrideParameters - Mengesampingkan parameter templat
string. Pilihan. 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 diambil 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: Incremental, Complete, Validation (Hanya validasi). Nilai default: Incremental.

Incremental Mode 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 dalam templat Anda. Mode lengkap membutuhkan waktu yang relatif lebih lama daripada mode inkremental. Jika waktu tugas habis, pertimbangkan untuk meningkatkan waktu habis 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.


enableDeploymentPrerequisites - Mengaktifkan prasyarat
string. Opsional. Gunakan saat action = Create Or Update Resource Group || action = Select Resource Group. Nilai yang diizinkan: None, ConfigureVMwithWinRM (Konfigurasikan dengan agen WinRM), ConfigureVMWithDGAgent (Konfigurasikan dengan agen Grup Penyebaran). Nilai default: None.

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).


teamServicesConnection - Koneksi layanan Azure Pipelines
Alias input: deploymentGroupEndpoint. string. Diperlukan saat enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Menentukan koneksi layanan untuk menyambungkan ke organisasi atau koleksi Azure DevOps untuk pendaftaran agen.

Anda dapat membuat koneksi layanan menggunakan +New lalu memilih Token-based authentication. Anda memerlukan token akses pribadi (PAT) untuk menyiapkan koneksi layanan. Klik Manage untuk memperbarui detail koneksi layanan.


teamServicesConnection - Koneksi layanan Azure Pipelines/TFS
Alias input: deploymentGroupEndpoint. string. Diperlukan saat enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Menentukan koneksi layanan untuk menyambungkan ke organisasi atau koleksi Azure DevOps untuk pendaftaran agen.

Anda dapat membuat koneksi layanan menggunakan +New lalu memilih Token-based authentication. Anda memerlukan token akses pribadi (PAT) untuk menyiapkan koneksi layanan. Klik Manage untuk memperbarui detail koneksi layanan.


teamProject - Proyek tim
Alias input: project. string. Diperlukan saat enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Menentukan Proyek Tim yang menentukan grup penyebaran.


deploymentGroupName - Grup Penyebaran
string. Diperlukan saat enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Menentukan grup penyebaran tempat agen akan didaftarkan. Pelajari selengkapnya tentang grup penyebaran.


copyAzureVMTags - Menyalin tag Azure VM ke agen
boolean. Pilihan. Gunakan saat enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Nilai default: true.

Memilih apakah tag yang dikonfigurasi pada Azure VM perlu disalin ke agen grup penyebaran yang sesuai.

Secara default, semua tag Azure disalin mengikuti format: Key: Value. Contoh: Tag Role : Web Azure akan disalin apa adanya ke mesin agen.

Pelajari selengkapnya tentang menggunakan tag untuk sumber daya Azure.


runAgentServiceAsUser - Menjalankan layanan agen sebagai pengguna
boolean. Pilihan. Gunakan saat enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Nilai default: false.

Menjalankan layanan agen sebagai pengguna selain pengguna default jika nilai diatur ke true.

Pengguna default berada NT AUTHORITY\\SYSTEM di Windows dan root di Linux.


userName - Nama pengguna
string. Diperlukan saat enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Nama pengguna untuk menjalankan layanan agen pada komputer virtual.

Untuk pengguna domain, tentukan nilai sebagai domain\username atau username@domain.com. Untuk pengguna lokal, tentukan username.

Diasumsikan bahwa pengguna domain yang sama atau pengguna lokal dengan nama yang sama, masing-masing hadir di semua komputer virtual dalam grup sumber daya.


password - Password
string. Opsional. Gunakan saat enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Kata sandi bagi pengguna untuk menjalankan layanan agen pada VM Windows.

Diasumsikan bahwa kata sandi sama untuk pengguna yang ditentukan pada semua VM.

Ini dapat menerima variabel yang ditentukan dalam alur build atau rilis sebagai $(passwordVariable). Anda dapat menandai variabel sebagai secret untuk mengamankannya.

Untuk VM Linux, kata sandi tidak diperlukan dan akan diabaikan.


outputVariable - Detail VM untuk WinRM
string. Pilihan. Gunakan saat enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group.

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

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


deploymentName - Nama penyebaran
string. Pilihan. Gunakan saat action = Create Or Update Resource Group.

Menentukan nama penyebaran grup sumber daya yang akan dibuat.


deploymentOutputs - Output penyebaran
string. Pilihan. Gunakan saat action = Create Or Update Resource Group.

Menyediakan nama untuk variabel output, yang berisi bagian output dari objek penyebaran saat ini dalam format string. ConvertFrom-Json Gunakan cmdlet PowerShell untuk mengurai objek JSON dan mengakses nilai output individual.


addSpnToEnvironment - Mengakses detail perwakilan layanan dalam mengambil alih parameter
boolean. Pilihan. Gunakan saat action = Create Or Update Resource Group. Nilai default: false.

Menambahkan ID perwakilan layanan dan kunci titik akhir Azure yang dipilih untuk menjadi lingkungan eksekusi skrip. Variabel $servicePrincipalId dan $servicePrincipalKey dapat berada dalam parameter penimpaan, seperti -key $servicePrincipalKey.


useWithoutJSON - Gunakan nilai output individual tanpa JSON. Stringify diterapkan
boolean. Pilihan. Gunakan saat action = Create Or Update Resource Group. Nilai default: false.

Nilai output individual sedang dikonversi melalui JSON. Stringify secara default. Jika Anda ingin menggunakan nilai output apa adanya tanpa mengonversinya melalui JSON. Stringify, aktifkan opsi ini. Untuk detail selengkapnya, lihat ini.


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

Ada versi baru dari tugas ini yang tersedia di AzureResourceManagerTemplateDeployment@3 - tugas penyebaran templat ARM v3.

Apa yang baru dalam tugas versi 2

  • Bekerja dengan agen lintas platform (Linux, macOS, atau Windows)
  • Mendukung JSON Templat yang terletak di URL http/https yang dapat diakses publik.
  • UX yang disempurnakan untuk Mengambil alih parameter yang sekarang dapat dilihat/diedit dalam kisi.
  • Pemetaan aturan NAT untuk VM yang didukung oleh Load balancer.
  • Bidang "Grup sumber daya" sekarang diganti namanya menjadi "detail VM untuk WinRM" dan disertakan di bagian "Opsi penyebaran tingkat lanjut untuk komputer virtual".
  • Keterbatasan:
    • Tidak ada dukungan untuk langganan Klasik. Hanya langganan ARM yang didukung.
    • Tidak ada dukungan untuk sintaks PowerShell karena tugas sekarang berbasis node.js. Pastikan sensitivitas kasus nama parameter cocok, saat Anda mengambil alih parameter templat. Selain itu, hapus cmdlet PowerShell seperti "ConvertTo-SecureString" saat Anda bermigrasi dari versi 1.0 ke versi 2.0.

Pemecahan Masalah

Kesalahan: Kesalahan Server Internal

Sebagian besar masalah-masalah bersifat sementara. Ada beberapa alasan mengapa itu bisa terjadi:

  • Salah satu layanan Azure yang coba Anda sebarkan adalah menjalani pemeliharaan di wilayah tempat Anda mencoba menyebarkan. Awasi https://status.azure.com/ untuk memeriksa waktu henti Layanan Azure.
  • Layanan Azure Pipelines sendiri sedang dalam pemeliharaan. Awasi https://status.dev.azure.com/ waktu henti.

Namun, kami telah melihat beberapa instans yang disebabkan oleh kesalahan pada templat ARM, seperti layanan Azure yang Anda coba sebarkan tidak mendukung wilayah yang Anda pilih untuk sumber daya.

Kesalahan: Waktu habis

Masalah waktu habis dapat berasal dari dua tempat:

  • Agen Azure Pipelines
  • Penyebaran Portal

Anda dapat mengidentifikasi apakah batas waktu berasal dari portal, dengan memeriksa tautan penyebaran portal yang akan ada di log tugas. Jika link tidak muncul, kemungkinan penyebabnya ada agen Azure Pipelines. Jika ada link, ikuti link tersebut untuk melihat apakah ada batas waktu yang telah terjadi dalam penyebaran portal.

Kesalahan: Aturan CORS yang akan diaktifkan saat mengesampingkan parameter

Jika file templat dirujuk dari BLOB, saat mengganti parameter dalam alur, Anda mungkin melihat pesan peringatan berikut:

Warning: Failed to download the file from template path.

Fitur ini mengharuskan aturan CORS diaktifkan di sumbernya. Jika templat berada di blob penyimpanan Azure, lihat Dukungan berbagi sumber daya lintas asal untuk mengaktifkan CORS.

Selain mengaktifkan CORS, pastikan bahwa token SAS yang ditentukan dalam tautan templat adalah "srt-sco". Token ini Anda perlukan untuk mengunduh file dan melanjutkan.

Agen Azure Pipelines

Jika masalah berasal dari agen Azure Pipelines, Anda dapat meningkatkan batas waktu dengan mengatur timeoutInMinutes sebagai kunci dalam YAML ke 0. Untuk informasi selengkapnya, lihat Menentukan pekerjaan di alur Anda.

Penyebaran Portal

Lihat dokumen ini tentang cara mengidentifikasi apakah kesalahan berasal dari portal Azure: Lihat riwayat penyebaran dengan Azure Resource Manager.

Dalam kasus penyebaran portal, coba atur "timeoutInMinutes" di templat ARM ke "0". Jika tidak ditentukan, nilai yang diasumsikan adalah 60 menit. 0 memastikan penyebaran akan berjalan selama dapat berhasil.

Ini juga bisa terjadi karena masalah sementara dalam sistem. Awasi https://status.dev.azure.com/ untuk memeriksa apakah ada waktu henti di layanan Azure Pipelines.

Kesalahan: Validasi gagal templat Azure Resource Manager (ARM)

Masalah ini sebagian besar terjadi karena parameter yang tidak valid dalam templat ARM, seperti SKU atau wilayah yang tidak didukung. Jika validasi gagal, periksa pesan kesalahan. Pesan kesalahan akan mengarahkan Anda ke sumber daya dan parameter yang tidak valid.

Masalah ini juga mungkin terjadi karena string multibaris. Saat ini, tugas Penyebaran Grup Sumber Daya Azure tidak mendukung string multibaris di templat ARM atau file JSON parameter.

Selain itu, lihat artikel ini mengenai struktur dan sintaks Templat ARM: Memahami struktur dan sintaks templat ARM.

Persyaratan

Persyaratan Deskripsi
Jenis alur YAML, Build klasik, Rilis klasik
Berjalan pada Agen, DeploymentGroup
Permintaan Tidak ada
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 2.119.1 atau lebih tinggi
Kategori tugas Sebarkan