Tutorial: Menggunakan referensi templat ARM

Pelajari cara mencari informasi skema templat, dan gunakan informasi untuk membuat templat Azure Resource Manager (templat ARM).

Dalam tutorial ini, Anda menggunakan templat dasar dari Templat Mulai Cepat Azure. Dengan menggunakan dokumentasi referensi templat, Anda memvalidasi templat.

Tutorial ini mencakup tugas-tugas berikut:

• Buka templat Mulai Cepat
• Memahami templat
• Mencari referensi templat
• Mengedit templat
• Menyebarkan templat

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum memulai.

Prasyarat

Untuk menyelesaikan artikel ini, Anda perlu:

• Visual Studio Code dengan ekstensi Alat Resource Manager. Lihat Mulai Cepat: Membuat templat ARM dengan Visual Studio Code.

Buka templat Mulai Cepat

Templat Mulai Cepat Azure adalah repositori untuk templat ARM. Daripada membuat templat dari awal, Anda dapat menemukan sampel templat dan menyesuaikannya. Templat yang digunakan dalam mulai cepat ini disebut Membuat akun penyimpanan standar. Templat menentukan sumber daya akun Azure Storage.

1. Dari Visual Studio Code, pilih File>Buka File.

2. Di Nama file, tempelkan URL berikut:

   https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
   

3. Pilih Buka untuk membuka file.

4. Pilih File>Simpan Sebagai untuk menyimpan file sebagai azuredeploy.json ke komputer lokal Anda.

Memahami skema

1. Dari Visual Studio Code, ciutkan templat ke tingkat akar. Anda memiliki struktur paling sederhana dengan elemen berikut:

   

   • $schema: tentukan lokasi file skema JSON yang menjelaskan versi bahasa templat.
   • contentVersion: tentukan nilai apa pun untuk elemen ini guna mendokumentasikan perubahan signifikan dalam templat Anda.
   • metadata: tentukan metadata templat.
   • parameters: tentukan nilai yang diberikan saat penyebaran dijalankan untuk menyesuaikan penyebaran sumber daya.
   • variables: tentukan nilai yang digunakan sebagai fragmen JSON dalam templat untuk menyederhanakan ekspresi bahasa templat. Templat ini tidak berisi elemen ini.
   • resources: tentukan jenis sumber daya yang disebarkan atau diperbarui dalam grup sumber daya.
   • outputs: tentukan nilai yang dikembalikan setelah penyebaran.

2. Perluas resources. Ada sumber daya Microsoft.Storage/storageAccounts ditentukan. Versi API yang ditampilkan pada cuplikan layar adalah 2022-09-01. Nama SKU menggunakan nilai parameter. Parameter yang disebut storageAccountType.

   

3. Perluas parameters untuk melihat cara storageAccountType ditentukan. Parameter ini memiliki empat nilai yang diizinkan.

Dengan menggunakan referensi templat, Anda dapat mengetahui apakah Anda menggunakan versi API terbaru, dan apakah definisi parameter mencakup semua nilai yang diizinkan.

Mencari referensi templat

1. Telusuri ke referensi Templat Azure.

2. Dalam kotak Filter berdasarkan judul, masukkan akun penyimpanan, dan pilih Akun Penyimpanan pertama di Referensi > Penyimpanan.

   

3. Pilih templat ARM.

4. Penyedia sumber daya biasanya memiliki beberapa versi API. Halaman ini menampilkan versi skema templat terbaru secara default. Pilih kotak dropdown Terbaru untuk melihat versinya. Versi terbaru yang ditampilkan pada cuplikan layar adalah 2022-09-01. Pilih versi Terbaru atau versi tepat di bawah Terbaru untuk melihat versi terbaru. Pastikan versi ini cocok dengan versi yang digunakan untuk sumber daya akun penyimpanan pada templat Anda. Jika Anda memperbarui versi API, verifikasi definisi sumber daya yang cocok dengan referensi templat.

   

5. Halaman ini mencantumkan detail jenis sumber daya Akun penyimpanan. Misalnya, halaman ini mencantumkan nilai yang diperbolehkan untuk objekSku. Ada delapan SKU, dan SKU tersebut cocok dengan yang tercantum dalam templat mulai cepat yang Anda buka sebelumnya.

   

Menyebarkan templat

1. Masuk ke Azure Cloud Shell

2. Pilih lingkungan pilihan Anda dengan memilih PowerShell atau Bash (untuk CLI) di sudut kiri atas. Menghidupkan ulang shell diperlukan saat Anda beralih.

   

3. Pilih Unggah/unduh file, lalu pilih Unggah. Lihat cuplikan layar sebelumnya. Pilih file yang Anda simpan di bagian sebelumnya. Setelah mengunggah file, Anda dapat menggunakan perintah ls dan perintah cat untuk memverifikasi file berhasil diunggah.

4. Dari Cloud Shell, jalankan perintah berikut. Pilih tab untuk memperlihatkan kode PowerShell atau kode CLI.

   Saat Anda menggunakan templat, tentukan storageAccountType parameter dengan nilai yang baru ditambahkan, misalnya, Standard_RAGRS. Penyebaran akan gagal jika Anda menggunakan templat mulai cepat asli karena Standard_RAGRS bukan nilai yang diizinkan.

   CLI

   echo "Enter a project name that is used to generate resource group name:" &&
   read projectName &&
   echo "Enter the location (i.e. centralus):" &&
   read location &&
   resourceGroupName="${projectName}rg" &&
   az group create --name $resourceGroupName --location "$location" &&
   az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'
   

   PowerShell

   $projectName = Read-Host -Prompt "Enter a project name that is used to generate resource group name"
   $location = Read-Host -Prompt "Enter the location (i.e. centralus)"
   $resourceGroupName = "${projectName}rg"
   
   New-AzResourceGroup -Name $resourceGroupName -Location "$location"
   New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateFile "$HOME/azuredeploy.json" -storageAccountType "Standard_RAGRS"
   

Membersihkan sumber daya

Saat sumber daya Azure tidak lagi diperlukan, bersihkan sumber daya yang Anda sebarkan dengan menghapus grup sumber daya.

1. Dari portal Microsoft Azure, pilih Grup sumber daya dari menu sebelah kiri.
2. Masukkan nama grup sumber daya di bidang Filter menurut nama.
3. Pilih nama grup sumber daya. Anda akan melihat total enam sumber daya dalam grup sumber daya.
4. Pilih Hapus grup sumber daya dari menu atas.

Langkah berikutnya

Dalam tutorial ini, Anda belajar cara menggunakan referensi templat untuk mengkustomisasi templat yang ada. Untuk mempelajari cara membuat beberapa instans akun penyimpanan, lihat:

Buat beberapa instans