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

Önemli

Azure Blueprints (Önizleme) 31 Ocak 2027'de kullanımdan kaldırılacak ve 31 Temmuz 2026'da aşamalı kullanımdan kaldırılacaktır. Mevcut şema tanımlarınızı ve atamalarınızı Dağıtım Yığınlarına (önerilen) ve Şablon Belirtimlerine 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ülür. Aşamalı zaman çizelgesinin tamamı, etkiler ve SSS için Azure Blueprints'in kullanımdan kaldırılması sayfasına veya https://aka.ms/AzureBlueprintsRetirement bakın. Bir 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:

  • Abonelik düzeyindeki rol atama öğeleri, öğe adına göre sıralandı
  • Abonelik seviyesindeki politika atanması yapıtları yapıt adına göre sıralanıyor.
  • Abonelik düzeyi ARM şablonları (Azure Resource Manager şablonları) nesneleri 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, bu kaynak grubu içinde oluşturulacak yapıtlar için aşağıdaki sıra sırası kullanılır:

  • Kaynak grubuna ait rol atama ögeleri, öge adına göre sıralanmış
  • Kaynak grubuna ait alt politika atanımı öğeleri, öğe adına göre sıralanmıştır.
  • Artefakt adlarına göre sıralanmış kaynak grubu içindeki Azure Resource Manager şablonu (ARM şablonları) nesneleri

Uyarı

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.

Uyarı

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

Örnek - sıralı kaynak grubu

Bu örnek plan tanımında, dependsOn için bir değer belirterek özel bir sıralama sırası tanımlayan bir kaynak grubu ve standart bir kaynak grubu bulunmaktadır. 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. ARM şablonundan önce varsayılan sıralama ile bir ilke artifaktı 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ğımlı olmak üzere 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"
        }
    }
}

Beni 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 değişiklik yapılmaz. Örnek olarak abonelik düzeyi ilkesine bağlı olan bir kaynak grubu yer alır. Başka bir örnek, 'standard-rg' alt rol ataması kaynak grubuna bağlı 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

  • Last updated on