O que é o Azure Blueprints?What is Azure Blueprints?

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.Just as a blueprint allows an engineer or an architect to sketch a project's design parameters, Azure Blueprints enables cloud architects and central information technology groups to define a repeatable set of Azure resources that implements and adheres to an organization's standards, patterns, and requirements. O Azure Blueprints permite que as equipes de desenvolvimento criem e mantenham 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.Azure Blueprints makes it possible for development teams to rapidly build and stand up new environments with trust they're building within organizational compliance with a set of built-in components, such as networking, to speed up development and delivery.

O Blueprints é uma maneira declarativa de orquestrar a implementação de vários modelos de recursos e outros artefatos, como:Blueprints are a declarative way to orchestrate the deployment of various resource templates and other artifacts such as:

  • Atribuições de FunçõesRole Assignments
  • Atribuições de PolíticasPolicy Assignments
  • Modelos do ARM (modelos do Azure Resource Manager)Azure Resource Manager templates (ARM templates)
  • Grupos de recursosResource Groups

O serviço do Azure BluePrint é apoiado pelo Azure Cosmos DB distribuído globalmente.The Azure Blueprints service is backed by the globally distributed Azure Cosmos DB. Objetos de blueprint são replicados para várias regiões do Azure.Blueprint objects are replicated to multiple Azure regions. 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.This replication provides low latency, high availability, and consistent access to your blueprint objects, regardless of which region Azure Blueprints deploys your resources to.

Como ele difere dos modelos do ARMHow it's different from ARM templates

O serviço foi projetado para ajudá-lo na configuração do ambiente.The service is designed to help with environment setup. 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.This setup often consists of a set of resource groups, policies, role assignments, and ARM template deployments. 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.A blueprint is a package to bring each of these artifact types together and allow you to compose and version that package, including through a CI/CD pipeline. Por fim, cada um é atribuído a uma assinatura em uma única operação que pode ser auditada e rastreada.Ultimately, each is assigned to a subscription in a single operation that can be audited and tracked.

Quase tudo o que você deseja incluir na implantação no Azure Blueprints pode ser feito com um modelo do ARM.Nearly everything that you want to include for deployment in Azure Blueprints can be accomplished with an ARM template. 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.However, an ARM template is a document that doesn't exist natively in Azure – each is stored either locally or in source control. 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.The template gets used for deployments of one or more Azure resources, but once those resources deploy there's no active connection or relationship to the template.

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.With Azure Blueprints, the relationship between the blueprint definition (what should be deployed) and the blueprint assignment (what was deployed) is preserved. Essa conexão dá suporte ao acompanhamento e à auditoria de implantações aprimorados.This connection supports improved tracking and auditing of deployments. O Azure Blueprints também pode atualizar várias assinaturas ao mesmo tempo quando regidas pelo mesmo blueprint.Azure Blueprints can also upgrade several subscriptions at once that are governed by the same blueprint.

Não há necessidade de escolher entre um modelo ARM e um blueprint.There's no need to choose between an ARM template and a blueprint. Cada blueprint pode consistir em zero ou mais artefatos de modelo ARM.Each blueprint can consist of zero or more ARM template artifacts. Esse suporte significa que os esforços anteriores para desenvolver e manter uma biblioteca de modelos do ARM podem ser reutilizados no Azure Blueprints.This support means that previous efforts to develop and maintain a library of ARM templates are reusable in Azure Blueprints.

Como ele difere do Azure PolicyHow it's different from 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.A blueprint is a package or container for composing focus-specific sets of standards, patterns, and requirements related to the implementation of Azure cloud services, security, and design that can be reused to maintain consistency and compliance.

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.A policy is a default allow and explicit deny system focused on resource properties during deployment and for already existing resources. Ele dá suporte à governança de nuvem confirmando que os recursos dentro de uma assinatura estão cumprindo os requisitos e os padrões.It supports cloud governance by validating that resources within a subscription adhere to requirements and standards.

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.Including a policy in a blueprint enables the creation of the right pattern or design during assignment of the 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.The policy inclusion makes sure that only approved or expected changes can be made to the environment to protect ongoing compliance to the intent of the blueprint.

Uma política pode ser incluída como um dos muitos artefatos em uma definição de blueprint.A policy can be included as one of many artifacts in a blueprint definition. Os Blueprints também suportam o uso de parâmetros com políticas e iniciativas.Blueprints also support using parameters with policies and initiatives.

Definição de plantaBlueprint definition

Um plano gráfico é composto por artefatos.A blueprint is made up of artifacts. O Azure Blueprints atualmente dá suporte aos seguintes recursos como artefatos:Azure Blueprints currently supports the following resources as artifacts:

RecursoResource Opções de hierarquiaHierarchy options DescriçãoDescription
Grupos de recursosResource Groups SubscriptionSubscription Crie um novo grupo de recursos para uso por outros artefatos no blueprint.Create a new resource group for use by other artifacts within the 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.These placeholder resource groups enable you to organize resources exactly the way you want them structured and provides a scope limiter for included policy and role assignment artifacts and ARM templates.
Modelo de ARMARM template Assinatura, Grupo de RecursosSubscription, Resource Group Modelos, incluindo aninhados e vinculados, são usados para compor ambientes complexos.Templates, including nested and linked templates, are used to compose complex environments. 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.Example environments: a SharePoint farm, Azure Automation State Configuration, or a Log Analytics workspace.
Atribuição de políticaPolicy Assignment Assinatura, Grupo de RecursosSubscription, Resource Group Permite a atribuição de uma política ou iniciativa à assinatura a qual o blueprint está atribuído.Allows assignment of a policy or initiative to the subscription the blueprint is assigned to. A política ou iniciativa deve estar dentro do escopo do local de definição do blueprint.The policy or initiative must be within the scope of the blueprint definition location. 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.If the policy or initiative has parameters, these parameters are assigned at creation of the blueprint or during blueprint assignment.
Atribuição de funçãoRole Assignment Assinatura, Grupo de RecursosSubscription, Resource Group 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.Add an existing user or group to a built-in role to make sure the right people always have the right access to your resources. 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.Role assignments can be defined for the entire subscription or nested to a specific resource group included in the blueprint.

Localizações de definição do blueprintBlueprint definition locations

Ao criar uma definição de blueprint, você definirá onde o blueprint será salvo.When creating a blueprint definition, you'll define where the blueprint is saved. Blueprints podem ser salvos em um grupo de gerenciamento ou assinatura ao qual você tenha acesso de Contribuidor.Blueprints can be saved to a management group or subscription that you have Contributor access to. Se o local for um grupo de gerenciamento, o blueprint estará disponível para atribuir qualquer assinatura filho daquele grupo de gerenciamento.If the location is a management group, the blueprint is available to assign to any child subscription of that management group.

Parâmetros de blueprintBlueprint parameters

Os blueprints podem passar parâmetros para uma política/iniciativa ou um modelo do ARM.Blueprints can pass parameters to either a policy/initiative or an ARM template. 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.When adding either artifact to a blueprint, the author decides to provide a defined value for each blueprint assignment or to allow each blueprint assignment to provide a value at assignment time. 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.This flexibility provides the option to define a pre-determined value for all uses of the blueprint or to enable that decision to be made at the time of assignment.

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.A blueprint can have its own parameters, but these can currently only be created if a blueprint is generated from REST API instead of through the Portal.

Para obter mais informações, consulte parâmetros de plano gráfico.For more information, see blueprint parameters.

Especificações técnicas de publicaçãoBlueprint publishing

Quando um plano gráfico é criado, ele é considerado para estar no modo rascunho.When a blueprint is first created, it's considered to be in Draft mode. Quando estiver pronto para ser atribuído, ele precisa ser Publicado.When it's ready to be assigned, it needs to be Published. 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.Publishing requires defining a Version string (letters, numbers, and hyphens with a max length of 20 characters) along with optional Change notes. A versão a diferencia de futuras alterações no mesmo blueprint e permite que cada versão seja atribuída.The Version differentiates it from future changes to the same blueprint and allows each version to be assigned. Esse controle de versão também significa que várias Versões do mesmo blueprint podem ser atribuídas à mesma assinatura.This versioning also means different Versions of the same blueprint can be assigned to the same subscription. Quando há outras alterações no blueprint, a Versão Publicada ainda existe, bem como as Alterações não publicadas.When additional changes are made to the blueprint, the Published Version still exists, as do the Unpublished changes. 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.Once the changes are complete, the updated blueprint is Published with a new and unique Version and can now also be assigned.

Atribuição de plantaBlueprint assignment

Cada Versão Publicada de um blueprint pode ser atribuída (com um comprimento de nome máximo de 90 caracteres) a uma assinatura existente.Each Published Version of a blueprint can be assigned (with a max name length of 90 characters) to an existing subscription. No portal, o blueprint usará como padrão a Versão em vez do que foi Publicado mais recentemente.In the portal, the blueprint defaults the Version to the one Published most recently. Se houver parâmetros de artefatos (ou parâmetros de blueprint), os parâmetros serão definidos durante o processo de atribuição.If there are artifact parameters (or blueprint parameters), then the parameters are defined during the assignment process.

Permissões nos Blueprints do AzurePermissions in Azure Blueprints

Para usar blueprints, você deverá receber permissões por meio do RBAC (controle de acesso baseado em função).To use blueprints, you must be granted permissions through Role-based access control (RBAC). Para criar planos gráficos, sua conta precisa das seguintes permissões:To create blueprints, your account needs the following permissions:

  • Microsoft.Blueprint/blueprints/write -Criar uma definição de plantaMicrosoft.Blueprint/blueprints/write - Create a blueprint definition
  • Microsoft.Blueprint/blueprints/artifacts/write -Criar artefatos em uma definição de plantaMicrosoft.Blueprint/blueprints/artifacts/write - Create artifacts on a blueprint definition
  • Microsoft.Blueprint/blueprints/versions/write -Publicar um plano gráficoMicrosoft.Blueprint/blueprints/versions/write - Publish a blueprint

Para excluir os planos gráficos, sua conta precisa das seguintes permissões:To delete blueprints, your account needs the following permissions:

  • Microsoft.Blueprint/blueprints/delete
  • Microsoft.Blueprint/blueprints/artifacts/delete
  • Microsoft.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.The blueprint definition permissions must be granted or inherited on the management group or subscription scope where it is saved.

Para atribuir ou desatribuir um plano gráfico, sua conta precisa das seguintes permissões:To assign or unassign a blueprint, your account needs the following permissions:

  • Microsoft.Blueprint/blueprintAssignments/write -Atribuir um plano gráficoMicrosoft.Blueprint/blueprintAssignments/write - Assign a blueprint
  • Microsoft.Blueprint/blueprintAssignments/delete -Cancelar a atribuição de um plano gráficoMicrosoft.Blueprint/blueprintAssignments/delete - Unassign a blueprint

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 blueprint assignments are created on a subscription, the blueprint assign and unassign permissions must be granted on a subscription scope or be inherited onto a subscription scope.

As seguintes funções internas estão disponíveis:The following built-in roles are available:

Função do AzureAzure role DescriçãoDescription
ProprietárioOwner Além de outras permissões, inclui todas as permissões relacionadas ao Azure Blueprint.In addition to other permissions, includes all Azure Blueprint related permissions.
ColaboradorContributor 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.In addition to other permissions, can create and delete blueprint definitions, but doesn't have blueprint assignment permissions.
Colaborador do BlueprintBlueprint Contributor Pode gerenciar definições de blueprint, mas não as atribuir.Can manage blueprint definitions, but not assign them.
Operador do BlueprintBlueprint Operator Pode atribuir blueprints publicados existentes, mas não pode criar definições de blueprint.Can assign existing published blueprints, but can't create new blueprint definitions. A atribuição de blueprint só funcionará se a atribuição for concluída com uma identidade gerenciada atribuída pelo usuário.Blueprint assignment only works if the assignment is done with a user-assigned managed identity.

Se essas funções internas não se ajustarem às suas necessidades de segurança, considere a criação de uma função personalizada.If these built-in roles don't fit your security needs, consider creating a custom role.

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.If using a system-assigned managed identity, the service principal for Azure Blueprints requires the Owner role on the assigned subscription in order to enable deployment. Se estiver usando o portal, essa função é concedida automaticamente e revogada para a implantação.If using the portal, this role is automatically granted and revoked for the deployment. Se usando a API REST, essa função deve ser concedida manualmente, mas é revogada ainda automaticamente após a conclusão da implantação.If using the REST API, this role must be manually granted, but is still automatically revoked after the deployment completes. 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.If using a user-assigned managed identity, only the user creating the blueprint assignment needs the Microsoft.Blueprint/blueprintAssignments/write permission, which is included in both the Owner and Blueprint Operator built-in roles.

Limites de nomenclaturaNaming limits

As seguintes limitações existem para determinados campos:The following limitations exist for certain fields:

ObjetoObject CampoField Caracteres PermitidosAllowed Characters Máx.Max. ComprimentoLength
BlueprintBlueprint NomeName letras, números, hifens e pontosletters, numbers, hyphens, and periods 4848
BlueprintBlueprint VersãoVersion letras, números, hifens e pontosletters, numbers, hyphens, and periods 2020
Atribuição de plantaBlueprint assignment NomeName letras, números, hifens e pontosletters, numbers, hyphens, and periods 9090
Artefato de blueprintBlueprint artifact NomeName letras, números, hifens e pontosletters, numbers, hyphens, and periods 4848

Visão geral em vídeoVideo overview

A visão geral a seguir do Azure Blueprints é do Azure Fridays.The following overview of Azure Blueprints is from Azure Fridays. Para baixar um vídeo, acesse Azure Fridays – Uma visão geral do Azure Blueprints no Channel 9.For video download, visit Azure Fridays - An overview of Azure Blueprints on Channel 9.

Próximas etapasNext steps