İş boyutunun aşılmasıyla ilgili hataları düzeltme

Bu makalede ve DeploymentJobSizeExceededException hatalarının nasıl çözüleceğini JobSizeExceededException açıklanmaktadır. Bicep dosyası veya Azure Resource Manager şablonu (ARM şablonu) dağıttığınızda iş boyutu aşıldı hataları oluşabilir.

Belirti

Şablon dağıtırken, dağıtımın sınırları aştığını belirten bir hata alırsınız.

Nedeni

Dağıtım izin verilen sınırı aştığında bu hatayı alırsınız. Genellikle, şablonunuz veya dağıtımı çalıştıran iş çok büyük olduğunda bu hatayı görürsünüz.

Dağıtım işi 1 MB'ı aşamaz ve istekle ilgili meta verileri içerir. Büyük şablonlar için, şablonla birleştirilen meta veriler işin izin verilen boyutunu aşabilir.

Şablon 4 MB'ı aşamaz ve her kaynak tanımı 1 MB'ı aşamaz. Sınırlar, çok sayıda örnek oluşturmak için döngüleri kullanan kaynak tanımları için genişletildikten sonra şablonun son durumuna uygulanır. Son durum değişkenler ve parametreler için çözümlenen değerleri de içerir.

Diğer şablon sınırları şunlardır:

• 256 parametre
• 256 değişken
• 800 kaynak (kopya sayısı dahil)
• 64 çıkış değeri
• Şablon ifadesinde 24.576 karakter

Çözüm 1: Bağımlılıkları dikkatli kullanın

Bicep

Bir kaynak başka bir kaynağa sembolik adıyla başvurduğunda oluşturulan örtük bağımlılığı kullanın. Çoğu dağıtım için açık bir bağımlılık kullanmak dependsOn ve oluşturmak gerekmez.

JSON

Kaynakları dağıtmak için kopyalama döngülerini kullanırken, döngü adını bağımlılık olarak kullanmayın:

dependsOn: [ "nicLoop" ]

Bunun yerine, bağlı olmanız gereken döngüdeki kaynağın örneğini kullanın. Örnek:

dependsOn: [
    "[resourceId('Microsoft.Network/networkInterfaces', concat('nic-', copyIndex()))]"
]

Çözüm 2: Şablonu basitleştirme

Bicep

Dosyanız çok sayıda farklı kaynak türü dağıttığında, bunu modüllere bölmeyi göz önünde bulundurun. Kaynak türlerinizi mantıksal gruplara bölün ve her grup için bir modül ekleyin. Örneğin, çok sayıda ağ kaynağı dağıtmanız gerekiyorsa bu kaynakları bir modüle taşıyabilirsiniz.

Diğer kaynakları örtük bağımlılıklar olarak ayarlayabilir ve modüllerin çıkışından değerleri alabilirsiniz.

JSON

Şablonunuz çok sayıda farklı kaynak türü dağıttığında, bunu bağlantılı şablonlara bölmeyi göz önünde bulundurun. Kaynak türlerinizi mantıksal gruplara bölün ve her grup için bağlantılı bir şablon ekleyin. Örneğin, çok sayıda ağ kaynağı dağıtmanız gerekiyorsa, bu kaynakları bağlantılı bir şablona taşıyabilirsiniz.

Diğer kaynakları bağlı şablona bağımlı olarak ayarlayabilir ve bağlantılı şablonun çıkışından değerleri alabilirsiniz.

Çözüm 3: Ad boyutunu küçültme

Bicep

Parametreler, değişkenler ve çıkışlar için kullandığınız adların uzunluğunu kısaltmayı deneyin. Bu değerler döngüler halinde yinelendiğinde, uzun bir ad birçok kez çarpılır.

JSON

Parametreler, değişkenler ve çıkışlar için kullandığınız adların uzunluğunu kısaltmayı deneyin. Bu değerler kopyalama döngüleri aracılığıyla yinelendiğinde, uzun bir ad birçok kez çarpılır.