Bagikan melalui

Menggunakan dan menggunakan pernyataan tidak ada

Deklarasi using atau using none harus ada di semua file parameter Bicep.

File parameter Bicep biasanya menggunakan using pernyataan untuk mengikat file ke file Bicep, templat JSON Azure Resource Manager (templat ARM), modul Bicep, atau spesifikasi templat. Tautan ini memungkinkan server bahasa Bicep dan pengkompilasi untuk memvalidasi pemeriksaan file parameter untuk nama, jenis, dan nilai yang diperlukan yang benar berdasarkan input templat.

Sebaliknya, using none pernyataan secara eksplisit menunjukkan bahwa file parameter tidak terkait dengan templat tertentu pada waktu kompilasi. Ini berarti parameter tidak divalidasi terhadap templat tertentu dan sebaliknya ditujukan untuk penggunaan yang lebih umum seperti digunakan oleh alat eksternal atau berfungsi sebagai set parameter bersama yang dapat digunakan kembali.

Catatan

File parameter Bicep hanya didukung di Bicep CLI versi 0.18.4 atau yang lebih baru, Azure CLI versi 2.47.0 atau yang lebih baru, dan Azure PowerShell versi 9.7.1 atau yang lebih baru. Fitur using none ini didukung di Bicep CLI versi 0.31.0 atau yang lebih baru.

Untuk menggunakan pernyataan dengan templat JSON ARM, modul Bicep, dan spesifikasi templat, Anda harus memiliki Bicep CLI versi 0.22.6 atau yang lebih baru dan Azure CLI versi 2.53.0 atau yang lebih baru.

Pernyataan penggunaan

Sintaks pernyataan using:

  • Untuk menggunakan file Bicep:

    using '<path>/<file-name>.bicep'

  • Untuk menggunakan templat JSON ARM:

    using '<path>/<file-name>.json'

  • Untuk menggunakan modul publik:

    using 'br/public:<file-path>:<tag>'

    Contohnya:

    using 'br/public:avm/res/storage/storage-account:0.9.0' 

param name = 'mystorage'

  • Untuk menggunakan modul privat:

    using 'br:<acr-name>.azurecr.io/bicep/<file-path>:<tag>'

    Contohnya:

    using 'br:myacr.azurecr.io/bicep/modules/storage:v1'

    Untuk menggunakan modul privat dengan alias yang ditentukan dalam file bicepconfig.json:

    using 'br/<alias>:<file>:<tag>'

    Contohnya:

    using 'br/storageModule:storage:v1'

  • Untuk menggunakan spesifikasi templat:

    using 'ts:<subscription-id>/<resource-group-name>/<template-spec-name>:<tag>

    Contohnya:

    using 'ts:00000000-0000-0000-0000-000000000000/myResourceGroup/storageSpec:1.0'

    Untuk menggunakan spesifikasi templat dengan alias yang ditentukan dalam file bicepconfig.json:

    using 'ts/<alias>:<template-spec-name>:<tag>'

    Contohnya:

    using 'ts/myStorage:storageSpec:1.0'

Menggunakan pernyataan tidak ada

Pernyataan using none dalam file parameter Bicep (.bicepparam) menunjukkan bahwa file tidak terkait dengan templat Bicep tertentu selama penulisan atau kompilasi. Ini memisahkan file parameter dari templat tertentu, memungkinkan fleksibilitas yang lebih besar dalam bagaimana parameter ditentukan dan digunakan di seluruh penyebaran.

Sintaks pernyataan using none:

using none

Pernyataan ini ditempatkan di awal file parameter Bicep untuk memberi sinyal bahwa tidak ada templat tertentu yang dirujuk.

Manfaat using none utama dalam Bicep terletak pada skenario di mana file parameter digeneralisasi, dibagikan, atau terintegrasi secara dinamis dengan templat. Kasus penggunaan umum meliputi:

  • Repositori Parameter Terpusat

    Organisasi sering mempertahankan nilai parameter standar, seperti wilayah default, konvensi penamaan, atau tag global, yang digunakan secara konsisten dalam beberapa implementasi Bicep. Menggunakan file parameter Bicep tanpa salah satu parameter dapat bertindak sebagai penyimpanan terpusat untuk nilai-nilai bersama ini, meningkatkan konsistensi dan meminimalkan duplikasi. Parameter ini kemudian dapat digabungkan secara terprogram dengan nilai khusus templat pada waktu penyebaran.

    File parameter Bicep yang digunakan bersama mungkin menentukan, misalnya:

    using none

param location = 'westus2'
param environmentTag = 'production'
param projectName = 'myApp'

  • Pembuatan Dinamis dan Integrasi Runtime

    Dalam alur CI/CD atau skrip otomatisasi, file parameter dapat dibuat dengan cepat atau dikaitkan dengan templat saat runtime. Dengan menghilangkan referensi templat tetap, using none memungkinkan file-file ini untuk tetap fleksibel dan dapat disesuaikan dengan konteks penyebaran yang berbeda.

Ketika using none ditentukan dalam file parameter Bicep, pengkompilasi tidak memvalidasi parameter terhadap templat Bicep tertentu, yang berarti tidak ada peringatan atau kesalahan waktu kompilasi yang dimunculkan untuk nama atau jenis yang tidak cocok karena tidak adanya templat yang ditautkan. Namun, pemisahan ini hanya berlaku selama penulisan dan kompilasi pada waktu penyebaran, Azure Resource Manager (ARM) masih memerlukan templat Bicep dan file parameter. Mesin ARM melakukan validasi selama penyebaran dengan menyelesaikan parameter dalam file terhadap yang ditentukan dalam templat target.

Langkah berikutnya

  • Last updated on