Importar e exportar definições do blueprint com o PowerShell

Os Azure Blueprints podem ser totalmente gerenciados por meio de portal do Azure. À medida que as organizações avançam em seu uso do Azure Blueprints, elas devem começar a pensar em definições de blueprint como código gerenciado. Esse conceito é geralmente chamado de infraestrutura como código (IaC). Tratar suas definições de blueprint como código oferece vantagens adicionais além do que portal do Azure oferece. Esses benefícios incluem:

• Compartilhar definições de blueprint
• Fazendo backup de suas definições de blueprint
• Reutilizando definições de blueprint em diferentes locatários ou assinaturas
• Colocando as definições do blueprint no controle do código-fonte
  • Teste automatizado de definições do blueprint em ambientes de teste
  • Suporte dos componentes principais de CI/CD (integração contínua e implantação contínua)

Seja qual for o seu motivo, gerencie suas definições de blueprint como código tem benefícios. Este artigo mostra como usar os comandos Import-AzBlueprintWithArtifact e Export-AzBlueprintWithArtifact no módulo AZ. Blueprint.

Pré-requisitos

Este artigo pressupõe um conhecimento de trabalho moderado do Azure Blueprints. Se você ainda não tiver feito isso, trabalhe nos seguintes artigos:

• Criar um blueprint no portal
• Leia sobre os estágios de implantação e o ciclo de vida do blueprint
• Criando e Gerenciando definições e atribuições do blueprint com o PowerShell

Se ainda não estiver instalado, siga as instruções em Adicionar o módulo Az.Blueprint para instalar e validar o módulo Az.Blueprint na Galeria do PowerShell.

Estrutura de pastas de uma definição de blueprint

Antes de examinar a exportação e a importação de plantas, vejamos como os arquivos que compõem a definição do blueprint são estruturados. Uma definição de blueprint deve ser armazenada em sua própria pasta.

Juntamente com a definição de blueprint, que deve ser nomeada blueprint.json, estão os artefatos dos quais a definição de blueprint é composta. Cada artefato deve estar na subpasta chamada artifacts. Em conjunto, a estrutura de sua definição de blueprint como arquivos JSON em pastas deve ter a seguinte aparência:

.
|
|- MyBlueprint/  _______________ # Root folder name becomes default name of blueprint definition
|  |- blueprint.json  __________ # The blueprint definition. Fixed name.
|
|  |- artifacts/  ______________ # Subfolder for all blueprint artifacts. Fixed name.
|     |- artifact.json  ________ # Blueprint artifact as JSON file. Artifact named from file.
|     |- ...
|     |- more-artifacts.json

Exportar sua definição de blueprint

As etapas para exportar sua definição de blueprint são simples. Exportar a definição de blueprint pode ser útil para compartilhamento, backup ou colocação no controle do código-fonte.

• Blueprint [obrigatório]
  • Descreve a definição do Blueprint
  • Use Get-AzBlueprint para obter o objeto de referência
• OutputPath [obrigatório]
  • Especifica o caminho para salvar os arquivos JSON de definição de blueprint em
  • Os arquivos de saída estão em uma subpasta com o nome da definição de blueprint
• Versão (opcional)
  • Especifica a versão de saída se o objeto de referência Blueprint contiver referências a mais de uma versão.

1. Obter uma referência à definição de blueprint a ser exportada da assinatura representada como {subId}:

   # Login first with Connect-AzAccount if not using Cloud Shell
   
   # Get version '1.1' of the blueprint definition in the specified subscription
   $bpDefinition = Get-AzBlueprint -SubscriptionId '{subId}' -Name 'MyBlueprint' -Version '1.1'
   

2. Use o Export-AzBlueprintWithArtifact cmdlet para exportar a definição de blueprint especificada:

   Export-AzBlueprintWithArtifact -Blueprint $bpDefinition -OutputPath 'C:\Blueprints'
   

Importar sua definição de blueprint

Depois de ter uma definição de blueprint exportada ou ter uma definição de blueprint criada manualmente na estrutura de pastas necessária, você poderá importar essa definição de blueprint para um grupo de gerenciamento ou assinatura diferente.

Para exemplos de definições de blueprint interno, confira o repositório do GitHub do Azure Blueprints.

• Nome [obrigatório]
  • Especifica o nome da nova definição de blueprint
• InputPath [obrigatório]
  • Especifica o caminho de onde criar a definição de blueprint
  • Deve corresponder à estrutura de pastas necessária
• ManagementGroupId (optional)
  • A ID do grupo de gerenciamento para salvar a definição de plano gráfico se não for o padrão de contexto atual
  • ManagementGroupId ou SubscriptionId devem ser especificados
• SubscriptionId (opcional)
  • A ID da assinatura para salvar a definição do plano gráfico se não for o padrão de contexto atual
  • ManagementGroupId ou SubscriptionId devem ser especificados

1. Use o Import-AzBlueprintWithArtifact cmdlet para exportar a definição de blueprint especificada:

   # Login first with Connect-AzAccount if not using Cloud Shell
   
   Import-AzBlueprintWithArtifact -Name 'MyBlueprint' -ManagementGroupId 'DevMG' -InputPath 'C:\Blueprints\MyBlueprint'
   

Depois que a definição do Blueprint for importada, atribua-a com o PowerShell.

Para obter informações sobre como criar definições de blueprint avançadas, consulte os seguintes artigos:

• Use parâmetros estáticos e dinâmicos.
• Personalize a ordem de sequenciamento de blueprint.
• Proteger implantações com o bloqueio de recursos do blueprint.
• Gerenciar blueprints como código.

Próximas etapas

• Saiba mais sobre o ciclo de vida do blueprint.
• Saiba como usar parâmetros estáticos e dinâmicos.
• Saiba como personalizar a ordem de sequenciamento de blueprint.
• Saiba como usar o bloqueio de recurso de blueprint.
• Resolver problemas durante a atribuição de blueprint com solução de problemas gerais.