Bagikan melalui

Menyebarkan file Bicep dengan Visual Studio Code

Anda dapat menggunakan Visual Studio Code dengan ekstensi Bicep untuk menyebarkan file Bicep. Ekstensi Bicep menyediakan dua opsi untuk menyebarkan file Bicep di Visual Studio Code - Panel Penyebaran dan Perintah Sebarkan. Kemampuan umpan balik cepat, validasi, dan kemampuan simulasi atau skenario 'bagaimana jika' dari Panel Penyebaran berguna untuk iterasi cepat saat penulisan, sedangkan Perintah Sebarkan berguna untuk pengalaman penyebaran fire-and-forget.

Panel Penyebaran

Panel penyebaran menyediakan UI interaktif di VS Code yang dapat mengakses akun Azure Anda untuk melakukan operasi validasi, penyebaran, dan what-if, memberikan umpan balik instan tanpa meninggalkan editor.

Untuk menggunakan panel penyebaran:

  1. Buka file .bicep atau .bicepparam di Visual Studio Code.

  2. Ada dua cara untuk membuka panel penyebaran:

    • Pilih tombol perlihatkan panel penyebaran di sudut kanan atas seperti yang diperlihatkan dalam cuplikan layar berikut:

      Cuplikan layar tombol pada panel penyebaran yang terbuka.

      Secara default, VS Code membuka panel penyebaran di sisi. Untuk membukanya di tab baru, tahan Alt sambil memilih tombol .

    • Cara lain untuk membuka panel penyebaran adalah melalui palet perintah. Tekan Ctrl+Shift+P, lalu pilih Perlihatkan Panel Penyebaran atau Perlihatkan Panel Penyebaran ke Samping.

      Cuplikan layar tampilan pane penyebaran di palet perintah.

    Panel penyebaran muncul seperti yang diperlihatkan dalam cuplikan layar berikut:

    Cuplikan layar panel penyebaran awal di Visual Studio Code.

  3. Pilih Pilih Cakupan untuk menentukan cakupan penyebaran. Setelah autentikasi, Anda dapat memilih langganan dan grup sumber daya penyebaran yang Anda inginkan.

  4. Jika panel penyebaran dibuka untuk file .bicep, isi nilai parameter yang Anda inginkan, atau pilih Pilih File Parameter JSON untuk memilih file parameter JSON.

    Cuplikan layar memilih file parameter di panel penyebaran di Visual Studio Code.

  5. Pilih tindakan yang Anda inginkan - Sebarkan, Validasi, atau Bagaimana-jika.

    • Sebarkan: menyebarkan ke Azure, dan hasilnya termasuk output yang ditentukan ditampilkan di panel penyebaran.

      Cuplikan layar berikut menunjukkan penyebaran yang berhasil. Anda dapat memilih ikon bola dunia biru untuk melihat penyebaran atau sumber daya individual di portal Microsoft Azure.

      Cuplikan layar panel penyebaran di Visual Studio Code.

    • Validasi: melakukan validasi runtime file Bicep terhadap Azure, memastikan bahwa sumber daya, parameter, dan kebijakan sudah benar di lingkungan penyebaran aktual. Tidak seperti linter, yang hanya melakukan validasi offline, validasi ini berinteraksi dengan Azure untuk mendeteksi potensi masalah penyebaran.

      Cuplikan layar berikut menunjukkan contoh kegagalan validasi.

      Cuplikan layar kesalahan validasi panel penyebaran di Visual Studio Code.

    • What-if: menjalankan analisis What-If langsung dari deployment pane. Panel menampilkan hasilnya, memperlihatkan perubahan yang direncanakan. Ini melakukan fungsi yang sama dengan perintah what-if di Azure PowerShell dan Azure CLI. Untuk informasi selengkapnya, lihat Operasi simulasi penyebaran Bicep

Anda dapat membuka panel penyebaran saat melakukan iterasi pada perubahan pada file .bicep atau .bicepparam Anda. Jika Anda menyimpan dan menjalankan ulang salah satu tindakan di atas, tindakan akan dijalankan pada file yang diperbarui.

Sebarkan Perintah

Anda dapat menyebarkan ke cakupan apa pun. Artikel ini memperlihatkan cara menyebarkan ke grup sumber daya.

Ada tiga cara untuk menemukan perintah dari file Bicep terbuka di Visual Studio Code:

  • Klik kanan nama file Bicep dari panel Explorer, bukan di bawah EDITOR TERBUKA:

    Cuplikan layar Menyebarkan File Bicep di menu Konteks dari panel penjelajah.

  • Klik kanan di mana saja di dalam file Bicep, lalu pilih Sebarkan File Bicep.

  • Pilih Palet Perintah dari menu Tampilan, lalu pilih Bicep: Sebarkan File Bicep.

    Cuplikan layar Sebarkan File Bicep File di menu Konteks.

Setelah Anda memilih perintah, ikuti wizard untuk memasukkan nilai:

  1. Jika Anda tidak masuk, ikuti instruksi yang diberikan dalam pesan untuk menyelesaikan proses masuk.

    Cuplikan layar masuk.

    Nota

    Perintah penyebaran Bicep di Visual Studio Code menggunakan API autentikasi bawaan baru untuk mengelola autentikasi. Ini tidak menggunakan profil cloud dari bicepconfig.json. Untuk masuk ke cloud kustom, pilih Kelola>Pengaturan>Ekstensi>Akun Microsoft>Microsoft Sovereign Cloud. Saat ini, beberapa akun yang sedang aktif tidak bisa didukung.

  2. Pilih atau buat grup sumber daya.

  3. Pilih file parameter atau Tidak Ada untuk memasukkan nilai untuk parameter:

    Cuplikan layar pilih file parameter.

  4. Jika Anda memilih Tidak Ada, masukkan nilai untuk parameter:

    Cuplikan layar Masukkan nilai parameter.

    Setelah memasukkan nilai, Anda memiliki opsi untuk membuat file parameter dari nilai yang digunakan dalam penyebaran ini:

    Cuplikan layar dari pembuatan file parameter.

    Jika Anda memilih Ya, file parameter bernama <Bicep-file-name>.parameters.json dibuat di folder yang sama.

Lihat Membuat file Bicep dengan Visual Studio Code untuk informasi selengkapnya tentang perintah Visual Studio Code dan cara menggunakan Visual Studio Code untuk membuat file Bicep.

Langkah selanjutnya

  • Last updated on