Dağıtım yığınları

Azure dağıtım yığını, bir grup Azure kaynağını tek ve uyumlu bir birim olarak yönetmenizi sağlayan bir kaynaktır. Dağıtım yığınına bir Bicep dosyası veya ARM JSON şablonu gönderdiğinizde, yığının yönettiği kaynakları tanımlar. Şablona daha önce dahil edilen bir kaynak kaldırılırsa, dağıtım yığınının belirtilen actionOnUnmanage davranışına göre ayrılır veya silinir. Dağıtım yığınına erişim, diğer Azure kaynaklarına benzer şekilde Azure rol tabanlı erişim denetimi (Azure RBAC) kullanılarak kısıtlanabilir.

Dağıtım yığını oluşturmak ve güncelleştirmek için Azure CLI, Azure PowerShell veya Azure portalını Bicep dosyalarıyla birlikte kullanabilirsiniz. Bu Bicep dosyaları ARM JSON şablonlarına dönüştürülür ve daha sonra yığın tarafından dağıtım nesnesi olarak dağıtılır. Dağıtım yığını, tanıdık dağıtım kaynaklarının ötesinde ek özellikler sunar ve bu özelliklerin üst kümesi olarak hizmet eder.

Microsoft.Resources/deploymentStacks dağıtım yığınları için kaynak türüdür. Tanımladığı kaynaklarda kapsamlar arasında 1-çok güncelleştirmeler gerçekleştirebilen ve bu kaynaklarda istenmeyen değişiklikleri engelleyebilecek bir ana şablondan oluşur.

Dağıtımınızı planlarken ve hangi kaynak gruplarının aynı yığının parçası olması gerektiğini belirlerken, bu kaynakların oluşturma, güncelleştirme ve silme gibi yönetim yaşam döngüsünü göz önünde bulundurmanız önemlidir. Örneğin, farklı kaynak grubu kapsamlarında çeşitli uygulama ekipleri için bazı test sanal makineleri (VM) sağlamanız gerektiğini varsayalım. Bu durumda, bu test ortamlarını oluşturmak ve sonraki dağıtım yığını güncelleştirmeleri aracılığıyla test VM yapılandırmalarını güncelleştirmek için bir dağıtım yığını kullanılabilir. Projeyi tamamladıktan sonra, test VM'leri gibi oluşturulan kaynakları kaldırmak veya silmek gerekebilir. Dağıtım yığını kullanılarak, uygun silme bayrağı belirtilerek yönetilen kaynaklar kolayca kaldırılabilir. Bu kolaylaştırılmış yaklaşım, çeşitli kaynak grubu kapsamlarında her test VM'sini ayrı ayrı değiştirmek veya kaldırmak yerine yığın kaynağında tek bir güncelleştirme içerdiğinden, ortam temizleme sırasında zaman kazandırır.

Dağıtım yığınları Için Azure PowerShell sürüm 12.0.0 veya üzeri ya da Azure CLI sürüm 2.61.0 veya üzeri gerekir.

İlk dağıtım yığınınızı oluşturmak için Hızlı Başlangıç: dağıtım yığını oluşturma konusunu inceleyin.

Dağıtım yığınları neden kullanılır?

Dağıtım yığınları aşağıdaki avantajları sağlar:

• Farklı kapsamlardaki kaynakların birleşik varlık olarak kolaylaştırılmış sağlama ve yönetimi.
• Reddetme ayarları aracılığıyla yönetilen kaynaklarda istenmeyen değişikliklerin önlenmesi.
• Dağıtım yığını güncelleştirmeleri sırasında silme bayraklarını kullanarak verimli ortam temizleme.
• Dağıtım yığınlarınız için Bicep, ARM şablonları veya Şablon belirtimleri gibi standart şablonların kullanımı.

Bilinen sınırlamalar

• Örtük olarak oluşturulan kaynaklar dağıtım yığını tarafından yönetilmez. Bu nedenle, reddetme atamaları veya temizleme mümkün değildir.
• Reddetme atamaları etiketleri desteklemez.
• Reddetme atamaları yönetim grubu kapsamında desteklenmez. Ancak, dağıtım abonelik kapsamına işaret edilirse bir yönetim grubu yığınında desteklenirler.
• Dağıtım yığınları Anahtar kasası gizli dizilerini silemez. Şablondan anahtar kasası gizli dizilerini kaldırıyorsanız ayırma moduyla dağıtım yığını güncelleştirme/silme komutunu da yürüttüğünizden emin olun.

Bilinen sorunlar

• Kaynak gruplarının silinmesi şu anda reddetme atamalarını atlar. Kaynak grubu kapsamında bir dağıtım yığını oluştururken, Bicep dosyası kaynak grubunun tanımını içermez. Deny-assignment ayarına rağmen kaynak grubunu ve içerdiği yığını silmek mümkündür. Ancak, grup içindeki herhangi bir kaynakta bir kilit etkinse silme işlemi başarısız olur.
• What-if desteği henüz kullanılamıyor.
• Yönetim grubu kapsamlı yığının başka bir yönetim grubuna dağıtılması kısıtlanmıştır. Yalnızca yığının yönetim grubuna veya bir alt aboneliğe dağıtılabilir.
• PowerShell komutu, anahtar için ActionOnUnmanage bir DeleteResourcesAndResourcesGroups değer listeler. Bu değer kullanıldığında, komut yönetilen kaynakları ve kaynak gruplarını ayırır. Bu değer sonraki güncelleştirmede kaldırılacaktır. Bu değeri kullanmayın.
• Bazı durumlarda, Azure PowerShell'in Yeni ve Ayarla cmdlet'leri açıkça eyleme dönüştürülemeyen genel bir şablon doğrulama hatası döndürebilir. Bu hata bir sonraki sürümde düzeltilecektir, ancak şimdilik hata belirsizse, ham yanıtta daha ayrıntılı bir hata görmek için cmdlet'i hata ayıklama modunda çalıştırabilirsiniz.
• Dağıtım yığınları Microsoft Graph sağlayıcısı tarafından desteklenmez.

Yerleşik roller

Uyarı

Microsoft.Resources/deploymentStacks/manageDenySetting/action RBAC izninin uygulanması, Kamu Bulutları da dahil olmak üzere bölgeler arasında dağıtılır.

Dağıtım yığını için iki yerleşik rol vardır:

• Azure Dağıtım Yığını Katkıda Bulunanı: Kullanıcıların dağıtım yığınlarını yönetmesine izin verir, ancak dağıtım yığınları içinde reddetme atamaları oluşturamaz veya silemez.
• Azure Dağıtım Yığını Sahibi: Kullanıcıların reddetme atamaları olanlar da dahil olmak üzere dağıtım yığınlarını yönetmesine olanak tanır.

Dağıtım yığınları oluşturma

Bir dağıtım yığını kaynağı kaynak grubu, abonelik veya yönetim grubu kapsamında oluşturulabilir. Dağıtım yığınına geçirilen şablon, şablon dağıtımı için belirtilen hedef kapsamda oluşturulacak veya güncelleştirilecek kaynakları tanımlar.

• Kaynak grubu kapsamındaki bir yığın, geçirilen şablonu dağıtım yığınının bulunduğu kaynak grubu kapsamına dağıtabilir.
• Abonelik kapsamındaki bir yığın, geçirilen şablonu bir kaynak grubu kapsamına (belirtilmişse) veya dağıtım yığınının bulunduğu abonelik kapsamına dağıtabilir.
• Yönetim grubu kapsamındaki bir yığın, geçirilen şablonu belirtilen abonelik kapsamına dağıtabilir.

Dağıtım yığınının bulunduğu yeri, reddetme ayarları özelliğiyle oluşturulan reddetme atamasının da olduğunu unutmayın. Örneğin, şablonu kaynak grubu kapsamına dağıtan ve reddetme ayarları moduyla DenyDeleteabonelik kapsamında bir dağıtım yığını oluşturarak, yönetilen kaynakları belirtilen kaynak grubuna kolayca sağlayabilir ve bu kaynaklara yönelik silme girişimlerini engelleyebilirsiniz. Bu yaklaşımı kullanarak, dağıtım yığınını kaynak grubu düzeyinden farklı olarak abonelik düzeyinde ayırarak da güvenliği artırırsınız. Bu ayrım, sağlanan kaynaklarla çalışan geliştirici ekiplerinin yalnızca kaynak gruplarına görünürlük ve yazma erişimine sahip olmasını sağlarken, dağıtım yığını daha yüksek bir düzeyde yalıtılmış durumda kalır. Bu, dağıtım yığınını düzenleyebilen ve reddetme ataması üzerinde değişiklik yapabilen kullanıcı sayısını en aza indirir. Daha fazla bilgi için bkz . Yönetilen kaynağı silinmeye karşı koruma.

Create-stack komutları, dağıtım yığınlarını güncelleştirmek için de kullanılabilir.

Kaynak grubu kapsamında bir dağıtım yığını oluşturmak için:

PowerShell

New-AzResourceGroupDeploymentStack `
  -Name "<deployment-stack-name>" `
  -ResourceGroupName "<resource-group-name>" `
  -TemplateFile "<bicep-file-name>" `
  -ActionOnUnmanage "detachAll" `
  -DenySettingsMode "none"

CLI

az stack group create \
  --name '<deployment-stack-name>' \
  --resource-group '<resource-group-name>' \
  --template-file '<bicep-file-name>' \
  --action-on-unmanage 'detachAll'
  --deny-settings-mode 'none'

Portal

Henüz uygulanmadı.

Abonelik kapsamında bir dağıtım yığını oluşturmak için:

PowerShell

New-AzSubscriptionDeploymentStack `
  -Name "<deployment-stack-name>" `
  -Location "<location>" `
  -TemplateFile "<bicep-file-name>" `
  -DeploymentResourceGroupName "<resource-group-name>" `
  -ActionOnUnmanage "detachAll" `
  -DenySettingsMode "none"

parametresi, DeploymentResourceGroupName yönetilen kaynakları depolamak için kullanılan kaynak grubunu belirtir. Parametresi belirtilmezse, yönetilen kaynaklar abonelik kapsamında depolanır.

CLI

az stack sub create \
  --name '<deployment-stack-name>' \
  --location '<location>' \
  --template-file '<bicep-file-name>' \
  --deployment-resource-group' <resource-group-name>' \
  --action-on-unmanage 'detachAll' \
  --deny-settings-mode 'none'

parametresi, deployment-resource-group yönetilen kaynakları depolamak için kullanılan kaynak grubunu belirtir. Parametresi belirtilmezse, yönetilen kaynaklar abonelik kapsamında depolanır.

Portal

Henüz uygulanmadı.

Yönetim grubu kapsamında bir dağıtım yığını oluşturmak için:

PowerShell

New-AzManagementGroupDeploymentStack `
  -Name "<deployment-stack-name>" `
  -Location "<location>" `
  -TemplateFile "<bicep-file-name>" `
  -DeploymentSubscriptionId "<subscription-id>" `
  -ActionOnUnmanage "detachAll" `
  -DenySettingsMode "none"

parametresi, deploymentSubscriptionId yönetilen kaynakları depolamak için kullanılan aboneliği belirtir. Parametre belirtilmezse, yönetilen kaynaklar yönetim grubu kapsamında depolanır.

CLI

az stack mg create \
  --name '<deployment-stack-name>' \
  --location '<location>' \
  --template-file '<bicep-file-name>' \
  --deployment-subscription '<subscription-id>' \
  --action-on-unmanage 'detachAll' \
  --deny-settings-mode 'none'

parametresi, deployment-subscription yönetilen kaynakları depolamak için kullanılan aboneliği belirtir. Parametre belirtilmezse, yönetilen kaynaklar yönetim grubu kapsamında depolanır.

Portal

Henüz uygulanmadı.

Dağıtım yığınlarını listeleme

Dağıtım yığını kaynaklarını kaynak grubu kapsamında listelemek için:

PowerShell

Get-AzResourceGroupDeploymentStack `
  -ResourceGroupName "<resource-group-name>"

CLI

az stack group list \
  --resource-group '<resource-group-name>'

Portal

1. Azure portalından dağıtım yığınlarını içeren kaynak grubunu açın.

2. Sol menüden kaynak grubuna dağıtılan dağıtım yığınlarını listelemek için öğesini seçin Deployment stacks .

   

Dağıtım yığını kaynaklarını abonelik kapsamında listelemek için:

PowerShell

Get-AzSubscriptionDeploymentStack

CLI

az stack sub list

Portal

1. Azure portalından dağıtım yığınlarını içeren aboneliği açın.

2. Sol menüden, aboneliğe dağıtılan dağıtım yığınlarını listelemek için öğesini seçin Deployment stacks .

   

Dağıtım yığını kaynaklarını yönetim grubu kapsamında listelemek için:

PowerShell

Get-AzManagementGroupDeploymentStack `
  -ManagementGroupId "<management-group-id>"

CLI

az stack mg list \
  --management-group-id '<management-group-id>'

Portal

Henüz uygulanmadı.

Dağıtım yığınlarını güncelleştirme

Yönetilen kaynak eklemeyi veya silmeyi içerebilen bir dağıtım yığınını güncelleştirmek için, temel alınan Bicep dosyalarında değişiklik yapmanız gerekir. Değişiklikler yapıldıktan sonra dağıtım yığınını güncelleştirmek için iki seçeneğiniz vardır: update komutunu çalıştırın veya create komutunu yeniden çalıştırın.

Yönetilen kaynakların listesi, kod olarak altyapı (IaC) tasarım deseni aracılığıyla tam olarak denetlenebilir.

Ayarla komutunu kullanma

Kaynak grubu kapsamındaki bir dağıtım yığınını güncelleştirmek için:

PowerShell

Set-AzResourceGroupDeploymentStack `
  -Name "<deployment-stack-name>" `
  -ResourceGroupName "<resource-group-name>" `
  -TemplateFile "<bicep-file-name>" `
  -ActionOnUnmanage "detachAll" `
  -DenySettingsMode "none"

CLI

az stack group create \
  --name '<deployment-stack-name>' \
  --resource-group '<resource-group-name>' \
  --template-file '<bicep-file-name>' \
  --action-on-unmanage 'detachAll' \
  --deny-settings-mode 'none'

Not

Azure CLI'da dağıtım yığını kümesi komutu yoktur. Bunun yerine Yeni komutunu kullanın.

Portal

Henüz uygulanmadı.

Abonelik kapsamındaki bir dağıtım yığınını güncelleştirmek için:

PowerShell

Set-AzSubscriptionDeploymentStack `
  -Name "<deployment-stack-name>" `
  -Location "<location>" `
  -TemplateFile "<bicep-file-name>" `
  -DeploymentResourceGroupName "<resource-group-name>" `
  -ActionOnUnmanage "detachAll" `
  -DenySettingsMode "none"

parametresi, DeploymentResourceGroupName dağıtım yığını kaynaklarını depolamak için kullanılan kaynak grubunu belirtir. Kaynak grubu adı belirtmezseniz dağıtım yığını hizmeti sizin için yeni bir kaynak grubu oluşturur.

CLI

az stack sub create \
  --name '<deployment-stack-name>' \
  --location '<location>' \
  --template-file '<bicep-file-name>' \
  --deployment-resource-group '<resource-group-name>' \
  --action-on-unmanage 'detachAll' \
  --deny-settings-mode 'none'

Portal

Henüz uygulanmadı.

Yönetim grubu kapsamında bir dağıtım yığınını güncelleştirmek için:

PowerShell

Set-AzManagementGroupDeploymentStack `
  -Name "<deployment-stack-name>" `
  -Location "<location>" `
  -TemplateFile "<bicep-file-name>" `
  -DeploymentSubscriptionId "<subscription-id>" `
  -ActionOnUnmanage "detachAll" `
  -DenySettingsMode "none"

CLI

az stack mg create \
  --name '<deployment-stack-name>' \
  --location '<location>' \
  --template-file '<bicep-file-name>' \
  --deployment-subscription '<subscription-id>' \
  --action-on-unmanage 'detachAll' \
  --deny-settings-mode 'none'

Portal

Henüz uygulanmadı.

Yeni komutunu kullanma

Aşağıdakine benzer bir uyarı alırsınız:

The deployment stack 'myStack' you're trying to create already exists in the current subscription/management group/resource group. Do you want to overwrite it? Detaching: resources, resourceGroups (Y/N)

Daha fazla bilgi için bkz . Dağıtım yığınları oluşturma.

Ayırmayı ve silmeyi denetleme

Ayrılmış kaynak (veya yönetilmeyen kaynak), dağıtım yığını tarafından izlenmeyen veya yönetilmeyen ancak Azure'da hala var olan bir kaynağı ifade eder.

Azure'a yönetilmeyen kaynakları silmesini bildirmek için yığını aşağıdaki anahtarla yığın oluştur komutuyla güncelleştirin. Daha fazla bilgi için bkz . Dağıtım yığını oluşturma.

PowerShell

ActionOnUnmanage Bir yığın güncelleştirildikten veya silindikten sonra artık yönetilmeyen kaynaklara ne olacağını tanımlamak için anahtarını kullanın. İzin verilen değerler şunlardır:

• deleteAll: yönetilen kaynaklar ve kaynak grupları için ayırmak yerine silmeyi kullanın.
• deleteResources: yalnızca yönetilen kaynaklar için ayırmak yerine silmeyi kullanın.
• detachAll: Yönetilen kaynakları ve kaynak gruplarını ayırma.

Örneğin:

New-AzSubscriptionDeploymentStack `
  -Name "<deployment-stack-name" `
  -TemplateFile "<bicep-file-name>" `
  -DenySettingsMode "none" `
  -ActionOnUnmanage "deleteAll" 

CLI

action-on-unmanage Bir yığın güncelleştirildikten veya silindikten sonra artık yönetilmeyen kaynaklara ne olacağını tanımlamak için anahtarını kullanın. İzin verilen değerler şunlardır:

• deleteAll: yönetilen kaynaklar ve kaynak grupları için ayırmak yerine silmeyi kullanın.
• deleteResources: yalnızca yönetilen kaynaklar için ayırmak yerine silmeyi kullanın.
• detachAll: Yönetilen kaynakları ve kaynak gruplarını ayırma.

Örneğin:

az stack sub create `
  --name '<deployment-stack-name>' `
  --location '<location>' `
  --template-file '<bicep-file-name>' `
  --action-on-unmanage 'deleteAll' `
  --deny-settings-mode 'none' 

Portal

Henüz uygulanmadı.

Uyarı

Yönetilmeyen eylem anahtarı olarak ayarlanmış DeleteAllkaynak gruplarını silerken, yönetilen kaynak grupları ve bunların içindeki tüm kaynaklar da silinir.

Eşitleme dışı yığın hatasını işleme

Dağıtım yığınını güncelleştirirken veya silerken, yığın kaynak listesinin doğru eşitlenmediğini belirten aşağıdaki eşitleme dışı yığın hatasıyla karşılaşabilirsiniz.

The deployment stack '{0}' may not have an accurate list of managed resources. To ensure no resources are accidentally deleted, please check that the managed resource list does not have any additional values. If there is any uncertainty, we recommend redeploying the stack with the same template and parameters as the current iteration. To bypass this warning, please specify the 'BypassStackOutOfSyncError' flag.

Azure portalından kaynakların listesini alabilir veya şu anda dağıtılan Bicep dosyasını aynı parametrelerle yeniden dağıtabilirsiniz. Çıkışta yönetilen kaynaklar gösterilir

PowerShell

...
Resources: /subscriptions/9e8db52a-71bc-4871-9007-1117bf304622/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk
           /subscriptions/9e8db52a-71bc-4871-9007-1117bf304622/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk

CLI

"resources": [
  {
    "denyStatus": "none",
    "id": "/subscriptions/9e8db52a-71bc-4871-9007-1117bf304622/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk",
    "resourceGroup": "demoRg",
    "status": "managed"
  },
  {
    "denyStatus": "none",
    "id": "/subscriptions/9e8db52a-71bc-4871-9007-1117bf304622/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk",
    "resourceGroup": "demoRg",
    "status": "managed"
  }
]

Portal

1. Azure portalını açın.
2. Yığını içeren Kaynak grubunu açın.
3. Sol menüden Ayarlar'ı genişletin ve ardından Dağıtım yığınları'nı seçin.
4. Yığını açmak için yığın adını seçin.

Yığındaki kaynakların listesini gözden geçirip doğruladıktan sonra, komutu Azure PowerShell'de (veya bypass-stack-out-of-sync-error Azure CLI'da) anahtarla BypassStackOutOfSyncError yeniden çalıştırabilirsiniz. Bu anahtar yalnızca komutu yeniden çalıştırmadan önce yığındaki kaynakların listesini ayrıntılı bir şekilde gözden geçirdikten sonra kullanılmalıdır. Bu anahtar hiçbir zaman varsayılan olarak kullanılmamalıdır.

Dağıtım yığınlarını silme

PowerShell

anahtarı, ActionOnUnmanage artık yönetilmeyen kaynaklara eylemi tanımlar. Anahtar aşağıdaki değerlere sahiptir:

• DeleteAll: Hem kaynakları hem de kaynak gruplarını silin.
• DeleteResources: Yalnızca kaynakları silin.
• DetachAll: Kaynakları ayırma.

CLI

anahtarı, action-on-unmanage artık yönetilmeyen kaynaklara eylemi tanımlar. Anahtar aşağıdaki değerlere sahiptir:

• delete-all: Hem kaynakları hem de kaynak gruplarını silin.
• delete-resources: Yalnızca kaynakları silin.
• detach-all: Kaynakları ayırma.

Portal

Dağıtım yığınını sildiğinizde silme bayraklarından birini seçin.

Tümünü sil anahtarını belirtseniz bile, dağıtım yığınının bulunduğu kaynak grubu içindeki yönetilmeyen kaynaklar hem yönetilmeyen kaynakların hem de kaynak grubunun kendisinin silinmesini engeller.

Kaynak grubu kapsamındaki dağıtım yığını kaynaklarını silmek için:

PowerShell

Remove-AzResourceGroupDeploymentStack `
  -name "<deployment-stack-name>" `
  -ResourceGroupName "<resource-group-name>" `
  -ActionOnUnmanage "<deleteAll/deleteResources/detachAll>"

CLI

az stack group delete \
  --name '<deployment-stack-name>' \
  --resource-group '<resource-group-name>' \
  --action-on-unmanage '<deleteAll/deleteResources/detachAll>'

Portal

1. Azure portalından dağıtım yığınlarını içeren kaynak grubunu açın.

2. Sol menüden öğesini seçin Deployment stacks, silinecek dağıtım yığınını seçin ve ardından öğesini seçin Delete stack.

   

3. bir Update behaviorseçin ve ardından öğesini seçin Next.

   

Abonelik kapsamındaki dağıtım yığını kaynaklarını silmek için:

PowerShell

Remove-AzSubscriptionDeploymentStack `
  -Name "<deployment-stack-name>" `
  -ActionOnUnmanage "<deleteAll/deleteResources/detachAll>"

CLI

az stack sub delete \
  --name '<deployment-stack-name>' \
  --action-on-unmanage '<deleteAll/deleteResources/detachAll>'

Portal

1. Azure portalından dağıtım yığınlarını içeren aboneliği açın.

2. Sol menüden öğesini seçin Deployment stacks, silinecek dağıtım yığınını seçin ve ardından öğesini seçin Delete stack.

   

3. Bir Update behavior (silme bayrağı) seçin ve ardından öğesini seçin Next.

   

Yönetim grubu kapsamında dağıtım yığını kaynaklarını silmek için:

PowerShell

Remove-AzManagementGroupDeploymentStack `
  -Name "<deployment-stack-name>" `
  -ManagementGroupId "<management-group-id>" `
  -ActionOnUnmanage "<deleteAll/deleteResources/detachAll>"

CLI

az stack mg delete \
  --name '<deployment-stack-name>' \
  --management-group-id '<management-group-id>' \
  --action-on-unmanage '<deleteAll/deleteResources/detachAll>'

Portal

Henüz uygulanmadı.

Yönetilen kaynakları dağıtım yığınında görüntüleme

Dağıtım yığını hizmetinin henüz bir Azure portalı grafik kullanıcı arabirimi (GUI) yok. Dağıtım yığını içindeki yönetilen kaynakları görüntülemek için aşağıdaki Azure Powershell/Azure CLI komutlarını kullanın:

Yönetilen kaynakları kaynak grubu kapsamında görüntülemek için:

PowerShell

(Get-AzResourceGroupDeploymentStack -Name "<deployment-stack-name>" -ResourceGroupName "<resource-group-name>").Resources

CLI

az stack group list \
  --name '<deployment-stack-name>' \
  --resource-group '<resource-group-name>' \
  --output 'json'

Portal

1. Azure portalından dağıtım yığınlarını içeren kaynak grubunu açın.

2. Soldaki menüden öğesini seçin Deployment stacks.

   

3. Dağıtım yığınının yönetilen kaynaklarını görüntülemek için dağıtım yığınlarından birini seçin.

Yönetilen kaynakları abonelik kapsamında görüntülemek için:

PowerShell

(Get-AzSubscriptionDeploymentStack -Name "<deployment-stack-name>").Resources

CLI

az stack sub show \
  --name '<deployment-stack-name>' \
  --output 'json'

Portal

1. Azure portalından dağıtım yığınlarını içeren aboneliği açın.

2. Sol menüden, aboneliğe dağıtılan dağıtım yığınlarını listelemek için öğesini seçin Deployment stacks .

   

3. Yönetilen kaynakları listelemek için dağıtım yığınını seçin.

Yönetilen kaynakları yönetim grubu kapsamında görüntülemek için:

PowerShell

(Get-AzManagementGroupDeploymentStack -Name "<deployment-stack-name>" -ManagementGroupId "<management-group-id>").Resources

CLI

az stack mg show \
  --name '<deployment-stack-name>' \
  --management-group-id '<management-group-id>' \
  --output 'json'

Portal

Henüz uygulanmadı.

Dağıtım yığınına kaynak ekleme

Yönetilen kaynak eklemek için kaynak tanımını temel alınan Bicep dosyalarına ekleyin ve ardından update komutunu çalıştırın veya create komutunu yeniden çalıştırın. Daha fazla bilgi için bkz . Dağıtım yığınlarını güncelleştirme.

Yönetilen kaynakları dağıtım yığınından silme

Yönetilen bir kaynağı silmek için, temel alınan Bicep dosyalarından kaynak tanımını kaldırın ve ardından update komutunu çalıştırın veya create komutunu yeniden çalıştırın. Daha fazla bilgi için bkz . Dağıtım yığınlarını güncelleştirme.

Yönetilen kaynakları koruma

Yetkisiz güvenlik sorumlularının bunları silmesini veya güncelleştirmesini önlemek için dağıtım yığınının yönetilen kaynaklarına belirli izinler atayabilirsiniz. Bu izinler reddetme ayarları olarak adlandırılır. Yığınları üst kapsamda depolamak istiyorsunuz. Örneğin, bir abonelikteki kaynakları korumak için yığını, anında üst yönetim grubu olan üst kapsama yerleştirmeniz gerekir.

Reddetme ayarı yalnızca denetim düzlemi işlemleri için geçerlidir, veri düzlemi işlemleri için geçerli değildir. Örneğin, depolama hesapları ve anahtar kasaları denetim düzlemi aracılığıyla oluşturulur ve bunların bir dağıtım yığını tarafından yönetilmesine olanak tanır. Ancak, veri düzlemi aracılığıyla oluşturulan gizli diziler veya blob kapsayıcıları gibi alt kaynaklar bir dağıtım yığını tarafından yönetilemez.

Reddetme ayarı yalnızca açıkça oluşturulan kaynaklar için geçerlidir, örtük olarak oluşturulan kaynaklar için geçerli değildir. Örneğin, yönetilen aks kümesi bunu desteklemek için sanal makine gibi birden fazla hizmet oluşturur. Bu durumda, sanal makine Bicep dosyasında tanımlanmadığından ve örtük olarak oluşturulmuş bir kaynak olduğundan, dağıtım yığını reddetme ayarlarına tabi değildir.

Not

En son sürüm, aşağıdakiler için yığın kapsamında belirli izinler gerektirir:

• Dağıtım yığını oluşturun veya güncelleştirin ve reddetme ayarını dışında Nonebir değere yapılandırın.
• dışında Nonebir değerin mevcut reddetme ayarıyla dağıtım yığınını güncelleştirin veya silin.

İzinleri vermek için dağıtım yığını yerleşik rollerini kullanın.

PowerShell

Azure PowerShell, deny-assignment'ı özelleştirmek için şu parametreleri içerir:

• DenySettingsMode: Yönetilen kaynaklarda, bunları silmeye veya güncelleştirmeye çalışan yetkisiz güvenlik sorumlularına karşı koruma sağlamak için yasaklanan işlemleri tanımlar. Bu kısıtlama, açıkça erişim verilmediği sürece herkes için geçerlidir. Değerler şunlardır: None, DenyDeleteve DenyWriteAndDelete.
• DenySettingsApplyToChildScopes: Belirtildiğinde, reddetme ayarı modu yapılandırması yönetilen kaynakların alt kapsamı için de geçerlidir. Örneğin Bicep dosyası bir Microsoft.Sql/servers kaynağını (üst) ve Microsoft.Sql/servers/databases kaynağını (alt) tanımlar. Bicep dosyası DenySettingsApplyToChildScopes kullanılarak ayarı etkin ve DenySettingsMode ayarı olarak ayarlanmış DenyWriteAndDeletebir dağıtım yığını oluşturulursa, Microsoft.Sql/servers kaynağına veya Microsoft.Sql/servers/databases kaynağına ek alt kaynak ekleyemezsiniz.
• DenySettingsExcludedAction: Reddetme ayarlarından dışlanan rol tabanlı yönetim işlemlerinin listesi. En fazla 200 eyleme izin verilir.
• DenySettingsExcludedPrincipal: Kilit dışında tutulan Microsoft Entra asıl kimliklerinin listesi. En fazla beş sorumluya izin verilir.

CLI

Azure CLI, deny-assignment'ı özelleştirmek için şu parametreleri içerir:

• deny-settings-mode: Yönetilen kaynaklarda, bunları silmeye veya güncelleştirmeye çalışan yetkisiz güvenlik sorumlularına karşı koruma sağlamak için yasaklanan işlemleri tanımlar. Bu kısıtlama, açıkça erişim verilmediği sürece herkes için geçerlidir. Değerler şunlardır: none, denyDeleteve denyWriteAndDelete.
• deny-settings-apply-to-child-scopes: Belirtildiğinde, reddetme ayarı modu yapılandırması yönetilen kaynakların alt kapsamı için de geçerlidir. Örneğin Bicep dosyası bir Microsoft.Sql/servers kaynağını (üst) ve Microsoft.Sql/servers/databases kaynağını (alt) tanımlar. Bicep dosyası deny-settings-apply-to-child-scopes kullanılarak ayarı etkin ve deny-settings-mode ayarı olarak ayarlanmış denyWriteAndDeletebir dağıtım yığını oluşturulursa, Microsoft.Sql/servers kaynağına veya Microsoft.Sql/servers/databases kaynağına ek alt kaynak ekleyemezsiniz.
• deny-settings-excluded-actions: Reddetme ayarlarından dışlanan rol tabanlı erişim denetimi (RBAC) yönetim işlemlerinin listesi. En fazla 200 eyleme izin verilir.
• deny-settings-excluded-principals: Kilit dışında tutulan Microsoft Entra asıl kimliklerinin listesi. En fazla beş sorumluya izin verilir.

Portal

Henüz uygulanmadı.

Kaynak grubu kapsamında reddetme ayarlarını uygulamak için:

PowerShell

New-AzResourceGroupDeploymentStack `
  -Name "<deployment-stack-name>" `
  -ResourceGroupName "<resource-group-name>" `
  -TemplateFile "<bicep-file-name>" `
  -ActionOnUnmanage "detachAll" `
  -DenySettingsMode "denyDelete" `
  -DenySettingsExcludedAction "Microsoft.Compute/virtualMachines/write Microsoft.StorageAccounts/delete" `
  -DenySettingsExcludedPrincipal "<object-id>,<object-id>"

CLI

az stack group create \
  --name '<deployment-stack-name>' \
  --resource-group '<resource-group-name>' \
  --template-file '<bicep-file-name>' \
  --action-on-unmanage 'detachAll' \
  --deny-settings-mode 'denyDelete' \
  --deny-settings-excluded-actions 'Microsoft.Compute/virtualMachines/write Microsoft.StorageAccounts/delete' \
  --deny-settings-excluded-principals '<object-id> <object-id>'

Portal

Henüz uygulanmadı.

Abonelik kapsamında reddetme ayarlarını uygulamak için:

PowerShell

New-AzSubscriptionDeploymentStack `
  -Name "<deployment-stack-name>" `
  -Location "<location>" `
  -TemplateFile "<bicep-file-name>" `
  -ActionOnUnmanage "detachAll" `
  -DenySettingsMode "denyDelete" `
  -DenySettingsExcludedAction "Microsoft.Compute/virtualMachines/write Microsoft.StorageAccounts/delete" `
  -DenySettingsExcludedPrincipal "<object-id>,<object-id>"

Dağıtım yığınının DeploymentResourceGroupName oluşturulduğu kaynak grubu adını belirtmek için parametresini kullanın. Kapsam belirtilmezse dağıtım yığınının kapsamını kullanır.

CLI

az stack sub create \
  --name '<deployment-stack-name>' \
  --location '<location>' \
  --template-file '<bicep-file-name>' \
  --action-on-unmanage 'detachAll' \
  --deny-settings-mode 'denyDelete' \
  --deny-settings-excluded-actions 'Microsoft.Compute/virtualMachines/write Microsoft.StorageAccounts/delete' \
  --deny-settings-excluded-principals '<object-id> <object-id>'

Dağıtım yığınının deployment-resource-group oluşturulduğu kaynak grubunu belirtmek için parametresini kullanın. Kapsam belirtilmezse dağıtım yığınının kapsamını kullanır.

Portal

Henüz uygulanmadı.

Yönetim grubu kapsamında reddetme ayarlarını uygulamak için:

PowerShell

New-AzManagementGroupDeploymentStack `
  -Name "<deployment-stack-name>" `
  -Location "<location>" `
  -TemplateFile "<bicep-file-name>" `
  -ActionOnUnmanage "detachAll" `
  -DenySettingsMode "denyDelete" `
  -DenySettingsExcludedActions "Microsoft.Compute/virtualMachines/write Microsoft.StorageAccounts/delete" `
  -DenySettingsExcludedPrincipal "<object-id>,<object-id>"

Dağıtım yığınının DeploymentSubscriptionId oluşturulduğu abonelik kimliğini belirtmek için parametresini kullanın. Kapsam belirtilmezse dağıtım yığınının kapsamını kullanır.

CLI

az stack mg create \
  --name '<deployment-stack-name>' \
  --location '<location>' \
  --template-file '<bicep-file-name>' \
  --action-on-unmanage 'detachAll' \
  --deny-settings-mode 'denyDelete' \
  --deny-settings-excluded-actions 'Microsoft.Compute/virtualMachines/write Microsoft.StorageAccounts/delete' \
  --deny-settings-excluded-principals '<object-id> <object-id>'

Dağıtım yığınının deployment-subscription oluşturulduğu abonelik kimliğini belirtmek için parametresini kullanın. Kapsam belirtilmezse dağıtım yığınının kapsamını kullanır.

Portal

Henüz uygulanmadı.

Yönetilen kaynakları dağıtım yığınından ayırma

Varsayılan olarak, dağıtım yığınları artık yığının yönetim kapsamında yer almadığında yönetilmeyen kaynakları ayırır ve silmez. Daha fazla bilgi için bkz . Dağıtım yığınlarını güncelleştirme.

Şablonları dağıtım yığınlarından dışarı aktarma

Kaynakları bir dağıtım yığınından JSON çıkışına aktarabilirsiniz. Çıktıyı bir dosyaya aktarabilirsiniz.

Dağıtım yığınını kaynak grubu kapsamında dışarı aktarmak için:

PowerShell

Save-AzResourceGroupDeploymentStack `
   -Name "<deployment-stack-name>" `
   -ResourceGroupName "<resource-group-name>" `

CLI

az stack group export \
  --name '<deployment-stack-name>' \
  --resource-group '<resource-group-name>'

Portal

Henüz uygulanmadı.

Abonelik kapsamındaki bir dağıtım yığınını dışarı aktarmak için:

PowerShell

Save-AzSubscriptionDeploymentStack `
  -name "<deployment-stack-name>"

CLI

az stack sub export \
  --name '<deployment-stack-name>'

Portal

Henüz uygulanmadı.

Yönetim grubu kapsamında bir dağıtım yığınını dışarı aktarmak için:

PowerShell

Save-AzManagementGroupDeploymentStack `
  -Name "<deployment-stack-name>" `
  -ManagementGroupId "<management-group-id>"

CLI

az stack mg export \
  --name '<deployment-stack-name>' \
  --management-group-id '<management-group-id>'

Portal

Henüz uygulanmadı.

Sonraki adımlar

Hızlı bir başlangıç yapmak için bkz . Hızlı Başlangıç: dağıtım yığını oluşturma.