Tutorial: Criar um ambiente com base em um exemplo de blueprint
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:
Os blueprints de exemplo são amostras do que pode ser feito usando o Azure Blueprints. Cada um é um exemplo com uma intenção ou finalidade específica, mas que não cria um ambiente completo por si só. Cada um serve como um ponto de partida para explorar o uso do Azure Blueprints com várias combinações dos parâmetros, designs e artefatos incluídos.
O tutorial a seguir usa o exemplo de blueprint dos Grupos de Recursos com RBAC para demonstrar os diferentes aspectos do serviço do Azure Blueprints. As seguintes etapas serão abordadas:
- Criar uma nova definição de blueprint com base no exemplo
- Marcar sua cópia do exemplo como Publicado
- Atribuir a sua cópia do blueprint a uma assinatura existente
- Inspecionar os recursos implantados para a atribuição
- Cancelar a atribuição do blueprint para remover os bloqueios
Pré-requisitos
Para concluir este tutorial, será necessária uma assinatura do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Criar definição de blueprint com base no exemplo
Primeiro, implemente o exemplo de blueprint. A importação cria um novo blueprint em seu ambiente com base no exemplo.
Selecione Todos os serviços no painel esquerdo. Pesquise e selecione Blueprints.
Na página Introdução à esquerda, selecione o botão Criar em Criar um blueprint.
Localize o exemplo de blueprint Grupos de Recursos com RBAC em Outros Exemplos e selecione-o.
Insira as informações Básicas do exemplo de blueprint:
- Nome do blueprint: forneça um nome para a sua cópia do exemplo de blueprint. Para este tutorial, usaremos o nome two-rgs-with-role-assignments.
- Localização da definição: use o botão de reticências e selecione o grupo de gerenciamento ou a assinatura em que deseja salvar sua cópia do exemplo.
Selecione a guia Artefatos na parte superior da página ou clique em Avançar: Artefatos na parte inferior da página.
Examine a lista de artefatos que compõem o exemplo de blueprint. Este exemplo define dois grupos de recursos com os nomes de exibição ProdRG e PreProdRG. O nome final e a localização de cada grupo de recursos são definidos durante a atribuição do blueprint. O grupo de recursos ProdRG é atribuído à função Colaborador e o grupo de recursos PreProdRG é atribuído às funções Proprietário e Leitores. As funções atribuídas na definição são estáticas, mas o usuário, o aplicativo ou o grupo aos quais a função é atribuída são definidos durante a atribuição do blueprint.
Selecione Salvar Rascunho quando terminar de examinar o exemplo de blueprint.
Esta etapa cria uma cópia da definição do blueprint de exemplo na assinatura ou no grupo de gerenciamento selecionado. A definição de blueprint salva é gerenciada como qualquer blueprint criado do zero. Você pode salvar o exemplo em seu grupo de gerenciamento ou na assinatura tantas vezes quanto forem necessárias. No entanto, forneça um nome exclusivo para cada cópia.
Quando a notificação do portal Êxito ao salvar a definição de blueprint for exibida, avance para a próxima etapa.
Publicar a cópia do exemplo
Agora a cópia do exemplo de blueprint foi criada em seu ambiente. Ela é criada no modo Rascunho e deve ser Publicada antes de ser atribuída e implantada. A cópia do exemplo de blueprint pode ser personalizada de acordo com as necessidades e o ambiente. Neste tutorial, não faremos alterações.
Selecione Todos os serviços no painel esquerdo. Pesquise e selecione Blueprints.
Selecione a página Definições de Blueprint à esquerda. Use os filtros para localizar a definição de blueprint two-rgs-with-role-assignments e, em seguida, selecione-o.
Selecione Publicar blueprint na parte superior da página. No novo painel à direita, forneça a Versão como 1.0 para a cópia do exemplo de blueprint. Essa propriedade será útil se você fizer uma modificação mais tarde. Forneça Notas de alterações, como "Primeira versão publicada dos grupos de recursos com o exemplo de blueprint de RBAC". Em seguida, selecione Publicar na parte inferior da página.
Esta etapa possibilita atribuir o blueprint a uma assinatura. Alterações poderão ser feitas mesmo após a publicação. As alterações adicionais exigem a publicação com uma novo valor de Versão a fim de rastrear as diferenças entre as versões da mesma definição de blueprint.
Quando a notificação do portal A publicação da definição do blueprint foi bem-sucedida for exibida, avance para a próxima etapa.
Atribuir a cópia de exemplo
Quando a cópia do exemplo de blueprint for Publicada com êxito, ele poderá ser atribuído a uma assinatura do grupo de gerenciamento em que ele foi salvo. Esta é a etapa em que os parâmetros são fornecidos para tornar exclusiva cada implantação da cópia do exemplo de blueprint.
Selecione Todos os serviços no painel esquerdo. Pesquise e selecione Blueprints.
Selecione a página Definições de Blueprint à esquerda. Use os filtros para localizar a definição de blueprint two-rgs-with-role-assignments e, em seguida, selecione-o.
Selecione Atribuir blueprint na parte superior da página de definição de blueprint.
Forneça os valores de parâmetro para a atribuição de blueprint:
Noções básicas
- Assinaturas: Selecione uma ou mais das assinaturas que estão no grupo de gerenciamento em que você salvou a cópia do exemplo de blueprint. Se você selecionar mais de uma assinatura, será criada uma atribuição para cada uma, usando os parâmetros inseridos.
- Nome da atribuição: Com base no nome da definição de blueprint, esse nome é preenchido automaticamente.
- Localização: Selecione uma região para a identidade gerenciada a ser criada. O Azure Blueprints usa essa identidade gerenciada para implantar todos os artefatos no blueprint atribuído. Para saber mais, veja identidades gerenciadas para recursos do Azure. Para este tutorial, selecione Leste dos EUA 2.
- Versão de definição de blueprint: Escolha a versão Publicada1.0 da sua cópia da definição de blueprint de exemplo.
Bloquear atribuição
Selecione o modo de bloqueio de blueprint Somente Leitura. Para obter mais informações, consulte bloqueio de recursos de projetos.
Identidade Gerenciada
Deixe a opção padrão Atribuída pelo sistema. Para obter mais informações, confira identidades gerenciadas.
Parâmetros do artefato
Os parâmetros definidos nesta seção se aplicam ao artefato sob o qual ele está definido. Esses são parâmetros dinâmicos, pois são definidos durante a atribuição do blueprint. Para cada artefato, defina o valor de parâmetro para o que está definido na coluna Valor. Para
{Your ID}, selecione sua conta de usuário do Azure.Nome do artefato Tipo de artefato Nome do parâmetro Valor Descrição Grupo de recursos ProdRG Resource group Nome ProductionRG Define o nome do primeiro grupo de recursos. Grupo de recursos ProdRG Resource group Location Oeste dos EUA 2 Define a localização do primeiro grupo de recursos. Colaborador Atribuição de função Usuário ou Grupo {Sua ID} Define a qual usuário ou grupo conceder a atribuição de função Colaborador dentro do primeiro grupo de recursos. Grupo de recursos PreProdRG Resource group Nome PreProductionRG Define o nome do segundo grupo de recursos. Grupo de recursos PreProdRG Resource group Location Oeste dos EUA Define a localização do segundo grupo de recursos. Proprietário Atribuição de função Usuário ou Grupo {Sua ID} Define a qual usuário ou grupo conceder a atribuição de função Proprietário dentro do segundo grupo de recursos. Leitores Atribuição de função Usuário ou Grupo {Sua ID} Define a qual usuário ou grupo conceder a atribuição de função Leitor dentro do segundo grupo de recursos.
Depois que todos os parâmetros forem inseridos, selecione Atribuir na parte inferior da página.
Esta etapa implanta os recursos definidos e configura a Atribuição de Bloqueio selecionada. Os bloqueios de blueprint podem levar até 30 minutos para serem aplicados.
Quando a notificação do portal A atribuição da definição do blueprint foi bem-sucedida for exibida, avance para a próxima etapa.
Inspecionar recursos implantados pela atribuição
A atribuição de blueprint cria e controla os artefatos definidos na definição de blueprint. Podemos ver o status dos recursos na página de atribuição de blueprint e examinando os recursos diretamente.
Selecione Todos os serviços no painel esquerdo. Pesquise e selecione Blueprints.
Selecione a página Blueprints atribuídos à esquerda. Use os filtros para localizar a atribuição de blueprint Assignment-two-rgs-with-role-assignments e, em seguida, selecione-o.
Nessa página, podemos ver que a atribuição foi bem-sucedida e a lista de recursos criados juntamente com o respectivo estado de bloqueio do blueprint. Se a atribuição for atualizada, a lista suspensa Operação de atribuição mostrará detalhes sobre a implantação de cada versão de definição. Cada recurso listado que foi criado pode ser selecionado e abre a página de propriedades desses recursos.
Selecione o grupo de recursos ProductionRG.
Vemos que o nome do grupo de recursos é ProductionRG e não o nome de exibição do artefato ProdRG. Esse nome corresponde ao valor definido durante a atribuição de blueprint.
Selecione a página Controle de acesso (IAM) à esquerda e, em seguida, a guia Atribuições de função.
Aqui podemos ver que foi concedida a função Colaborador à sua conta, no escopo de Este recurso. A atribuição de blueprint Assignment-two-rgs-with-role-assignments tem a função Proprietário, pois foi usada para criar o grupo de recursos. Essas permissões também são usadas para gerenciar recursos com bloqueios de blueprint configurados.
Na trilha do portal do Azure, selecione Assignment-two-rgs-with-role-assignments para retornar uma página e, em seguida, selecione o grupo de recursos PreProductionRG.
Selecione a página Controle de acesso (IAM) à esquerda e, em seguida, a guia Atribuições de função.
Aqui vemos que as funções Proprietário e Leitor foram concedidas à sua conta, no escopo de Este recurso. A atribuição de blueprint também tem a função Proprietário assim como o primeiro grupo de recursos.
Selecione a guia Negar atribuições.
A atribuição de blueprint criou uma atribuição de negação no grupo de recursos implantado para impor o modo de bloqueio Somente Leitura do blueprint. A atribuição de negação impede que alguém com os direitos adequados execute ações específicas na guia Atribuições de função. A atribuição de negação afeta Todas as entidades.
Selecione a atribuição de negação e, em seguida, selecione a página Permissões Negadas à esquerda.
A atribuição de negação está impedindo todas as operações com o * e a configuração Ação, mas permite acesso de leitura excluindo */read por meio de NotActions.
Na trilha do portal do Azure, selecione PreProductionRG – Controle de acesso (IAM) . Depois, selecione a página Visão geral à esquerda e, em seguida, o botão Excluir grupo de recursos. Insira o nome PreProductionRG para confirmar a exclusão e selecione Excluir na parte inferior do painel.
A notificação do portal, Falha ao excluir grupo de recursos PreProductionRG, é exibida. O erro informa que, embora sua conta tenha permissão para excluir o grupo de recursos, o acesso é negado pela atribuição de blueprint. Lembre-se de que selecionamos o modo de bloqueio de blueprint Somente Leitura durante a atribuição de blueprint. O bloqueio de blueprint impede que uma conta com permissão, até mesmo Proprietário, exclua o recurso. Para obter mais informações, consulte bloqueio de recursos de projetos.
Estas etapas mostram que nossos recursos foram criados conforme definido e os bloqueios de blueprint impediram a exclusão indesejada, até mesmo usando uma conta com permissão.
Cancelar a atribuição do blueprint
A última etapa é remover a atribuição do blueprint e os recursos que ele implantou. A remoção da atribuição não removerá os artefatos implantados.
Selecione Todos os serviços no painel esquerdo. Pesquise e selecione Blueprints.
Selecione a página Blueprints atribuídos à esquerda. Use os filtros para localizar a atribuição de blueprint Assignment-two-rgs-with-role-assignments e, em seguida, selecione-o.
Selecione o botão Cancelar atribuição do blueprint na parte superior da página. Leia o aviso na caixa de diálogo de confirmação e, em seguida, selecione OK.
Com a atribuição de blueprint removida, os bloqueios de blueprint também são removidos. Os recursos criados já podem ser excluídos por uma conta com permissões.
Selecione Grupos de recursos no menu do Azure e, em seguida, selecione ProductionRG.
Selecione a página Controle de acesso (IAM) à esquerda e, em seguida, a guia Atribuições de função.
A segurança de cada grupo de recursos ainda tem as atribuições de função implantadas, mas a atribuição de blueprint não tem mais acesso de Proprietário.
Quando a notificação do portal A remoção da atribuição do blueprint foi bem-sucedida for exibida, avance para a próxima etapa.
Limpar os recursos
Quando terminar este tutorial, exclua os seguintes recursos:
- Grupo de recursos ProductionRG
- Grupo de recursos PreProductionRG
- Definição de blueprint two-rgs-with-role-assignments
Próximas etapas
Neste tutorial, você aprendeu a criar um novo blueprint com base em uma definição de exemplo. Para saber mais sobre o Azure Blueprints, prossiga para o artigo de ciclo de vida do blueprint.