Latihan - Menentukan sumber daya dalam templat Bicep

  • 12 menit

Catatan

Saat Anda pertama kali mengaktifkan kotak pasir dan menerima persyaratan, akun Microsoft Anda dikaitkan dengan direktori Azure baru bernama Microsoft Learn Sandbox. Anda juga ditambahkan ke langganan khusus bernama Langganan Concierge.

Untuk situs web peluncuran mainan Anda, Anda memutuskan untuk terlebih dahulu membuat bukti konsep dengan membuat templat Bicep dasar. Dalam latihan ini, Anda akan membuat akun penyimpanan, paket Azure App Service, dan aplikasi. Nantinya, Anda akan memodifikasi templat agar lebih dapat digunakan kembali.

Selama proses tersebut, Anda akan:

  • Membuat templat yang menentukan satu sumber daya akun penyimpanan yang menyertakan nilai yang dikodekan secara permanen.
  • Menyediakan infrastruktur Anda dan memverifikasi hasilnya.
  • Menambahkan paket dan aplikasi App Service ke templat.
  • Menyediakan infrastruktur lagi untuk melihat sumber daya baru.

Latihan ini menggunakan ekstensi Bicep untuk Visual Studio Code. Pastikan untuk menginstal ekstensi ini di Visual Studio Code.

Membuat templat Bicep yang berisi akun penyimpanan

  1. Buka Visual Studio Code.

  2. Buat file baru yang disebut main.bicep.

  3. Simpan file kosong sehingga Visual Studio Code dapat memuat alat Bicep.

    Anda dapat memilih File>Simpan Sebagai atau pilih Ctrl+S untuk Windows (⌘+S untuk macOS). Pastikan Anda mengingat di mana Anda menyimpan file tersebut. Misalnya, Anda mungkin ingin membuat folder templat untuk menyimpan file.

  4. Tambahkan kode Bicep berikut ke dalam file. Anda akan segera menyebarkan templat. Ada baiknya untuk mengetik kode sendiri alih-alih menyalin dan menempelkan, sehingga Anda dapat melihat bagaimana alat membantu Anda menulis file Bicep Anda.

    resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
  name: 'toylaunchstorage'
  location: 'eastus'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
  }
}

    Tip

    Bicep sangatlah teliti mengenai lokasi Anda meletakkan jeda baris, jadi pastikan Anda tidak meletakkan jeda baris di tempat yang berbeda dari yang tercantum di sini.

    Perhatikan bahwa Visual Studio Code secara otomatis menyarankan nama properti saat Anda mengetik. Ekstensi Bicep untuk Visual Studio Code memahami sumber daya yang Anda tentukan di templat Anda, dan mencantumkan properti dan nilai yang tersedia yang dapat Anda gunakan.

  5. Perbarui nama akun penyimpanan dari toylaunchstorage ke sesuatu yang kemungkinan unik, karena setiap akun penyimpanan membutuhkan nama yang unik secara global. Pastikan namanya adalah 3 hingga 24 karakter dan hanya menyertakan huruf kecil dan angka.

    Penting

    Jangan lewati langkah ini. Jika ya, file Bicep Anda tidak akan berhasil disebarkan.

  6. Simpan perubahan pada file.

Menyebarkan templat Bicep ke Azure

Untuk menyebarkan templat ini ke Azure, Anda harus masuk ke akun Azure Anda dari terminal Visual Studio Code. Pastikan Anda telah menginstal Azure CLI, dan ingatlah untuk masuk dengan akun yang sama dengan yang Anda gunakan untuk mengaktifkan kotak pasir.

  1. Pada menu Terminal, pilih Terminal Baru. Jendela terminal biasanya terbuka di bagian bawah layar Anda.

  2. Jika shell yang ditampilkan di sisi kanan jendela terminal adalah bash, shell yang benar terbuka dan Anda dapat melompat ke bagian berikutnya.

    Screenshot of the Visual Studio Code terminal window, with the bash option shown.

  3. Jika shell selain bash muncul, pilih panah dropdown shell, lalu pilih Git Bash.

    Screenshot of the Visual Studio Code terminal window, with the terminal shell dropdown shown and Git Bash Default selected.

  4. Dalam daftar shell terminal, pilih bash.

    Screenshot of the Visual Studio Code terminal window, with the bash terminal selected.

  5. Di terminal, buka direktori tempat Anda menyimpan template. Misalnya, jika Anda menyimpan template ke folder template, Anda dapat menggunakan perintah ini:

    cd templates

Menginstal Bisep

Jalankan perintah berikut untuk memastikan Anda memiliki Bicep versi terbaru:

az bicep install && az bicep upgrade

Masuk ke Azure

  1. Pada terminal Visual Studio Code, masuk ke Azure dengan menjalankan perintah berikut:

    az login

  2. Masuk ke akun Azure Anda melalui browser yang terbuka.

    Terminal Visual Studio Code menampilkan daftar langganan yang terkait dengan akun ini.

  3. Tetapkan langganan default untuk semua perintah Azure CLI yang Anda jalankan dalam sesi ini.

    az account set --subscription "Concierge Subscription"

    Catatan

    Jika Anda telah menggunakan lebih dari satu kotak pasir baru-baru ini, terminal mungkin menampilkan lebih dari satu instans Langganan Concierge. Jika demikian, gunakan dua langkah berikutnya untuk menetapkan salah satunya sebagai langganan default. Jika perintah sebelumnya berhasil, dan hanya satu Langganan Concierge yang tercantum, lewati dua langkah berikutnya.

  4. Mendapatkan ID Langganan Concierge.

     az account list \
   --refresh \
   --query "[?contains(name, 'Concierge Subscription')].id" \
   --output table

  5. Tetapkan langganan default menggunakan ID langganan. Ganti {ID langganan Anda} dengan ID Langganan Concierge terbaru.

    az account set --subscription {your subscription ID}

Menetapkan grup sumber daya default

Saat menggunakan Azure CLI, Anda dapat mengatur grup sumber daya default dan menghilangkan parameter dari perintah Azure CLI lainnya dalam latihan ini. Atur default ke grup sumber daya yang dibuat untuk Anda di lingkungan kotak pasir.

az configure --defaults group="<rgn>[sandbox resource group name]</rgn>"

Menyebarkan templat ke Azure

Jalankan perintah berikut dari terminal di Visual Studio Code untuk menyebarkan templat Bicep ke Azure. Perintah dapat memakan waktu satu atau dua menit untuk diselesaikan, lalu Anda akan melihat penyebaran yang berhasil. Jika Anda melihat peringatan tentang lokasi yang dikodekan secara permanen, Anda dapat mengabaikannya. Anda akan memperbaiki lokasi nanti di modul. Aman untuk melanjutkan dan penyebaran akan berhasil.

az deployment group create --template-file main.bicep

Anda akan melihat Running... di terminal.

Untuk menyebarkan template ini ke Azure, masuk ke akun Azure dari terminal Visual Studio Code. Pastikan Anda telah menginstal Azure PowerShell, dan masuk ke akun yang sama yang mengaktifkan ko.

  1. Pada menu Terminal, pilih Terminal Baru. Jendela terminal biasanya terbuka di bagian bawah layar Anda.

  2. Jika shell yang ditampilkan di sisi kanan jendela terminal adalah powershell atau pwsh, shell yang benar terbuka, dan Anda dapat melompat ke bagian berikutnya.

    Screenshot of the Visual Studio Code terminal window, with the pwsh option displayed in the shell dropdown list.

  3. Jika shell selain powershell atau pwsh muncul, pilih panah dropdown shell, lalu pilih PowerShell.

    Screenshot of the Visual Studio Code terminal window, with the terminal shell dropdown list shown and PowerShell selected.

  4. Dalam daftar shell terminal, pilih powershell atau pwsh.

    Screenshot of the Visual Studio Code terminal window, with the PowerShell terminal selected.

  5. Di terminal, buka direktori tempat Anda menyimpan template. Misalnya, jika Anda menyimpannya ke folder template, Anda dapat menggunakan perintah ini:

    Set-Location -Path templates

Menginstal Bicep CLI

Untuk menggunakan Bicep dari Azure PowerShell, instal Bicep CLI.

Masuk ke Azure menggunakan Azure PowerShell

  1. Di terminal Visual Studio Code, jalankan perintah berikut:

    Connect-AzAccount

    Browser terbuka sehingga Anda dapat masuk ke akun Azure.

  2. Setelah masuk ke Azure, terminal menampilkan daftar langganan yang terkait dengan akun ini.

    Jika Anda telah mengaktifkan kotak pasir, langganan bernama Langganan Concierge akan ditampilkan. Gunakan kotak pasir tersebut untuk latihan yang tersisa.

  3. Tetapkan langganan default untuk semua perintah Azure PowerShell yang dijalankan dalam sesi ini.

    $context = Get-AzSubscription -SubscriptionName 'Concierge Subscription'
Set-AzContext $context

    Catatan

    Jika Anda telah menggunakan lebih dari satu kotak pasir baru-baru ini, terminal mungkin menampilkan lebih dari satu instans Langganan Concierge. Jika demikian, gunakan dua langkah berikutnya untuk menetapkan salah satunya sebagai langganan default. Jika perintah sebelumnya berhasil, dan hanya satu Langganan Concierge yang tercantum, lewati dua langkah berikutnya.

  4. Dapatkan ID langganan. Menjalankan perintah berikut akan mencantumkan langganan Anda dan ID mereka. Cari Concierge Subscription, lalu salin ID dari kolom kedua. Ini terlihat seperti cf49fbbc-217c-4eb6-9eb5-a6a6c68295a0.

    Get-AzSubscription

  5. Ubah langganan aktif Anda menjadi Langganan Concierge. Pastikan untuk mengganti {Your subscription ID} dengan ID yang telah Anda salin.

    $context = Get-AzSubscription -SubscriptionId {Your subscription ID}
Set-AzContext $context

Menetapkan grup sumber daya default

Anda dapat mengatur grup sumber daya default dan menghilangkan parameter dari perintah Azure PowerShell lainnya dalam latihan ini. Atur default ini ke grup sumber daya yang dibuat untuk Anda di lingkungan kotak pasir.

Set-AzDefault -ResourceGroupName <rgn>[sandbox resource group name]</rgn>

Menyebarkan templat ke Azure

Sebarkan templat ke Azure dengan menggunakan perintah Azure PowerShell berikut di terminal. Perintah dapat memakan waktu satu atau dua menit untuk diselesaikan, dan Anda akan melihat penyebaran yang berhasil. Jika Anda melihat peringatan tentang lokasi yang dikodekan secara permanen, Anda dapat mengabaikannya. Anda akan memperbaiki lokasi nanti di modul. Aman untuk melanjutkan dan penyebaran akan berhasil.

New-AzResourceGroupDeployment -TemplateFile main.bicep

Verifikasi penyebaran

Saat pertama kali menyebarkan templat Bicep, Anda mungkin ingin menggunakan portal Microsoft Azure untuk memverifikasi bahwa penyebaran telah berhasil selesai dan untuk memeriksa hasilnya.

  1. Buka portal Microsoft Azure dan pastikan Anda berada di langganan kotak pasir:

    1. Pilih avatar Anda di sudut kanan atas halaman.
    2. Lalu pilih Beralih direktori. Dalam daftar, pilih direktori Microsoft Learn Sandbox.

  2. Di panel sebelah kiri, pilih Grup sumber daya.

  3. Pilih [nama grup sumber daya kotak pasir].

  4. Di Gambaran Umum, Anda bisa melihat satu penyebaran telah berhasil. Anda mungkin perlu memperluas area Esensial untuk melihat penyebaran.

    Screenshot of the Azure portal interface for the resource group overview, with the deployments section showing that one succeeded.

  5. Pilih 1 Berhasil melihat detail penyebaran.

    Screenshot of the Azure portal interface for the deployments, with the one deployment listed and a succeeded status.

  6. Pilih penyebaran yang disebut utama untuk melihat sumber daya mana yang disebarkan, lalu pilih Detail penyebaran untuk memperluasnya. Dalam hal ini, ada satu akun penyimpanan dengan nama yang Anda tentukan.

    Screenshot of the Azure portal interface for the specific deployment, with one storage account resource listed.

  7. Biarkan halaman terbuka di browser Anda. Anda akan memeriksa penyebaran lagi.

Anda juga dapat memverifikasi penyebaran dari baris perintah. Untuk melakukannya, jalankan perintah Azure CLI berikut:

az deployment group list --output table

Anda juga dapat memverifikasi penyebaran dari baris perintah. Untuk melakukannya, jalankan perintah Azure PowerShell berikut:

Get-AzResourceGroupDeployment -ResourceGroupName <rgn>[sandbox resource group name]</rgn> | Format-Table

Menambahkan paket dan aplikasi App Service ke templat Bicep Anda

Di tugas sebelumnya, Anda telah mempelajari cara membuat templat yang berisi satu sumber daya dan menyebarkannya. Sekarang Anda siap untuk menyebarkan lebih banyak sumber daya, termasuk dependensi. Dalam tugas ini, Anda akan menambahkan paket dan aplikasi App Service ke templat Bicep.

  1. Dalam file main.bicep di Visual Studio Code, tambahkan kode berikut ke bagian bawah file:

    resource appServicePlan 'Microsoft.Web/serverFarms@2022-03-01' = {
  name: 'toy-product-launch-plan-starter'
  location: 'eastus'
  sku: {
    name: 'F1'
  }
}

resource appServiceApp 'Microsoft.Web/sites@2022-03-01' = {
  name: 'toy-product-launch-1'
  location: 'eastus'
  properties: {
    serverFarmId: appServicePlan.id
    httpsOnly: true
  }
}

  2. Perbarui nama aplikasi App Service dari toy-product-launch-1 menjadi sesuatu yang cenderung unik. Pastikan nama adalah 2 hingga 60 karakter dengan huruf besar dan kecil, angka, dan tanda hubung, dan tidak dimulai atau diakhapi dengan tanda hubung.

  3. Simpan perubahan pada file.

Menyebarkan templat Bicep yang diperbarui

Jalankan perintah Azure CLI berikut di terminal. Anda dapat mengabaikan peringatan tentang lokasi yang dikodekan secara permanen. Anda akan segera memperbaiki lokasi.

az deployment group create --template-file main.bicep

Jalankan perintah Azure PowerShell berikut di terminal. Anda dapat mengabaikan pesan peringatan tentang lokasi yang dikodekan secara permanen. Anda akan segera memperbaiki lokasi.

New-AzResourceGroupDeployment -TemplateFile main.bicep

Memeriksa penyebaran Anda

  1. Kembali ke portal Azure dan buka grup sumber daya Anda. Anda tetap bisa melihat satu penyebaran yang berhasil karena penyebaran menggunakan nama yang sama dengan penyebaran pertama.

  2. Pilih tautan 1 Berhasil.

  3. Pilih penyebaran utama, lalu pilih Detail penyebaran untuk memperluas daftar sumber daya yang disebarkan.

    Screenshot that shows the Azure portal interface for the specific deployment, with storage account and App Service resources listed.

  4. Perhatikan bahwa paket dan aplikasi App Service disebarkan.