Latihan - Membuat registri

Selesai

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.

Sebelum Anda dapat menerbitkan modul Bicep untuk CDN dan situs web, Anda perlu membuat registri untuk organisasi Anda. Kemudian terbitkan modul bersama ke registri. Tim lain kemudian dapat membuat penyebaran yang menyertakan modul bersama.

Dalam latihan ini, Anda akan:

  • Sebarkan registri pribadi baru untuk digunakan oleh perusahaan mainan Anda.
  • Hubungkan ke registri Anda untuk memverifikasi bahwa modul berhasil dibuat.

Untuk menyebarkan sumber daya ke Azure, Anda harus masuk ke akun Azure Anda dari terminal Visual Studio Code. Pastikan Anda telah memasang Azure CLI, dan masuk menggunakan 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>"

Untuk menyebarkan sumber daya ke Azure, Anda harus masuk ke akun Azure Anda 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>

Membuat registri kontainer

Di sini, Anda membuat registri baru untuk menyimpan dan membagikan modul Bicep Anda. Contoh ini menggunakan Azure Container Registry.

  1. Pilih nama unik untuk registri kontainer Anda. Namanya harus unik secara global di seluruh Azure. Pilih salah satu yang panjangnya 5 hingga 50 karakter dan berisi huruf dan angka. Anda menggunakan nama dalam langkah-langkah berikutnya.

  2. Buat registri kontainer dengan menjalankan perintah ini di terminal Visual Studio Code. Ganti tempat penampung YOUR_CONTAINER_REGISTRY_NAME dengan nama yang Anda pilih di langkah sebelumnya.

    az acr create \
      --name YOUR_CONTAINER_REGISTRY_NAME \
      --sku Basic \
      --location westus
    

Tip

Anda juga dapat membuat registri kontainer dengan menggunakan Bicep. Dalam contoh ini, kami menggunakan Azure CLI agar lebih mudah.

  1. Pilih nama unik untuk registri kontainer Anda. Namanya harus unik secara global di seluruh Azure. Pilih salah satu yang panjangnya 5 hingga 50 karakter dan berisi huruf dan angka. Anda menggunakan nama dalam langkah-langkah berikutnya.

  2. Buat registri kontainer dengan menjalankan perintah ini di terminal Visual Studio Code. Ganti tempat penampung YOUR_CONTAINER_REGISTRY_NAME dengan nama yang Anda pilih di langkah sebelumnya.

    New-AzContainerRegistry `
      -Name YOUR_CONTAINER_REGISTRY_NAME `
      -Sku Basic `
      -Location westus
    

Tip

Anda juga dapat membuat registri kontainer dengan menggunakan Bicep. Dalam contoh ini, kami menggunakan cmdlet Azure PowerShell agar lebih mudah.

Mendaftarkan modul di registri Anda

Sekarang setelah Anda membuat registri, Anda dapat menghubungkannya untuk memverifikasi bahwa modul tersebut berfungsi.

  1. Daftarkan modul dalam registri dengan menjalankan perintah ini. Ganti tempat penampung YOUR_CONTAINER_REGISTRY_NAME dengan nama yang Anda pilih sebelumnya.

    az acr repository list \
      --name YOUR_CONTAINER_REGISTRY_NAME
    

    Perhatikan bahwa Anda tidak menentukan kredensial apa pun untuk terhubung ke registri kontainer. Azure CLI menggunakan kredensial yang sama yang Anda gunakan untuk masuk ke Azure CLI. Anda memiliki akses ke registri kontainer karena Anda yang membuatnya.

  2. Perintah Azure CLI mengembalikan daftar yang tidak berisi hasil:

    []
    

    Anda tidak melihat hasil karena Anda belum menerbitkan modul apa pun. Anda akan mempelajari lebih lanjut tentang menerbitkan modul di unit berikutnya.

  1. Daftarkan modul dalam registri dengan menjalankan perintah ini. Ganti tempat penampung YOUR_CONTAINER_REGISTRY_NAME dengan nama yang Anda pilih sebelumnya.

    Get-AzContainerRegistryRepository `
      -RegistryName YOUR_CONTAINER_REGISTRY_NAME
    

    Perhatikan bahwa Anda tidak menentukan kredensial apa pun untuk terhubung ke registri kontainer. Azure PowerShell menggunakan kredensial yang sama yang Anda gunakan untuk masuk ke cmdlet Azure PowerShell. Anda memiliki akses ke registri kontainer karena Anda yang membuatnya.

  2. Cmdlet Azure PowerShell tidak menunjukkan output.

    Belum ada hasil karena Anda belum menerbitkan modul apa pun. Anda mempelajari selengkapnya tentang menerbitkan modul di unit berikutnya.