Migrovat blueprinty do stacků nasazení

Important

Azure Blueprints (Preview) bude vyřazena z provozu 31. ledna 2027, přičemž postupné vyřazování začne 31. července 2026. Migrujte své stávající definice a přiřazení Blueprintů do Deployment Stacks (doporučeno) a Template Specs. Artefakty blueprintu jsou převedeny na šablony ARM JSON nebo soubory Bicep, které se používají k definování zásobníků nasazení. Kompletní harmonogram jednotlivých fází, dopad a nejčastější dotazy viz vyřazení Azure Blueprints nebo https://aka.ms/AzureBlueprintsRetirement. Informace o tom, jak vytvořit artefakt jako zdroj ARM, najdete zde:

Tento článek vysvětluje, jak převést definice a přiřazení podrobného plánu na zásobníky nasazení. Zásobníky nasazení jsou nové nástroje v rámci oboru názvů Microsoft.Resources, které do této oblasti přinášejí funkce Azure Blueprint.

Kroky migrace

  1. Exportujte definice plánu do souborů JSON s definicemi plánu, které obsahují artefakty zásad Azure, přiřazení rolí Azure a šablony. Další informace najdete v tématu Export definice podrobného plánu.

  2. Převeďte soubory JSON s definicí podrobného plánu do jedné šablony ARM nebo souboru Bicep určených k nasazení pomocí zásobníků nasazení s ohledem na následující skutečnosti:

    • Přiřazení rolí: Převeďte všechna přiřazení rolí.
    • Zásady: Převeďte všechna přiřazení zásad na syntaxi Bicep (nebo šablony JSON ARM) a pak je přidejte do hlavní šablony. Můžete také vložit prvek policyDefinitions do šablony JSON.
    • Šablony: Převeďte všechny šablony do jedné hlavní šablony k odeslání do stacku nasazení. Můžete použít moduly v Bicep, vkládat šablony jako vnořené šablony nebo odkazy šablon a volitelně použít specifikace šablon k uložení šablon v Azure. Specifikace šablon nejsou pro použití zásobníků nasazení vyžadovány.
    • Zámky: Zásobník nasazení DenySettingsMode vám umožňuje blokovat nežádoucí změny prostřednictvím DenySettingsMode (podobně jako zámky Blueprintu). Můžete je nakonfigurovat pomocí Azure CLI nebo Azure PowerShellu. K tomu potřebujete odpovídající role, abyste mohli nastavit nastavení zamítnutí. Další informace najdete v tématu Zásobníky nasazení.

  3. Volitelně můžete vytvořit specifikace šablon pro převedené šablony ARM nebo soubory Bicep. Specifikace šablon umožňují ukládat šablony a jejich verze ve vašem prostředí Azure, což zjednodušuje sdílení šablon ve vaší organizaci. Zásobníky nasazení umožňují nasadit definice specifikací šablon nebo šablony ARM či soubory Bicep do zadaného cílového rozsahu.

Vzorek

Následující soubor Bicep je ukázkový soubor migrace.

targetScope = 'subscription'

param roleAssignmentName string = 'myTestRoleAssignment'
param roleDefinitionId string = guid(roleAssignmentName)
param principalId string = guid('myTestId')

param policyAssignmentName string = 'myTestPolicyAssignment'
param policyDefinitionID string = '/providers/Microsoft.Authorization/policyDefinitions/06a78e20-9358-41c9-923c-fb736d382a4d'

param rgName string = 'myTestRg'
param rgLocation string = deployment().location
param templateSpecName string = 'myNetworkingTs'

// Step 1 - create role assignments
resource roleAssignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(roleAssignmentName)
  properties: {
    principalId: principalId
    roleDefinitionId: roleDefinitionId
  }
}

// Step 2 - create policy assignments
resource policyAssignment 'Microsoft.Authorization/policyAssignments@2025-03-01' = {
    name: policyAssignmentName
    scope: subscriptionResourceId('Microsoft.Resources/resourceGroups', resourceGroup().name)
    properties: {
        policyDefinitionId: policyDefinitionID
    }
}

// Step 3 - create template artifacts via modules (or template specs)
resource rg1 'Microsoft.Resources/resourceGroups@2025-04-01' = {
  name: rgName
  location: rgLocation
}

module vnet 'templates/bicep/vnet.bicep' = if (rgName == 'myTestRg') {
  name: uniqueString(rgName)
  scope: rg1
  params: { location: rgLocation }
}

Migrujte na specifikace šablon

Pokud chcete převedené šablony v Azure ukládat a verzovat, místo abyste je nasazovali přímo, publikujte je jako specifikace šablon a nasaďte specifikaci šablony pomocí zásobníku nasazení. Specifikace šablon nahrazují roli úložiště artefaktů a správy verzí, kterou poskytuje definice podrobného plánu. Podrobné pokyny najdete v tématu Migrace Azure Blueprints do specifikací šablony.

Další kroky

  • Last updated on