O que é o Azure Blueprints (versão prévia)?
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:
Assim como um blueprint permite que um engenheiro ou arquiteto desenhe os parâmetros de um projeto, o Azure Blueprints permite que arquitetos de nuvem e grupos centrais de tecnologia da informação definam um conjunto repetitivo de recursos do Azure que implementa e adere aos padrões, padrões e requisitos de uma organização. O Azure Blueprints permite que as equipes de desenvolvimento criem e iniciem novos ambientes rapidamente, sabendo que eles são criados de acordo com as especificações da organização e contêm um conjunto de componentes integrados, como redes, para acelerar o desenvolvimento e a entrega.
O Blueprints é uma maneira declarativa de orquestrar a implementação de vários modelos de recursos e outros artefatos, como:
- Atribuições de Funções
- Atribuições de Políticas
- Modelos do ARM (modelos do Azure Resource Manager)
- Grupos de recursos
O serviço do Azure BluePrint é apoiado pelo Azure Cosmos DB distribuído globalmente. Objetos de blueprint são replicados para várias regiões do Azure. Essa replicação oferece baixa latência, alta disponibilidade e acesso consistente a seus objetos de blueprint, independentemente de em qual região o Azure Blueprints implanta seus recursos.
Como ele difere dos modelos do ARM
O serviço foi projetado para ajudá-lo na configuração do ambiente. Essa configuração geralmente consiste em um conjunto de grupos de recursos, políticas, atribuições de função e implantações de modelo do ARM. Um blueprint é um pacote para reunir cada um desses artefatos e permitir que você componha e versione esse pacote, inclusive por meio de um pipeline de CI/CD (integração contínua e entrega contínua). Por fim, cada um é atribuído a uma assinatura em uma única operação que pode ser auditada e rastreada.
Quase tudo o que você deseja incluir na implantação no Azure Blueprints pode ser feito com um modelo do ARM. No entanto, um modelo do ARM é um documento que não existe nativamente no Azure. Cada um está armazenado localmente ou no controle do código-fonte ou no Modelos (versão prévia). O modelo é usado para implantações de um ou mais recursos do Azure, mas, quando esses recursos são implantados, não há relação ou conexão ativa com o modelo.
Com o Azure Blueprints, a relação entre a definição do blueprint (o que deve ser implantado) e a atribuição do blueprint (o que foi implantado) é preservada. Essa conexão dá suporte ao acompanhamento e à auditoria de implantações aprimorados. O Azure Blueprints também pode atualizar várias assinaturas ao mesmo tempo quando regidas pelo mesmo blueprint.
Não há necessidade de escolher entre um modelo ARM e um blueprint. Cada blueprint pode consistir em zero ou mais artefatos de modelo ARM. Esse suporte significa que os esforços anteriores para desenvolver e manter uma biblioteca de modelos do ARM podem ser reutilizados no Azure Blueprints.
Como ele difere do Azure Policy
Um blueprint é um pacote ou contêiner para composição de conjuntos específicos de foco de padrões, padrões e requisitos relacionados à implementação de serviços em nuvem, segurança e design do Azure que podem ser reutilizados para manter a consistência e a conformidade.
Uma política é uma permissão padrão e um sistema de negação explícito focado nas propriedades do recurso durante a implementação e para recursos já existentes. Ele dá suporte à governança de nuvem confirmando que os recursos dentro de uma assinatura estão cumprindo os requisitos e os padrões.
A inclusão de uma política em um blueprint permite a criação do padrão ou design correto durante a atribuição do blueprint. A inclusão da política faz com que apenas alterações aprovadas ou esperadas possam ocorrer no ambiente para proteger a conformidade com a intenção do blueprint.
Uma política pode ser incluída como um dos muitos artefatos em uma definição de blueprint. Os Blueprints também suportam o uso de parâmetros com políticas e iniciativas.
Definição de planta
Um blueprint é composto por artefatos. O Azure Blueprints atualmente dá suporte aos seguintes recursos como artefatos:
| Recurso | Opções de hierarquia | Descrição |
|---|---|---|
| Grupos de recursos | Subscription | Crie um novo grupo de recursos para uso por outros artefatos no blueprint. Esses grupos de recursos de espaço reservado permitem que você organize os recursos exatamente da maneira que você deseja que eles sejam estruturados e fornece um limitador de escopo para os artefatos de atribuição de políticas e funções incluídos, além dos modelos do ARM. |
| Modelo de ARM | Assinatura, Grupo de Recursos | Modelos, incluindo aninhados e vinculados, são usados para compor ambientes complexos. Ambientes de exemplo: um farm do SharePoint, uma configuração de estado da Automação do Azure ou um espaço de trabalho do Log Analytics. |
| Atribuição de política | Assinatura, Grupo de Recursos | Permite a atribuição de uma política ou iniciativa à assinatura a qual o blueprint está atribuído. A política ou iniciativa deve estar dentro do escopo do local de definição do blueprint. Se a política ou iniciativa tiver parâmetros, esses parâmetros serão atribuídos na criação do blueprint ou durante a atribuição do blueprint. |
| Atribuição de função | Assinatura, Grupo de Recursos | Adicione um usuário ou grupo existente a uma função interna para fazer com que as pessoas certas tenham sempre o acesso correto aos seus recursos. Atribuições de função podem ser definidas para a assinatura inteira ou aninhadas em um grupo de recursos específico incluído no blueprint. |
Observação
Cada artefato deve ter 2 MB ou menos. Se o artefato exceder 2 MB, você obterá um erro HTTP 500 (Erro Interno do Servidor).
Localizações de definição do blueprint
Ao criar uma definição de blueprint, você definirá onde o blueprint será salvo. Blueprints podem ser salvos em um grupo de gerenciamento ou assinatura ao qual você tenha acesso de Contribuidor. Se o local for um grupo de gerenciamento, o blueprint estará disponível para atribuir qualquer assinatura filho daquele grupo de gerenciamento.
Parâmetros de blueprint
Os blueprints podem passar parâmetros para uma política/iniciativa ou um modelo do ARM. Ao adicionar um artefato a um blueprint, o criador decide fornecer um valor definido para cada atribuição de blueprint ou permitir que cada atribuição de blueprint forneça um valor na hora da atribuição. Essa flexibilidade fornece a opção para definir um valor predeterminado para todos os usos do plano gráfico ou para habilitar essa decisão a ser feita no momento da atribuição.
Observação
Um plano gráfico pode ter seus próprios parâmetros, mas elas atualmente podem ser criado somente se um plano gráfico é gerado da API REST, em vez de por meio do Portal.
Para obter mais informações, consulte parâmetros de plano gráfico.
Especificações técnicas de publicação
Quando um plano gráfico é criado, ele é considerado para estar no modo rascunho. Quando estiver pronto para ser atribuído, ele precisa ser Publicado. A publicação requer a definição de uma cadeia de caracteres Versão (letras, números e hifens com um comprimento máximo de 20 caracteres) juntamente com a opção de Alterar anotações. A versão a diferencia de futuras alterações no mesmo blueprint e permite que cada versão seja atribuída. Esse controle de versão também significa que várias Versões do mesmo blueprint podem ser atribuídas à mesma assinatura. Quando há outras alterações no blueprint, a VersãoPublicada ainda existe, bem como as Alterações não publicadas. Depois que as alterações forem concluídas, o blueprint atualizado está publicado com uma nova e exclusiva versão e agora também podem ser atribuídos.
Atribuição de planta
Cada VersãoPublicada de um blueprint pode ser atribuída (com um tamanho de nome máximo de 90 caracteres) a uma assinatura ou um grupo de gerenciamento existente. No portal, o blueprint usará como padrão a Versão em vez do que foi Publicado mais recentemente. Se houver parâmetros de artefato ou de blueprint, eles serão definidos durante o processo de atribuição.
Observação
A atribuição de uma definição de blueprint a um grupo de gerenciamento significa que o objeto de atribuição existe no grupo de gerenciamento. A implantação de artefatos ainda é direcionada a uma assinatura. Para executar uma atribuição de grupo de gerenciamento, a API REST Criar ou Atualizar precisa ser usada e o corpo da solicitação precisa incluir um valor para properties.scope a fim de definir a assinatura de destino.
Permissões nos Blueprints do Azure
Para usar blueprints, você deverá receber permissões por meio do Azure RBAC (controle de acesso baseado em função). Para ler ou ver um blueprint no portal do Azure, sua conta deve ter acesso de leitura ao escopo no qual a definição do blueprint está localizada.
Para criar planos gráficos, sua conta precisa das seguintes permissões:
Microsoft.Blueprint/blueprints/write-Criar uma definição de plantaMicrosoft.Blueprint/blueprints/artifacts/write-Criar artefatos em uma definição de plantaMicrosoft.Blueprint/blueprints/versions/write-Publicar um plano gráfico
Para excluir os planos gráficos, sua conta precisa das seguintes permissões:
Microsoft.Blueprint/blueprints/deleteMicrosoft.Blueprint/blueprints/artifacts/deleteMicrosoft.Blueprint/blueprints/versions/delete
Observação
As permissões de definição de blueprint devem ser concedidas ou herdadas no escopo de assinatura ou do grupo de gerenciamento em que estão salvas.
Para atribuir ou desatribuir um plano gráfico, sua conta precisa das seguintes permissões:
Microsoft.Blueprint/blueprintAssignments/write-Atribuir um plano gráficoMicrosoft.Blueprint/blueprintAssignments/delete-Cancelar a atribuição de um plano gráfico
Observação
Como as atribuições de especificações técnicas são criadas em uma assinatura, atribua o plano gráfico e cancelar a atribuição de permissões devem ser concedidas em um escopo de assinatura ou ser herdadas para um escopo de assinatura.
As seguintes funções internas estão disponíveis:
| Função do Azure | Descrição |
|---|---|
| Proprietário | Além de outras permissões, inclui todas as permissões relacionadas ao Azure Blueprints. |
| Colaborador | Além de outras permissões, pode criar e excluir definições de blueprint, mas não tem permissões de atribuição de blueprint. |
| Colaborador do Blueprint | Pode gerenciar definições de blueprint, mas não as atribuir. |
| Operador do Blueprint | Pode atribuir blueprints publicados existentes, mas não pode criar definições de blueprint. A atribuição de blueprint só funcionará se a atribuição for concluída com uma identidade gerenciada atribuída pelo usuário. |
Se essas funções internas não se ajustarem às suas necessidades de segurança, considere a criação de uma função personalizada.
Observação
Se estiver usando uma identidade gerenciada atribuída pelo sistema, a entidade de serviço para o Azure BluePrints requer a função Proprietário na assinatura atribuída para habilitar a implantação. Se estiver usando o portal, essa função é concedida automaticamente e revogada para a implantação. Se usando a API REST, essa função deve ser concedida manualmente, mas é revogada ainda automaticamente após a conclusão da implantação. Se você estiver usando uma identidade gerenciada atribuída pelo usuário, somente o usuário que criar a atribuição blueprint precisará da permissão Microsoft.Blueprint/blueprintAssignments/write, que está incluída nas funções internas Proprietário e Operador de Blueprint.
Limites de nomenclatura
As seguintes limitações existem para determinados campos:
| Objeto | Campo | Caracteres Permitidos | Máx. Comprimento |
|---|---|---|---|
| Blueprint | Nome | letras, números, hifens e sublinhados | 48 |
| Blueprint | Versão | letras, números, hifens e pontos | 20 |
| Atribuição de planta | Nome | letras, números, hifens e sublinhados | 90 |
| Artefato de blueprint | Nome | letras, números, hifens e pontos | 48 |
Visão geral em vídeo
A visão geral a seguir do Azure Blueprints é do Azure Fridays. Para baixar um vídeo, acesse Azure Fridays – Uma visão geral do Azure Blueprints no Channel 9.