Quickstart: Definir e atribuir uma planta no portalQuickstart: Define and assign a blueprint in the portal

Quando aprender a criar e atribuir plantas, pode definir padrões comuns para desenvolver configurações reutilizáveis e rapidamente implantáveis com base em modelos de Gestor de Recursos Azure (modelos ARM), política, segurança e muito mais.When you learn how to create and assign blueprints, you can define common patterns to develop reusable and rapidly deployable configurations based on Azure Resource Manager templates (ARM templates), policy, security, and more. Neste tutorial, aprende-se a usar a Azure Blueprints para fazer algumas das tarefas comuns relacionadas com a criação, publicação e atribuição de um projeto dentro da sua organização.In this tutorial, you learn to use Azure Blueprints to do some of the common tasks related to creating, publishing, and assigning a blueprint within your organization. Estas tarefas incluem:These tasks include:

Pré-requisitosPrerequisites

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Criar um esquemaCreate a blueprint

O primeiro passo na definição de um padrão de conformidade é compor um esquema a partir dos recursos disponíveis.The first step in defining a standard pattern for compliance is to compose a blueprint from the available resources. Neste exemplo, crie um novo projeto chamado MyBlueprint para configurar funções e atribuições políticas para a subscrição.In this example, create a new blueprint named MyBlueprint to configure role and policy assignments for the subscription. Em seguida, adicione um novo grupo de recursos e crie um modelo de Gestor de Recursos e atribuição de funções no novo grupo de recursos.Then add a new resource group, and create a Resource Manager template and role assignment on the new resource group.

  1. Selecione Todos os serviços no painel esquerdo.Select All services in the left pane. Procure e selecione Esquemas.Search for and select Blueprints.

  2. Selecione definições de Planta a partir da página à esquerda e selecione o botão + Criar o botão de planta no topo da página.Select Blueprint definitions from the page on the left and select the + Create blueprint button at the top of the page.

    Ou, selecione Criar a partir da página Iniciar para ir direto para a criação de uma planta.Or, select Create from the Getting started page to go straight to creating a blueprint.

    Screenshot do botão 'Criar planta' na página definições de Blueprint.

  3. Selecione Comece com a planta em branco do cartão no topo da lista de plantas incorporadas.Select Start with blank blueprint from the card at the top of the built-in blueprints list.

  4. Forneça um nome Blueprint como MyBlueprint.Provide a Blueprint name such as MyBlueprint. (Utilize até 48 letras e números, mas sem espaços ou caracteres especiais).(Use up to 48 letters and numbers, but no spaces or special characters). Deixe a descrição da Planta em branco por enquanto.Leave Blueprint description blank for now.

  5. Na caixa de localização Definição, selecione a elipse à direita, selecione o grupo de gestão ou subscrição onde pretende guardar a planta e escolha Select.In the Definition location box, select the ellipsis on the right, select the management group or subscription where you want to save the blueprint, and choose Select.

  6. Verifique se a informação está correta.Verify that the information is correct. O nome blueprint e os campos de localização de definição não podem ser alterados mais tarde.The Blueprint name and Definition location fields can't be changed later. Em seguida, selecione Seguinte : Artefactos na parte inferior da página ou o separador Artefactos no topo da página.Then select Next : Artifacts at the bottom of the page or the Artifacts tab at the top of the page.

  7. Adicione uma atribuição de função ao nível da subscrição:Add a role assignment at the subscription level:

    1. Selecione a linha de artefacto + em subscrição.Select the + Add artifact row under Subscription. A janela de artefactos Add abre-se no lado direito do navegador.The Add artifact window opens on the right side of the browser.

    2. Selecione atribuição de função para o tipo artefacto.Select Role assignment for Artifact type.

    3. Under Role, select Contributor.Under Role, select Contributor. Deixe o utilizador, aplicação ou caixa de grupo adicionar com a caixa de verificação que indica um parâmetro dinâmico.Leave the Add user, app or group box with the check box that indicates a dynamic parameter.

    4. Selecione Adicione para adicionar este artefacto à planta.Select Add to add this artifact to the blueprint.

    Screenshot das opções de artefacto de atribuição de funções para adicionar a uma definição de planta.

    Nota

    A maioria dos artefactos suporta parâmetros.Most artifacts support parameters. Um parâmetro que é atribuído a um valor durante a criação do projeto é um parâmetro estático.A parameter that's assigned a value during blueprint creation is a static parameter. Se o parâmetro for atribuído durante a atribuição da planta, é um parâmetro dinâmico.If the parameter is assigned during blueprint assignment, it's a dynamic parameter. Para obter mais informações, consulte os parâmetros do Plano.For more information, see Blueprint parameters.

  8. Adicione uma atribuição de política ao nível da subscrição:Add a policy assignment at the subscription level:

    1. Selecione a linha de artefacto + adicionar sob o artefacto de atribuição de funções.Select the + Add artifact row under the role assignment artifact.

    2. Selecione a atribuição de política para o tipo de artefacto.Select Policy assignment for Artifact type.

    3. Alterar tipo para incorporado.Change Type to Built-in. Em Busca, insira a etiqueta.In Search, enter tag.

    4. Mude o foco fora da Procura para que a filtragem ocorra.Change focus out of Search for the filtering to occur. Selecione a etiqueta de apêndice e o seu valor predefinido para grupos de recursos.Select Append tag and its default value to resource groups.

    5. Selecione Adicione para adicionar este artefacto à planta.Select Add to add this artifact to the blueprint.

  9. Selecione a linha da atribuição de políticas A etiqueta do apêndice e o seu valor predefinido para grupos de recursos.Select the row of the policy assignment Append tag and its default value to resource groups.

  10. É apresentada a janela com os parâmetros para o artefacto como parte da definição do esquema e que permite definir os parâmetros para todas as atribuições (parâmetros estáticos) com base neste esquema, em vez de o fazer durante a atribuição (parâmetros dinâmicos).The window to provide parameters to the artifact as part of the blueprint definition opens and allows setting the parameters for all assignments (static parameters) based on this blueprint instead of during assignment (dynamic parameters). Este exemplo utiliza parâmetros dinâmicos durante a atribuição do projeto, por isso deixe as predefinições e selecione Cancelar.This example uses dynamic parameters during blueprint assignment, so leave the defaults and select Cancel.

  11. Adicione um grupo de recursos ao nível de subscrição:Add a resource group at the subscription level:

    1. Selecione a linha de artefacto + em subscrição.Select the + Add artifact row under Subscription.

    2. Selecione grupo de recursos para o tipo artefacto.Select Resource group for Artifact type.

    3. Deixe o nome de exibição do Artefacto, Nome do Grupo de Recursos e caixas de localização em branco, mas certifique-se de que a caixa de verificação é verificada para cada propriedade de parâmetros para torná-los parâmetros dinâmicos.Leave the Artifact display name, Resource Group Name, and Location boxes blank, but make sure that the check box is checked for each parameter property to make them dynamic parameters.

    4. Selecione Adicione para adicionar este artefacto à planta.Select Add to add this artifact to the blueprint.

  12. Adicione um modelo sob o grupo de recursos:Add a template under the resource group:

    1. Selecione a linha de artefacto + adicionar sob a entrada do Grupo de Recursos.Select the + Add artifact row under the ResourceGroup entry.

    2. Selecione o modelo de Gestor de Recursos Azure para o tipo de artefacto, desenhe o nome do visor do artefacto para o StorageAccount e deixe a Descrição em branco.Select Azure Resource Manager template for Artifact type, set Artifact display name to StorageAccount, and leave Description blank.

    3. No separador Modelo na caixa do editor, cole o seguinte modelo ARM.On the Template tab in the editor box, paste the following ARM template. Depois de colar o modelo, selecione o separador Parâmetros e note que os parâmetros do modelo armazenam o Número de Registos e a localização foram detetados.After you paste the template, select the Parameters tab and note that the template parameters storageAccountType and location were detected. Cada parâmetro foi automaticamente detetado e povoado, mas configurado como um parâmetro dinâmico.Each parameter was automatically detected and populated, but configured as a dynamic parameter.

      Importante

      Se estiver a importar o modelo, certifique-se de que o ficheiro é apenas JSON e não inclui HTML.If you're importing the template, ensure that the file is only JSON and doesn't include HTML. Quando estiver a apontar para um URL no GitHub, certifique-se de que selecionou RAW para obter o ficheiro JSON puro e não o embrulhado com HTML para exibição no GitHub.When you're pointing to a URL on GitHub, ensure that you have selected RAW to get the pure JSON file and not the one wrapped with HTML for display on GitHub. Se o modelo importado não for JSON puro, ocorrerá um erro.An error occurs if the imported template is not purely 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')]"
              }
          }
      }
      
    4. Limpe a caixa de verificação de armazenamentoAcomprendaType e note que a lista de drop-down contém apenas valores incluídos no modelo ARM sob o permitidoValues.Clear the storageAccountType check box and note that the drop-down list contains only values included in the ARM template under allowedValues. Selecione a caixa para a reussar para um parâmetro dinâmico.Select the box to set it back to a dynamic parameter.

    5. Selecione Adicione para adicionar este artefacto à planta.Select Add to add this artifact to the blueprint.

    Screenshot das opções de artefacto do modelo do gestor de recursos para adicionar a uma definição de planta.

  13. O esquema concluído deve ter um aspeto semelhante ao seguinte.Your completed blueprint should look similar to the following. Note que cada artefacto tem x fora de parâmetros y povoados na coluna Parâmetros.Notice that each artifact has x out of y parameters populated in the Parameters column. Os parâmetros dinâmicos são definidos durante cada atribuição do esquema.The dynamic parameters are set during each assignment of the blueprint.

    Screenshot de uma definição de planta completa com cada tipo de artefacto.

  14. Agora que todos os artefactos planeados foram adicionados, selecione Save Draft na parte inferior da página.Now that all planned artifacts have been added, select Save Draft at the bottom of the page.

Editar um esquemaEdit a blueprint

Na Criação de uma planta,não forneceu uma descrição ou adicionou a atribuição de funções ao novo grupo de recursos.In Create a blueprint, you didn't provide a description or add the role assignment to the new resource group. Pode corrigir ambos seguindo estes passos:You can fix both by following these steps:

  1. Selecione definições de Planta da página à esquerda.Select Blueprint definitions from the page on the left.

  2. Na lista de plantas, clique com o botão direito no que criou anteriormente e selecione Editar o projeto.In the list of blueprints, right-click the one that you previously created and select Edit blueprint.

  3. Na descrição do Blueprint, forneça algumas informações sobre a planta e os artefactos que a compõem.In Blueprint description, provide some information about the blueprint and the artifacts that compose it. Neste caso, introduza algo como: Este projeto define a política de marcação e a atribuição de funções na subscrição, cria um Grupo de Recursos e implementa um modelo de recursos e uma atribuição de funções a esse Grupo de Recursos.In this case, enter something like: This blueprint sets tag policy and role assignment on the subscription, creates a ResourceGroup, and deploys a resource template and role assignment to that ResourceGroup.

  4. Selecione Seguinte : Artefactos na parte inferior da página ou no separador Artefactos no topo da página.Select Next : Artifacts at the bottom of the page or the Artifacts tab at the top of the page.

  5. Adicione uma atribuição de funções no grupo de recursos:Add a role assignment under the resource group:

    1. Selecione a linha de artefacto + adicionar diretamente sob a entrada do Grupo de Recursos.Select the + Add artifact row directly under the ResourceGroup entry.

    2. Selecione atribuição de função para o tipo artefacto.Select Role assignment for Artifact type.

    3. Under Role, selecione Owner, e limpe a caixa de verificação sob o utilizador, app ou caixa de grupo Do Add.Under Role, select Owner, and clear the check box under the Add user, app or group box.

    4. Procure e selecione um utilizador, app ou grupo para adicionar.Search for and select a user, app, or group to add. Este artefacto utiliza um parâmetro estático que é o mesmo em cada atribuição deste esquema.This artifact uses a static parameter set the same in every assignment of this blueprint.

    5. Selecione Adicione para adicionar este artefacto à planta.Select Add to add this artifact to the blueprint.

    Screenshot das opções de artefactos de segunda função para adicionar a uma definição de planta.

  6. O esquema concluído deve ter um aspeto semelhante ao seguinte.Your completed blueprint should look similar to the following. Note que a atribuição de funções recentemente adicionada mostra 1 em 1 parâmetros povoados.Notice that the newly added role assignment shows 1 out of 1 parameters populated. Significa que é um parâmetro estático.That means it's a static parameter.

    Screenshot da segunda definição de planta concluída com o artefacto adicional de atribuição de funções.

  7. Selecione Save Draft agora que foi atualizado.Select Save Draft now that it has been updated.

Publicar um esquemaPublish a blueprint

Agora que os artefactos planeados foram adicionados ao esquema, é altura de o publicar.Now that all the planned artifacts have been added to the blueprint, it's time to publish it. A publicação disponibiliza o projeto para ser atribuído a uma subscrição.Publishing makes the blueprint available to be assigned to a subscription.

  1. Selecione definições de Planta da página à esquerda.Select Blueprint definitions from the page on the left.

  2. Na lista de plantas, clique com o botão direito no que criou anteriormente e selecione Publicar o projeto.In the list of blueprints, right-click the one you previously created and select Publish blueprint.

  3. No painel que abre, forneça uma versão (letras, números e hífens com um comprimento máximo de 20 caracteres), como v1.In the pane that opens, provide a Version (letters, numbers, and hyphens with a maximum length of 20 characters), such as v1. Opcionalmente, introduza texto em notas Change, como a Primeira publicação.Optionally, enter text in Change notes, such as First publish.

  4. Selecione Publicar na parte inferior da página.Select Publish at the bottom of the page.

Atribuir um esquemaAssign a blueprint

Depois de publicado um projeto, pode ser atribuído a uma subscrição.After a blueprint has been published, it can be assigned to a subscription. Atribua o projeto que criou para uma das subscrições sob a hierarquia do seu grupo de gestão.Assign the blueprint that you created to one of the subscriptions under your management group hierarchy. Se a planta for guardada para uma subscrição, só pode ser atribuída a essa subscrição.If the blueprint is saved to a subscription, it can only be assigned to that subscription.

  1. Selecione definições de Planta da página à esquerda.Select Blueprint definitions from the page on the left.

  2. Na lista de plantas, clique com o botão direito no que criou anteriormente (ou selecione a elipse) e selecione Designar a planta.In the list of blueprints, right-click the one that you previously created (or select the ellipsis) and select Assign blueprint.

  3. Na página de blueprint 'Atribuir', na lista de entrega de assinaturas, selecione as subscrições para as quais pretende implementar esta planta.On the Assign blueprint page, in the Subscription drop-down list, select the subscriptions that you want to deploy this blueprint to.

    Se houver ofertas empresariais suportadas disponíveis a partir de Azure Billing,um novo link Create é ativado na caixa de Subscrição.If there are supported Enterprise offerings available from Azure Billing, a Create new link is activated under the Subscription box. Siga estes passos:Follow these steps:

    1. Selecione o novo link Criar uma nova subscrição em vez de selecionar as existentes.Select the Create new link to create a new subscription instead of selecting existing ones.

    2. Forneça um nome de Exibição para a nova subscrição.Provide a Display name for the new subscription.

    3. Selecione a Oferta disponível na lista de drop-down.Select the available Offer from the drop-down list.

    4. Utilize a elipse para selecionar o grupo de gestão de que a subscrição será uma criança.Use the ellipsis to select the management group that the subscription will be a child of.

    5. Selecione Criar na parte inferior da página.Select Create at the bottom of the page.

      Screenshot da janela de subscrição Criar e opções para a nova subscrição.

      Importante

      A nova subscrição é criada imediatamente após a seleção criar Criar.The new subscription is created immediately after you select Create.

    Nota

    É criada uma atribuição para cada subscrição que selecionar.An assignment is created for each subscription that you select. Pode escoar alterações numa única subscrição posteriormente sem forçar alterações no restante das subscrições selecionadas.You can make changes to a single subscription assignment at a later time without forcing changes on the remainder of the selected subscriptions.

  4. Para o nome de atribuição, forneça um nome único para esta atribuição.For Assignment name, provide a unique name for this assignment.

  5. In Location, selecione uma região para o objeto de implantação de identidade e subscrição gerido a criar.In Location, select a region for the managed identity and subscription deployment object to be created in. O Azure Blueprint utiliza esta identidade gerida para implementar todos os artefactos no esquema atribuído.Azure Blueprint uses this managed identity to deploy all artifacts in the assigned blueprint. Para saber mais, veja Identidades geridas para os recursos do Azure.To learn more, see Managed identities for Azure resources.

  6. Deixe a versão de definição Blueprint de versão pendente de versões publicadas na entrada v1.Leave the Blueprint definition version drop-down selection of Published versions on the v1 entry. (O padrão é a versão mais recentemente publicada.)(The default is the most recently published version.)

  7. Em Atribuição de Bloqueio, deixe a predefinição Não Bloquear.For Lock Assignment, leave the default of Don't Lock. Para obter mais informações, consulte o bloqueio de recursos da Blueprints.For more information, see Blueprints resource locking.

    Screenshot da atribuição de bloqueio e opções de identidade geridas para a atribuição do projeto.

  8. Sob Identidade Gerida, deixe o padrão do Sistema atribuído.Under Managed Identity, leave the default of System assigned.

  9. Para a atribuição de função ao nível da subscrição [Grupo de utilizadores ou nome da aplicação]: Contribuidor, procure e selecione um utilizador, uma aplicação ou um grupo.For the subscription level role assignment [User group or application name] : Contributor, search for and select a user, app, or group.

  10. Para a atribuição de política de nível de subscrição, deite o Nome tag para CostCenter e o Valor de Marca para ContosoIT.For the subscription level policy assignment, set Tag Name to CostCenter and the Tag Value to ContosoIT.

  11. Para o ResourceGroup, forneça um Nome de Contagem de Armazenamento e uma localização de East US 2 da lista de drop-down.For ResourceGroup, provide a Name of StorageAccount and a Location of East US 2 from the drop-down list.

    Nota

    Para cada artefacto que adicionou sob o grupo de recursos durante a definição de planta, esse artefacto é recuado para alinhar-se com o grupo de recursos ou objeto com o qual irá implantá-lo.For each artifact that you added under the resource group during blueprint definition, that artifact is indented to align with the resource group or object that you'll deploy it with. Os artefactos que não tomam parâmetros ou não têm parâmetros a definir na atribuição são listados apenas para informações contextuais.Artifacts that either don't take parameters or have no parameters to be defined at assignment are listed only for contextual information.

  12. Na contagem de armazenamento do modelo ARM, selecione Standard_GRS para o parâmetro De armazenamentoAcolho.On the ARM template StorageAccount, select Standard_GRS for the storageAccountType parameter.

  13. Leia a caixa de informações na parte inferior da página e, em seguida, selecione Atribuir.Read the information box at the bottom of the page, and then select Assign.

Controlar a implementação de um esquemaTrack deployment of a blueprint

Após atribuir um esquema a uma ou mais subscrições, acontecem duas coisas:When a blueprint has been assigned to one or more subscriptions, two things happen:

  • A planta é adicionada à página de plantas atribuídas para cada subscrição.The blueprint is added to the Assigned blueprints page for each subscription.
  • Começa o processo de implantação de todos os artefactos definidos pela planta.The process of deploying all the artifacts defined by the blueprint begins.

Agora que a planta foi atribuída a uma subscrição, verifique o progresso da implementação:Now that the blueprint has been assigned to a subscription, verify the progress of the deployment:

  1. Selecione as plantas atribuídas da página à esquerda.Select Assigned blueprints from the page on the left.

  2. Na lista de plantas, clique com o botão direito no que já atribuiu e selecione Ver detalhes da atribuição.In the list of blueprints, right-click the one that you previously assigned and select View assignment details.

    Screenshot do menu de contexto de atribuição de plantas com a opção 'Ver detalhes da atribuição' selecionada.

  3. Na página de atribuição do Blueprint, valide que todos os artefactos foram implantados com sucesso e que não houve erros durante a implementação.On the Blueprint assignment page, validate that all artifacts were successfully deployed and that there were no errors during the deployment. Se ocorrerem erros, consulte as plantas de resolução de problemas para obter passos para determinar o que correu mal.If errors occurred, see Troubleshooting blueprints for steps to determine what went wrong.

Limpar os recursosClean up resources

Anular a atribuição de um esquemaUnassign a blueprint

Se já não precisar de uma atribuição de planta, remova-a de uma subscrição.If you no longer need a blueprint assignment, remove it from a subscription. A planta pode ter sido substituída por uma nova planta com padrões, políticas e desenhos atualizados.The blueprint might have been replaced by a newer blueprint with updated patterns, policies, and designs. Quando um esquema é removido, os artefactos atribuídos como parte desse esquema são deixados para trás.When a blueprint is removed, the artifacts assigned as part of that blueprint are left behind. Para remover uma atribuição de esquema, siga estes passos:To remove a blueprint assignment, follow these steps:

  1. Selecione as plantas atribuídas da página à esquerda.Select Assigned blueprints from the page on the left.

  2. Na lista de plantas, selecione a planta que pretende não assinar.In the list of blueprints, select the blueprint that you want to unassign. Em seguida, selecione o botão de planta de adign no topo da página.Then select the Unassign blueprint button at the top of the page.

  3. Leia a mensagem de confirmação e, em seguida, selecione OK.Read the confirmation message and then select OK.

Eliminar um esquemaDelete a blueprint

  1. Selecione definições de Planta da página à esquerda.Select Blueprint definitions from the page on the left.

  2. Clique com o botão direito na planta que pretende eliminar e selecione Eliminar a planta.Right-click the blueprint that you want to delete, and select Delete blueprint. Em seguida, selecione Sim na caixa de diálogo de confirmação.Then select Yes in the confirmation dialog box.

Nota

A eliminação de uma planta neste método também elimina todas as versões publicadas da planta selecionada.Deleting a blueprint in this method also deletes all published versions of the selected blueprint. Para eliminar uma única versão, abra a planta, selecione o separador versões Publicado, selecione a versão que pretende eliminar e, em seguida, selecione Eliminar Esta Versão.To delete a single version, open the blueprint, select the Published versions tab, select the version that you want to delete, and then select Delete This Version. Além disso, não podes apagar uma planta até teres apagado toda a definição de planta.Also, you can't delete a blueprint until you've deleted all blueprint assignment of that blueprint definition.

Passos seguintesNext steps

Neste arranque rápido, criaste, atribuiste e removeste uma planta com o portal Azure.In this quickstart, you've created, assigned, and removed a blueprint with Azure portal. Para saber mais sobre a Azure Blueprints, continue para o artigo do ciclo de vida do projeto.To learn more about Azure Blueprints, continue to the blueprint lifecycle article.