Bagikan melalui

Tutorial: Membuat dan menyebarkan templat ARM pertama Anda

Tutorial ini memperkenalkan Anda ke templat Azure Resource Manager (templat ARM). Ini menunjukkan kepada Anda cara membuat templat pemula dan menyebarkannya ke Azure. Ini mengajarkan Anda tentang struktur templat dan alat yang Anda butuhkan untuk bekerja dengan templat. Instruksi ini membutuhkan waktu 12 menit untuk diselesaikan, tetapi waktu selesai aktual bervariasi berdasarkan berapa banyak alat yang perlu Anda instal.

Tutorial ini adalah yang pertama dari seri. Saat Anda maju melalui seri, Anda memodifikasi templat awal, langkah demi langkah, hingga Anda menjelajahi semua bagian inti templat ARM. Elemen-elemen ini adalah blok penyusun untuk templat yang lebih kompleks. Kami berharap pada akhir seri ini Anda yakin dalam membuat templat Anda sendiri dan siap untuk mengotomatisasi penyebaran Anda dengan templat.

Jika Anda ingin mempelajari tentang manfaat menggunakan templat dan mengapa Anda harus mengotomatiskan penyebaran dengan templat, lihat Gambaran umum templat ARM. Untuk mempelajari tentang templat ARM melalui sekumpulan modul Learn yang dipandu, lihat Menyebarkan dan mengelola sumber daya di Azure dengan menggunakan templat JSON ARM.

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

Petunjuk / Saran

Jika Anda baru menggunakan templat ARM, Anda mungkin mempertimbangkan untuk mempelajari Bicep sebagai gantinya. Bicep adalah bahasa baru yang menawarkan kemampuan yang sama dengan templat ARM tetapi dengan sintaks yang lebih mudah digunakan. Untuk mulai mempelajari Bicep, lihat Mulai Cepat: Membuat file Bicep dengan Visual Studio Code.

Dapatkan alat

Mari kita mulai dengan memastikan Anda memiliki alat yang Anda butuhkan untuk membuat dan menyebarkan templat. Instal alat-alat ini di komputer lokal Anda.

Editor

Templat adalah file JavaScript Object Notation (JSON). Untuk membuat templat, Anda dapat menggunakan Visual Studio Code.

Penyebaran baris perintah

Anda juga memerlukan Azure PowerShell atau Azure Command-Line Interface (CLI) untuk menyebarkan templat. Jika Anda menggunakan Azure CLI, Anda harus memiliki versi 2.37.0 atau yang lebih baru. Untuk petunjuk penginstalan, lihat:

Setelah menginstal Azure PowerShell atau Azure CLI, pastikan Anda masuk untuk pertama kalinya. Untuk bantuan, lihat Masuk - PowerShell atau Masuk - Azure CLI.

Penting

Jika Anda menggunakan Azure CLI, pastikan Anda memiliki versi 2.37.0 atau yang lebih baru. Jika Anda menggunakan Azure PowerShell, pastikan Anda memiliki versi 7.2.4 atau yang lebih baru. Perintah yang ditampilkan dalam tutorial ini tidak berfungsi jika Anda menggunakan versi sebelumnya. Untuk memeriksa versi yang terinstal, gunakan: az --version.

Oke, Anda siap untuk mulai mempelajari tentang templat.

Membuat templat pertama Anda

  1. Buka Visual Studio Code.

  2. Dari menu File , pilih File Baru untuk membuat file baru.

  3. Dari menu File , pilih Simpan Sebagai.

  4. Beri nama file azuredeploy dan pilih ekstensi file json . Nama lengkap file azuredeploy.json.

  5. Simpan file ke stasiun kerja Anda. Pilih jalur yang mudah diingat karena Anda perlu menyediakan jalur tersebut nanti saat menyebarkan templat.

  6. Salin dan tempel JSON berikut ke dalam file:

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": []
}

    Berikut tampilan lingkungan Visual Studio Code Anda:

    Cuplikan layar Visual Studio Code menampilkan templat ARM kosong dengan struktur JSON di editor.

    Templat ini tidak menyebarkan sumber daya apa pun. Kami memulai dengan templat kosong sehingga Anda bisa terbiasa dengan langkah-langkah untuk menyebarkan templat sambil meminimalkan kemungkinan terjadi kesalahan.

    File JSON memiliki elemen-elemen ini:

    • $schema: Menentukan lokasi file skema JSON. File skema menjelaskan properti yang tersedia dalam templat. Skema, misalnya, mendefinisikan resources sebagai salah satu properti yang valid untuk templat. Jangan khawatir bahwa tanggal untuk skema adalah 2019-04-01. Versi skema ini sudah diperbarui dan mencakup semua fitur terbaru. Tanggal skema belum diubah karena tidak ada perubahan signifikan sejak pengenalannya.
    • contentVersion: Menentukan versi templat, seperti 1.0.0.0. Anda dapat memberikan nilai apa pun untuk elemen ini. Gunakan nilai ini untuk mendokumen perubahan signifikan dalam templat Anda. Saat Anda menyebarkan sumber daya menggunakan templat, Anda dapat menggunakan nilai ini untuk memastikan Anda menggunakan templat yang tepat.
    • resources: Berisi sumber daya yang ingin Anda sebarkan atau perbarui. Saat ini, kosong, tetapi Anda dapat menambahkan sumber daya nanti.

  7. Simpan file tersebut.

Selamat, Anda telah membuat templat pertama Anda.

Masuk ke Azure

Untuk mulai bekerja dengan Azure PowerShell atau Azure CLI, masuk dengan kredensial Azure Anda.

Pilih tab di bagian kode berikut untuk dipilih antara Azure PowerShell dan Azure CLI. Contoh CLI dalam artikel ini ditulis untuk shell Bash.

Connect-AzAccount

Jika Anda memiliki beberapa langganan Azure, pilih langganan yang ingin Anda gunakan. Ganti SubscriptionName dengan nama langganan Anda. Anda juga dapat menggunakan ID langganan, bukan nama langganan Anda.

Set-AzContext SubscriptionName

Buat grup sumber daya

Saat Anda menerapkan templat, Anda dapat menentukan grup sumber daya yang akan digunakan untuk menampung sumber daya. Sebelum menjalankan perintah penyebaran, buat grup sumber daya dengan Bash Azure CLI atau Azure PowerShell.

Nota

Contoh-contoh untuk Azure CLI ditulis di shell bash. Untuk menjalankan sampel ini di Windows PowerShell atau Prompt Perintah, Anda mungkin perlu menghapus tanda garis miring terbalik dan menuliskan perintah dalam satu baris seperti contoh berikut:

New-AzResourceGroup `
  -Name myResourceGroup `
  -Location "Central US"

Menyebarkan templat

Untuk menyebarkan templat, gunakan Azure CLI atau Azure PowerShell. Gunakan grup sumber daya yang Anda buat. Beri nama untuk penyebaran sehingga Anda dapat dengan mudah mengidentifikasinya dalam riwayat penyebaran. Untuk kenyamanan, buat juga variabel yang menyimpan jalur ke file templat. Variabel ini memudahkan Anda menjalankan perintah penyebaran karena Anda tidak perlu mengetik ulang jalur setiap kali Anda menyebarkan. Ganti {provide-the-path-to-the-template-file} dan kurung kurawal {} dengan jalur ke file templat Anda.

$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
  -Name blanktemplate `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Perintah penggunaan menampilkan hasil. Periksa ProvisioningState untuk melihat apakah penyebaran berhasil.

Nota

Jika penyebaran gagal, gunakan sakelar verbose untuk mendapatkan informasi tentang sumber daya yang dibuat. Gunakan saklar debug untuk mendapatkan informasi selengkapnya untuk pemecahan masalah.

Verifikasi implementasi

Anda dapat memverifikasi penyebaran dengan menjelajahi grup sumber daya dari portal Microsoft Azure.

  1. Masuk ke portal Azure.

  2. Dari menu sebelah kiri, pilih Grup sumber daya.

  3. Centang kotak di sebelah kiri myResourceGroup dan pilih myResourceGroup.

  4. Pilih grup sumber daya yang Anda buat di prosedur sebelumnya. Nama defaultnya adalah myResourceGroup. Grup sumber daya belum memiliki sumber daya karena Anda menyebarkan templat kosong.

  5. Perhatikan di tengah ringkasan, di bagian Esensial , halaman menampilkan status penyebaran di samping Penyebaran. Pilih 1 Berhasil.

    Cuplikan layar portal Microsoft Azure memperlihatkan status penyebaran di bagian Esensial dari grup sumber daya.

  6. Anda melihat riwayat penyebaran untuk grup sumber daya. Centang kotak di sebelah kiri blanktemplate dan pilih blanktemplate.

    Cuplikan layar portal Microsoft Azure yang menampilkan riwayat penyebaran dengan penyebaran blanktemplate dipilih.

  7. Anda melihat ringkasan penginstalan. Dalam hal ini, tidak banyak yang bisa dilihat karena tidak ada sumber daya yang dikerahkan. Nantinya dalam seri ini, Anda mungkin merasa perlu untuk meninjau ringkasan dalam riwayat penyebaran. Perhatikan di sebelah kiri Anda dapat melihat input, output, dan template yang digunakan deployment.

    Cuplikan layar portal Microsoft Azure memperlihatkan ringkasan penyebaran untuk penyebaran blanktemplate.

Membersihkan sumber daya

Jika Anda melanjutkan ke tutorial berikutnya, Anda tidak perlu menghapus grup sumber daya.

Jika berhenti sekarang, Anda mungkin ingin menghapus grup sumber daya.

  1. Dari portal Microsoft Azure, pilih Grup sumber daya dari menu sebelah kiri.

  2. Ketik nama grup sumber daya di kotak teks Filter untuk bidang apa pun....

  3. Centang kotak di samping myResourceGroup dan pilih myResourceGroup atau nama grup sumber daya Anda.

  4. Pilih Hapus grup sumber daya dari menu atas.

    Cuplikan layar portal Microsoft Azure dengan opsi Hapus grup sumber daya disorot dalam tampilan grup sumber daya.

Langkah selanjutnya

Anda membuat templat sederhana untuk disebarkan ke Azure. Dalam tutorial berikutnya, Anda dapat mempelajari cara menambahkan akun penyimpanan ke templat dan menyebarkannya ke grup sumber daya Anda.

Menambahkan sumber daya

  • Last updated on