Definir e atribuir um blueprint no portal

Artigo
09/07/2023

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:

Neste tutorial, você aprenderá a usar o Azure Blueprints para executar algumas das tarefas comuns relacionadas à criação, publicação e atribuição de um blueprint dentro de sua organização. Essa habilidade ajuda você a definir padrões comuns para desenvolver configurações reutilizáveis e implantáveis rapidamente, com base em modelos do ARM (Azure Resource Manager), política e segurança.

Pré-requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Para criar blueprints, sua conta precisa das seguintes permissões:
- Microsoft.Blueprint/blueprints/write: criar uma definição de blueprint
- Microsoft.Blueprint/blueprints/artifacts/write: criar artefatos em uma definição de blueprint
- Microsoft.Blueprint/blueprints/versions/write: publicar um blueprint

Criar um plano gráfico

A primeira etapa na definição de um modelo padrão para conformidade é compor um blueprint a partir dos recursos disponíveis. Vamos criar um blueprint chamado MyBlueprint para configurar as atribuições de função e política para a assinatura. Em seguida, você adicionará um grupo de recursos, um modelo do ARM e uma atribuição de função no grupo de recursos.

Selecione Todos os serviços no painel esquerdo. Pesquise e selecione Blueprints.
Selecione Definições de blueprint e, em seguida, selecione + Criar blueprint.

Ou, selecione Introdução>Criar para ir direto para a criação de um blueprint.
Selecione Começar com um blueprint em branco do cartão na parte superior da lista de blueprints.
Fornecer um nome do blueprint, tais como MyBlueprint. (Você pode usar até 48 letras e números, mas sem espaços nem caracteres especiais). Por enquanto, mantenha Descrição do blueprint em branco.
Na caixa Definir local, clique nas reticências à direita. Em seguida, selecione o grupo de gerenciamento ou a assinatura em que deseja salvar o blueprint e clique em Selecionar.
Verifique se as informações estão corretas. Os campos nome do blueprint e local da definição não poderão ser alterados posteriormente. Clique em Próximo: Artefatos na parte inferior da página ou na guia Artefatos na parte superior da página.
Criar uma atribuição de função em um nível de assinatura:
1. Em Assinatura, selecione + Adicionar artefato. A janela Adicionar um artefato é aberta no lado direito do navegador.
2. Para Tipo de artefato, selecione Atribuição de função.
3. Para Função, selecione Colaborador. Deixe a caixa Adicionar usuário, aplicativo ou grupo caixa com a caixa de seleção que indica um parâmetro dinâmico.
4. Clique em Adicionar para adicionar este artefato ao blueprint.
Observação

A maioria dos artefatos suporta parâmetros. Um parâmetro atribuído a um valor durante a criação do blueprint é um parâmetro estático. Se o parâmetro for atribuído durante a atribuição de blueprint, ele será um parâmetro dinâmico. Para obter mais informações, consulte parâmetros de blueprint.
Incluir uma atribuição de política em um nível de assinatura:
1. Sob o artefato de atribuição de função, selecione + Adicionar artefato.
2. Para Tipo de artefato, selecione Atribuição de política.
3. Altere tipo para interno. Na pesquisa, insira marca.
4. Altere o foco de Pesquisa para que a filtragem ocorra. Selecione Acrescentar uma tag e seu valor a grupos de recursos.
5. Clique em Adicionar para adicionar este artefato ao blueprint.
Selecione a linha da atribuição de política Acrescentar uma marca e seu valor a grupos de recursos.
A janela para fornecer parâmetros para o artefato como parte da definição do blueprint é aberta. É possível definir os parâmetros para todas as atribuições (parâmetros estáticos) com base nesse blueprint, e não durante a atribuição (parâmetros dinâmicos). Este exemplo usa parâmetros dinâmicos durante a atribuição do blueprint e, portanto, deixe os padrões e clique em Cancelar.
Adicione um grupo de recursos no nível da assinatura:
1. Em Assinatura, selecione + Adicionar artefato.
2. Para Tipo de artefato, selecione Grupo de recursos.
3. Deixe as caixas Nome de exibição do artefato, Nome do Grupo de Recursos e Local em branco. Verifique se a caixa de seleção está marcada para cada propriedade de parâmetro para torná-los parâmetros dinâmicos.
4. Clique em Adicionar para adicionar este artefato ao blueprint.

Adicionar modelo sob o grupo de recursos:

Em ResourceGroup, selecione + Adicionar artefato.
Para Tipo de artefato, selecione o modelo do Azure Resource Manager. Defina o Nome de exibição do artefato como StorageAccount e deixe a Descrição em branco.

Na guia Modelo na caixa do editor, cole o modelo ARM a seguir. Depois de colar o modelo, selecione a guia Parâmetros e observe que os parâmetros de modelo storageAccountType e location foram detectados. Cada parâmetro foi automaticamente detectado e preenchido, mas configurado como um parâmetro dinâmico.

Importante

Se estiver importando o modelo, verifique se o arquivo é apenas JSON e não inclui HTML. Ao apontar para uma URL no GitHub, assegure-se de ter clicado em RAW para obter o arquivo JSON puro e não aquele envolvido com HTML para exibição no GitHub. Um erro ocorrerá se o modelo importado não for puramente JSON.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "storageAccountType": {
            "type": "string",
            "defaultValue": "Standard_LRS",
            "allowedValues": [
                "Standard_LRS",
                "Standard_GRS",
                "Standard_ZRS",
                "Premium_LRS"
            ],
            "metadata": {
                "description": "Storage Account type"
            }
        },
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]",
            "metadata": {
                "description": "Location for all resources."
            }
        }
    },
    "variables": {
        "storageAccountName": "[concat('store', uniquestring(resourceGroup().id))]"
    },
    "resources": [{
        "type": "Microsoft.Storage/storageAccounts",
        "name": "[variables('storageAccountName')]",
        "location": "[parameters('location')]",
        "apiVersion": "2018-07-01",
        "sku": {
            "name": "[parameters('storageAccountType')]"
        },
        "kind": "StorageV2",
        "properties": {}
    }],
    "outputs": {
        "storageAccountName": {
            "type": "string",
            "value": "[variables('storageAccountName')]"
        }
    }
}

Desmarque a caixa de seleção storageAccountType e observe que a lista suspensa contém apenas valores incluídos no modelo do ARM em allowedValues. Verifique a caixa para defini-lo de volta para um parâmetro dinâmico.
Clique em Adicionar para adicionar este artefato ao blueprint.

Screenshot of the Resource Manager template artifact options for adding to a blueprint definition.

Seu blueprint concluído deve ser semelhante ao seguinte. Na coluna Parâmetros, observe que cada artefato tem x de y parâmetros preenchidos. Os parâmetros dinâmicos são definidos durante cada atribuição do blueprint.
Agora que você adicionou todos os artefatos planejados, selecione Salvar rascunho na parte inferior da página.

Editar um blueprint

Em Criar um blueprint, uma descrição não foi fornecida nem a atribuição de função foi adicionada ao novo grupo de recursos. Corrija ambos ao seguir estas etapas:

Selecione Definições do blueprint na página à esquerda.
Na lista de blueprints, selecione e pressione (ou clique com o botão direito do mouse) aquele que você criou anteriormente. Em seguida, escolha Editar blueprint.
Em Descrição do Blueprint, forneça algumas informações sobre o blueprint e os artefatos que o compõem. Nesse caso, insira algo como: "Este blueprint define a atribuição de política e de atribuição de tag na assinatura, cria um ResourceGroup e implementa um modelo de recurso e uma atribuição de função para esse ResourceGroup".
Clique em Próximo: Artefatos na parte inferior da página ou na guia Artefatos na parte superior da página.
Adicionar atribuição de função sob o grupo de recursos:
1. Em ResourceGroup, selecione + Adicionar artefato.
2. Para Tipo de artefato, selecione Atribuição de função.
3. Sob Função, selecione Proprietárioe desmarque a caixa de seleção sob a caixa Adicionar usuário, aplicativo ou grupo.
4. Procure e selecione um usuário, aplicativo ou grupo a ser adicionado. Esse artefato usa um parâmetro static definido igualmente em todas as atribuições deste blueprint.
5. Clique em Adicionar para adicionar este artefato ao blueprint.
Seu blueprint concluído deve ser semelhante ao seguinte. Observe que a designação de função adicionada recentemente mostra 1 de 1 parâmetros preenchidos. Isso significa que ele é um parâmetro estático.
Selecione Salvar rascunho agora que foi atualizado.

Publicar um modelo

Agora que você adicionou todos os artefatos planejados ao blueprint, é hora de publicá-lo. A publicação torna o blueprint disponível para ser atribuído a uma assinatura.

Selecione Definições do blueprint na página à esquerda.
Na lista de blueprints, selecione e pressione (ou clique com o botão direito do mouse) aquele criado anteriormente. Em seguida, selecione Publicar blueprint.
No painel aberto, forneça uma Versão (letras, números e hifens com um comprimento máximo de 20 caracteres), como v1. Opcionalmente, insira o texto em Alterar notas, como Primeira publicação.
Selecione Publicar na parte inferior da página.

Atribuir um modelo

Depois de publicar um blueprint, é possível atribuí-lo a uma assinatura. Atribua o blueprint que você criou a uma das assinaturas em sua hierarquia do grupo de gerenciamento. Se o blueprint for salvo em uma assinatura, ele só poderá ser atribuído a essa assinatura.

Selecione Definições do blueprint na página à esquerda.
Na lista de blueprints, selecione e pressione (ou clique com o botão direito do mouse) aquele que você criou anteriormente (ou selecione as reticências). Em seguida, selecione Atribuir blueprint.
Na página Atribuir blueprint, selecione as assinaturas nas quais deseja implantar esse blueprint na lista suspensa Assinatura.

Se as ofertas do Enterprise com suporte estiverem disponíveis em Cobrança do Azure, um link Criar novo será ativado na caixa Assinatura. Siga estas etapas:
1. Selecione o link Criar novo para criar uma nova assinatura, em vez de selecionar os existentes.
2. Em Nome de exibição, insira um nome para a nova assinatura.
3. Para Oferta, selecione a oferta disponível na lista suspensa.
4. Para Grupo de gerenciamento, selecione as reticências para escolher o grupo de gerenciamento do qual a assinatura será um filho.
5. Selecione Criar na parte inferior da página.
  
  Importante
  
  A nova assinatura será criada imediatamente quando Criar for selecionado.
Observação

Uma atribuição é criada para cada assinatura que você selecionar. Você pode fazer alterações a uma única atribuição de assinatura posteriormente, sem forçar alterações no restante das assinaturas selecionadas.
Para Nome da atribuição, forneça um nome exclusivo para essa atribuição.
Em Localização, selecione uma região na qual criar a identidade gerenciada e o objeto de implantação de assinatura. O Azure Blueprints usa essa identidade gerenciada para implantar todos os artefatos no blueprint atribuído. Para saber mais, confira Identidades gerenciadas para os recursos do Azure.
Na seleção da lista suspensa Versão de definição de blueprint de versões Publicadas, não altere a entrada v1. (O padrão é a versão mais recente publicada.)
Para Atribuição de Bloqueio, deixe o padrão de Não Bloquear. Para obter mais informações, consulte bloqueio de recursos de projetos.
Em Identidade gerenciada, deixe o padrão de Atribuído pelo sistema.
Para a atribuição de função no nível da assinatura [Grupo de usuários ou nome do aplicativo]: Colaborador, pesquise e selecione um usuário, aplicativo ou grupo.
Para a atribuição de política em nível de assinatura, defina o Nome da Tag como CostCenter e o Tag Value como ContosoIT.
Em ResourceGroup, forneça o nome de StorageAccount e a localização Leste dos EUA 2 na lista suspensa.

Observação

Para cada artefato que foi incluído no grupo de recursos durante a definição do blueprint, esse artefato é recuado para alinhar com o grupo de recursos ou objeto com o qual será implementado. Os artefatos que não receberem parâmetros ou não tiverem parâmetros a serem definidos na atribuição serão listados apenas para informações contextuais.
No modelo StorageAccount do ARM, selecione Standard_GRS para o parâmetro storageAccountType.
Leia a caixa de informações na parte inferior da página e selecione Atribuir.

Controlar a implantação de um blueprint

Quando você atribui um blueprint a uma ou mais assinaturas, duas coisas acontecem:

O blueprint é incluído na página Blueprints atribuídos para cada assinatura.
Inicia o processo de implantação de todos os artefatos definidos pelo blueprint.

Agora que você atribuiu o blueprint a uma assinatura, verifique o progresso da implantação:

Selecione Blueprints atribuídos na página à esquerda.
Na lista de blueprints, selecione e pressione (ou clique com o botão direito do mouse) aquele que você atribuiu anteriormente. Em seguida, selecione Exibir detalhes de atribuição.
Na página Atribuição de blueprint, valide se todos os artefatos foram implantados com sucesso e se não houve erros durante a implantação. Em caso de erro, confira a solução de problemas de blueprint a fim de obter as etapas para determinar o que deu errado.

Limpar os recursos

Cancelar a atribuição de um blueprint

Se não for mais necessária, remova uma atribuição de blueprint de uma assinatura. O blueprint pode ter sido substituído por um mais recente com padrões, políticas e designs atualizados. Quando um blueprint é removido, os artefatos atribuídos como parte desse blueprint são deixados para trás. Para remover uma atribuição de blueprint, siga estas etapas:

Selecione Blueprints atribuídos na página à esquerda.
Na lista de blueprints, selecione o blueprint em que você deseja cancelar a atribuição. Em seguida, selecione Cancelar atribuição do blueprint na parte superior da página.
Leia a mensagem de confirmação e, em seguida, clique em OK.

Excluir um blueprint

Selecione Definições do blueprint na página à esquerda.
Clique no blueprint que deseja excluir e, em seguida, selecione Excluir blueprint. Em seguida, selecione Sim na caixa de diálogo de confirmação.

Observação

A exclusão de um blueprint nesse método também exclui todas as versões publicadas do blueprint selecionado. Para excluir uma única versão, abra o blueprint e selecione a guia Versões publicadas. Em seguida, selecione a versão que você deseja excluir e, em seguida, clique em Excluir esta versão. Além disso, você não pode excluir um blueprint até que tenha excluído todas as atribuições dessa definição de blueprint.

Próximas etapas

Neste guia de início rápido, você criou, atribuiu e removeu um blueprint com o portal do Azure. Para saber mais sobre o Azure Blueprints, prossiga para o artigo de ciclo de vida do blueprint.

Saiba mais sobre o ciclo de vida do blueprint