Bagikan melalui

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.

Referensi template Resource Manager menyebarkan akun penyimpanan

Tutorial ini mencakup tugas-tugas berikut:

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

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

Prasyarat

Untuk menyelesaikan artikel ini, Anda memerlukan Visual Studio Code.

Membuka templat Mulai Cepat

Templat Mulai Cepat Azure adalah repositori untuk templat ARM. Daripada membuat templat dari awal, Anda dapat menemukan contoh 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:

    Struktur paling sederhana templat Resource Manager

    • $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 dalam cuplikan layar sebelumnya adalah 2022-09-01. Nama SKU menggunakan nilai parameter. Parameter yang disebut storageAccountType.

    Definisi akun penyimpanan templat Resource Manager

  3. Perluas parameters untuk melihat cara storageAccountType ditentukan. Parameter ini memiliki empat nilai yang diizinkan. Sku sumber daya akun penyimpanan templat Resource Manager

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

Mencari referensi templat

  1. Telusuri ke referensi Templat Azure.

  2. Dari menu sebelah kiri, temukan Penyimpanan, perluas Penyimpanan, lalu pilih Akun 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 terbarunya adalah 2025-06-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.

    Akun penyimpanan referensi templat Resource Manager

  5. Halaman ini mencantumkan detail jenis sumber daya Akun penyimpanan. Misalnya, halaman ini mencantumkan nilai yang diperbolehkan untuk objekSku. Ada 14 SKU untuk API versi 2025-06-01.

    Sku akun penyimpanan referensi templat Resource Manager

Menyebarkan templat

  1. Masuk ke Azure Cloud Shell.

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

    File unggahan Cloud Shell portal Microsoft Azure

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

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

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

    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'

Membersihkan sumber daya

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

  1. Dari portal 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 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

  • Last updated on