Aracılığıyla paylaş

Azure Blueprints'teki dağıtım sırasını anlama

  • Makale

Önemli

11 Temmuz 2026'da Blueprints (Önizleme) kullanım dışı bırakılacaktır. Mevcut şema tanımlarınızı ve atamalarınızı Şablon Belirtimleri ve Dağıtım Yığınları'na geçirin. Şema yapıtları, dağıtım yığınlarını tanımlamak için kullanılan ARM JSON şablonlarına veya Bicep dosyalarına dönüştürülecek. Yapıtı ARM kaynağı olarak yazmayı öğrenmek için bkz:

Azure Blueprints, şema tanımının atamasını işlerken kaynak oluşturma sırasını belirlemek için bir sıralama sırası kullanır. Bu makalede aşağıdaki kavramlar açıklanmaktadır:

  • Kullanılan varsayılan sıralama sırası
  • Siparişi özelleştirme
  • Özelleştirilmiş sipariş nasıl işlenir?

JSON örneklerinde kendi değerlerinizle değiştirmeniz gereken değişkenler vardır:

  • {YourMG} - Yönetim grubunuzun adıyla değiştirin

Varsayılan sıralama sırası

Şema tanımı, yapıtları dağıtma sırası için yönerge içermiyorsa veya yönerge null ise, aşağıdaki sıra kullanılır:

  • Yapıt adına göre sıralanmış abonelik düzeyi rol atama yapıtları
  • Yapıt adına göre sıralanmış abonelik düzeyi ilke atama yapıtları
  • Abonelik düzeyi Azure Resource Manager şablonu (ARM şablonları) yapıtları yapıt adına göre sıralanmış
  • Yer tutucu adına göre sıralanmış kaynak grubu yapıtları (alt yapıtlar dahil)

Her kaynak grubu yapıtı içinde, yapıtların bu kaynak grubu içinde oluşturulması için aşağıdaki sıra sırası kullanılır:

  • Kaynak grubu alt rol atama yapıtları yapıt adına göre sıralanmış
  • Kaynak grubu alt ilke atama yapıtları yapıt adına göre sıralanmış
  • Yapıt adına göre sıralanmış kaynak grubu alt Azure Resource Manager şablonu (ARM şablonları) yapıtları

Not

Artifacts() kullanımı, başvurulan yapıta örtük bir bağımlılık oluşturur.

Sıralama sırasını özelleştirme

Büyük şema tanımları oluştururken, kaynakların belirli bir sırada oluşturulması gerekebilir. Bu senaryonun en yaygın kullanım düzeni, şema tanımının birkaç ARM şablonu içermesidir. Azure Blueprints, sıralama sırasının tanımlanmasına izin vererek bu düzeni işler.

Sıralama, JSON'da bir dependsOn özellik tanımlanarak gerçekleştirilir. Kaynak grupları ve yapıt nesneleri için şema tanımı bu özelliği destekler. dependsOn , belirli bir yapıtın oluşturulmadan önce oluşturulması gereken yapıt adlarından oluşan bir dize dizisidir.

Not

Şema nesneleri oluştururken, powershell kullanılıyorsa her yapıt kaynağı adını dosya adından veya REST API kullanıyorsa URL uç noktasından alır. yapıtlardaki resourceGroup başvuruları şema tanımında tanımlananlarla eşleşmelidir.

Örnek - sıralı kaynak grubu

Bu örnek şema tanımı, için bir değer dependsOnve standart bir kaynak grubu bildirerek özel bir sıralama sırası tanımlamış bir kaynak grubuna sahiptir. Bu durumda assignPolicyTags adlı yapıt , ordered-rg kaynak grubundan önce işlenir. standard-rg varsayılan sıralama sırasına göre işlenir.

{
    "properties": {
        "description": "Example blueprint with custom sequencing order",
        "resourceGroups": {
            "ordered-rg": {
                "dependsOn": [
                    "assignPolicyTags"
                ],
                "metadata": {
                    "description": "Resource Group that waits for 'assignPolicyTags' creation"
                }
            },
            "standard-rg": {
                "metadata": {
                    "description": "Resource Group that follows the standard sequence ordering"
                }
            }
        },
        "targetScope": "subscription"
    },
    "type": "Microsoft.Blueprint/blueprints"
}

Örnek - özel sıralı yapıt

Bu örnek, ARM şablonuna bağlı bir ilke yapıtıdır. Varsayılan olarak, ARM şablonundan önce bir ilke yapıtı oluşturulur. Bu sıralama, ilke yapıtının ARM şablonunun oluşturulmasını beklemesini sağlar.

{
    "properties": {
        "displayName": "Assigns an identifying tag",
        "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/2a0e14a6-b0a6-4fab-991a-187a4f81c498",
        "resourceGroup": "standard-rg",
        "dependsOn": [
            "customTemplate"
        ]
    },
    "kind": "policyAssignment",
    "type": "Microsoft.Blueprint/artifacts"
}

Örnek - kaynak grubuna bağlı olarak abonelik düzeyi şablon yapıtı

Bu örnek, bir kaynak grubuna bağlı olarak abonelik düzeyinde dağıtılan arm şablonuna yöneliktir. Varsayılan sıralamada abonelik düzeyi yapıtları, bu kaynak gruplarındaki tüm kaynak gruplarından ve alt yapıtlardan önce oluşturulur. Kaynak grubu şema tanımında şöyle tanımlanır:

"resourceGroups": {
    "wait-for-me": {
        "metadata": {
            "description": "Resource Group that is deployed prior to the subscription level template artifact"
        }
    }
}

Bekleme kaynak grubuna bağlı olarak abonelik düzeyi şablon yapıtı şu şekilde tanımlanır:

{
    "properties": {
        "template": {
            ...
        },
        "parameters": {
            ...
        },
        "dependsOn": ["wait-for-me"],
        "displayName": "SubLevelTemplate",
        "description": ""
    },
    "kind": "template",
    "type": "Microsoft.Blueprint/blueprints/artifacts"
}

Özelleştirilmiş sırayı işleme

Oluşturma işlemi sırasında, şema yapıtlarının bağımlılık grafiğini oluşturmak için topolojik bir sıralama kullanılır. Denetim, kaynak grupları ve yapıtlar arasındaki her bağımlılık düzeyinin desteklendiğinden emin olur.

Varsayılan sırayı değiştirmeyecek bir yapıt bağımlılığı bildirilirse hiçbir değişiklik yapılmaz. Örnek olarak abonelik düzeyi ilkesine bağımlı olan bir kaynak grubu verilmiştir. Başka bir örnek, 'standard-rg' alt rol ataması kaynak grubuna bağımlı olan 'standard-rg' alt ilke atamasıdır. Her iki durumda da varsayılan dependsOn sıralama sırası değiştirilmez ve hiçbir değişiklik yapılmaz.

Sonraki adımlar