Aracılığıyla paylaş

None deyimlerini kullanma ve kullanma

Bir using veya bir using none bildirim tüm Bicep parametre dosyalarında mevcut olmalıdır.

Bicep parametre dosyası genellikle dosyayı using dosyasına, JSON Azure Resource Manager şablonuna (ARM şablonu), Bicep modülüne veya şablon belirtimine bağlamak için deyimini kullanır. Bu bağlantı, Bicep dil sunucusunun ve derleyicinin şablonun girişlerine göre doğru adlar, türler ve gerekli değerler için parametre dosya denetimini doğrulamasını sağlar.

Buna karşılık, using none deyimi parametre dosyasının derleme zamanında belirli bir şablona bağlı olmadığını açıkça belirtir. Bu, parametrelerin belirli bir şablonda doğrulanmadığı ve bunun yerine dış araçlar tarafından kullanılması veya paylaşılan, yeniden kullanılabilir parametre kümeleri olarak hizmet verme gibi daha genel kullanıma yönelik olduğu anlamına gelir.

Not

Bicep parametre dosyaları yalnızca Bicep CLI sürüm 0.18.4 veya üzeri, Azure CLI sürüm 2.47.0 veya üzeri ve Azure PowerShell sürüm 9.7.1 veya sonraki sürümlerde desteklenir. Bu using none özellik , Bicep CLI sürüm 0.31.0 veya sonraki sürümlerde desteklenir.

deyimini JSON ARM şablonları, Bicep modülleri ve şablon belirtimleriyle kullanmak için Bicep CLI sürüm 0.22.6 veya üzeri ve Azure CLI sürüm 2.53.0 veya sonraki bir sürümüne sahip olmanız gerekir.

using deyimi

İfadenin using söz dizimi:

  • Bicep dosyalarını kullanmak için:

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

  • JSON ARM şablonlarını kullanmak için:

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

  • Genel modülleri kullanmak için:

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

    Örneğin:

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

param name = 'mystorage'

  • Özel modülleri kullanmak için:

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

    Örneğin:

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

    bicepconfig.json dosyasında tanımlanan diğer adla özel modül kullanmak için:

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

    Örneğin:

    using 'br/storageModule:storage:v1'

  • Şablon belirtimlerini kullanmak için:

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

    Örneğin:

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

    bicepconfig.json dosyasında tanımlanan diğer adla bir şablon belirtimi kullanmak için:

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

    Örneğin:

    using 'ts/myStorage:storageSpec:1.0'

using none ifadesi

using none Bicep parametre dosyasındaki (.bicepparam) deyimi, yazma veya derleme sırasında dosyanın belirli bir Bicep şablonuna bağlı olmadığını gösterir. Bu, parametre dosyasını belirli bir şablondan ayırır ve parametrelerin dağıtımlar arasında nasıl tanımlandığı ve kullanıldığı konusunda daha fazla esneklik sağlar.

İfadenin using none söz dizimi:

using none

Bu ifade, belirli bir şablona başvurulmadığını belirtmek için Bicep parametre dosyasının başına yerleştirilir.

Bicep'in birincil avantajı, parametre dosyalarının using none genelleştirildiği, paylaşıldığı veya şablonlarla dinamik olarak tümleştirildiği senaryolardadır. Yaygın kullanım örnekleri şunlardır:

  • Merkezi Parametre Depoları

    Kuruluşlar genellikle birden çok Bicep dağıtımında kullanılan varsayılan bölgeler, adlandırma kuralları veya genel etiketler gibi standart parametre değerlerini korur. "none kullanarak oluşturulan bir Bicep parameters file, bu paylaşılan değerler için merkezi bir depo işlevi görebilir, tutarlılığı artırır ve yinelemeyi en aza indirir." Bu parametreler daha sonra program aracılığıyla dağıtım zamanında şablona özgü değerlerle birleştirilebilir.

    Örneğin, paylaşılan bir Bicep parametre dosyası şunları tanımlayabilir:

    using none

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

  • Dinamik Oluşturma ve Çalışma Zamanı Tümleştirmesi

    CI/CD işlem hatlarında veya otomasyon betiklerinde, parametre dosyaları anında oluşturulabilir veya çalışma zamanında şablonlarla ilişkilendirilebilir. Sabit şablon başvurularını atlayarak bu using none dosyaların esnek ve farklı dağıtım bağlamlarına uyarlanabilir kalmasını sağlar.

using none Bicep parametre dosyasında belirtildiğinde, derleyici parametreleri belirli bir Bicep şablonuna göre doğrulamaz; başka bir deyişle, bağlı şablonun olmaması nedeniyle eşleşmeyen adlar veya türler için derleme zamanı uyarıları veya hataları tetiklenmez. Ancak bu ayırma yalnızca dağıtım zamanında yazma ve derleme sırasında geçerlidir. Azure Resource Manager (ARM) için hem Bicep şablonu hem de parametre dosyası gerekir. ARM altyapısı, dosyadaki parametreleri hedef şablonda tanımlanan parametrelere göre çözümleyerek dağıtım sırasında doğrulama gerçekleştirir.

Sonraki adımlar

  • Last updated on