Entender o ciclo de vida de um Blueprint do Azure
Importante
Em 11 de julho de 2026, o Blueprints (versão prévia) será preterido. Migre suas definições e atribuições de blueprint existentes para Especificações de Modelo e Pilhas de Implantação. Os artefatos de blueprint devem ser convertidos em modelos JSON do ARM ou arquivos Bicep usados para definir pilhas de implantação. Para saber como criar um artefato como um recurso do ARM, confira:
Como muitos recursos no Azure, um blueprint no Azure Blueprints tem um ciclo de vida típico e natural. Eles são criados, implantados e finalmente excluídos quando não forem mais necessários ou relevantes. O Azure Blueprints é compatível com operações de ciclo de vida padrão. Sendo assim, ele cria com base nelas para fornecer níveis de status adicionais que dão suporte a pipelines de implantação contínua e integração contínua comuns para as organizações que gerenciam a Infraestrutura como Código – um elemento fundamental em DevOps.
Para entender completamente um blueprint e os estágios, vamos abordar um ciclo de vida padrão:
- Criação e edição de um blueprint
- Publicar o blueprint
- Criação e edição de uma nova versão do blueprint
- Publicar uma nova versão do blueprint
- Exclusão de uma versão específica do blueprint
- Exclusão do blueprint
Criação e edição de um blueprint
Para criar um blueprint, adicione artefatos, salve a definição no grupo de gerenciamento ou no escopo da assinatura e forneça uma versão de nome exclusiva. O blueprint agora está no modo Rascunho e ainda não pode ser atribuído. Enquanto no modo Rascunho, ele pode continuar a ser atualizado e alterado.
Um blueprint nunca publicado no modo Rascunho exibe um ícone diferente na página Blueprint Definitions do que aqueles que foram Publicados. A Última Versão é exibida como Rascunho para esses blueprints nunca publicados.
Crie e edite um blueprint com o portal do Azure ou a API REST.
Publicar um blueprint
Depois que todas as alterações planejadas tiverem sido feitas em um blueprint no modo Draft, ele poderá ser Publicado e disponibilizado para atribuição. A versão Publicada do blueprint não pode ser alterada. Uma vez Publicado, o blueprint é exibido com um ícone diferente dos blueprints em Rascunho e exibirá o número de versão fornecido na coluna Última Versão.
Publique um blueprint com o portal do Azure ou a API REST.
Criação e edição de uma nova versão do blueprint
Uma versão publicada de um blueprint não pode ser alterada. No entanto, uma nova versão do blueprint pode ser adicionada ao blueprint existente e modificada conforme necessário. Faça alterações em um blueprint existente editando-o. Quando as novas alterações são salvas, o blueprint agora possui Alterações não publicadas. Essas alterações são uma nova versão Draft do blueprint.
Edite um blueprint com o portal do Azure.
Publicar uma nova versão do blueprint
Cada versão editada de um blueprint deve ser Publicado antes de poder ser atribuído. Quando Mudanças não publicadas foram feitas para um blueprint, mas não Publicado, o botão Publicar Blueprint está disponível na página de blueprint de edição. Se o botão não estiver visível, o blueprint já foi Publicado e não tem Alterações Não Publicadas.
Observação
Um único blueprint pode ter várias versões Publicadas que podem ser atribuídas a assinaturas.
Para publicar um blueprint com Alterações não publicadas, use as mesmas etapas para publicar um novo blueprint.
Exclusão de uma versão específica do blueprint
Cada versão de um blueprint é um objeto exclusivo que pode ser individualmente Publicado. Assim, cada versão de um blueprint também pode ser excluída. Excluir uma versão de um blueprint não tem nenhum impacto nas outras versões desse blueprint.
Observação
Não é possível excluir um blueprint com atribuições ativas. Exclua as atribuições primeiro e, em seguida, exclua a versão que você deseja remover.
Selecione Todos os serviços no painel esquerdo. Pesquise e selecione Blueprints.
Selecione Definições de blueprint na página à esquerda e use as opções de filtro para localizar o blueprint do qual você deseja excluir uma versão. Selecione-o para abrir a página de edição.
Selecione a guia Versões publicadas e localize a versão que você deseja excluir.
Clique com o botão direito do mouse na versão a ser excluída e selecione Excluir esta versão.
Exclusão do blueprint
O blueprint principal também pode ser excluído. Excluir o plano gráfico de núcleo também exclui todas as versões de especificações técnicas de especificações técnicas, incluindo ambas rascunho e publicado planos gráficos. Assim como na exclusão de uma versão de um blueprint, a exclusão do blueprint principal não remove as atribuições existentes das versões dos blueprints.
Observação
Não é possível excluir um blueprint com atribuições ativas. Exclua as atribuições primeiro e, em seguida, exclua a versão que você deseja remover.
Exclua um blueprint com o portal do Azure ou a API REST.
Atribuições
Há vários pontos durante o ciclo de vida em que um blueprint pode ser atribuído a uma assinatura. Quando o modo de uma versão do blueprint é Publicado, essa versão pode ser atribuída a uma assinatura. Esse ciclo de vida permite que versões de um blueprint sejam usadas e atribuídas ativamente enquanto uma versão mais nova está sendo desenvolvida.
Como as versões de blueprints são atribuídas, é importante entender o local em que elas estão atribuídas e com quais parâmetros elas foram atribuídas. Os parâmetros podem ser estáticos ou dinâmicos. Para obter mais informações, confira parâmetros estáticos e dinâmicos.
Atualizando atribuições
Quando um blueprint é atribuído, a atribuição pode ser atualizada. Há vários motivos para atualizar uma atribuição existente, como:
- Adicionar ou remover um bloqueio de recurso
- Alterar o valor de parâmetros dinâmicos
- Atualizar a atribuição para uma versão Publicada mais recente do blueprint
Para saber como, confira atualizar atribuições existentes.
Cancelando atribuições
Se o blueprint não for mais necessário, sua atribuição do grupo de gerenciamento ou da assinatura poderá ser cancelada. Durante o cancelamento da atribuição do blueprint, ocorre o seguinte:
- Remoção do bloqueio de recursos do blueprint
- Exclusão do objeto de atribuição de blueprint
- (Condicional) Se uma identidade gerenciada atribuída pelo sistema foi usada, ela também será excluída
Observação
Todos os recursos implantados pela atribuição de blueprint permanecem em vigor, mas não serão mais protegidos pelo Azure Blueprints.
Próximas etapas
- 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.
- Saiba como atualizar atribuições existentes.
- Resolver problemas durante a atribuição de blueprint com solução de problemas gerais.