Introducción al servicio Azure BlueprintsOverview of the Azure Blueprints service

Del mismo modo que un plano técnico permite a un ingeniero o a un arquitecto bosquejar los parámetros de diseño de un proyecto, Azure Blueprint permite a los grupos de arquitectos de la nube y de TI central definir un conjunto repetible de recursos de Azure que implementa y cumple los estándares de la organización, sus requisitos y sus patrones.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. Azure Blueprint permite a los equipos de desarrollo aprovisionar y crear rápidamente nuevos entornos sabiendo que se crean cumpliendo los estándares organizativos y que contienen un conjunto de componentes integrados, como las redes, para acelerar el desarrollo y la 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.

Los planos técnicos son una manera declarativa de organizar la implementación de varias plantillas de recursos y de otros artefactos, como son:Blueprints are a declarative way to orchestrate the deployment of various resource templates and other artifacts such as:

  • Asignaciones de rolesRole Assignments
  • Asignaciones de directivaPolicy Assignments
  • Plantillas del Administrador de recursos de AzureAzure Resource Manager templates
  • Grupos de recursosResource Groups

El servicio Azure Blueprints está respaldado por la distribución global Azure Cosmos DB.The Azure Blueprints service is backed by the globally distributed Azure Cosmos DB. Los objetos de plano técnico se replican en varias regiones de Azure.Blueprint objects are replicated to multiple Azure regions. Esta replicación proporciona baja latencia, alta disponibilidad y acceso coherente a los objetos de plano técnico, con independencia de la región en la que Blueprints implemente el recurso.This replication provides low latency, high availability, and consistent access to your blueprint objects, regardless of which region Blueprints deploys your resources to.

En qué difiere de las plantillas de Resource ManagerHow it's different from Resource Manager templates

El servicio está diseñado para ayudar con la configuración del entorno.The service is designed to help with environment setup. A menudo, esta configuración consta de un conjunto de grupos de recursos, directivas, asignaciones de roles e implementaciones de plantillas de Resource Manager.This setup often consists of a set of resource groups, policies, role assignments, and Resource Manager template deployments. Un plano es un paquete para reunir cada uno de estos tipos de artefacto y permite componer y crear la versión de ese paquete, incluso mediante una canalización 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. En última instancia, cada uno se asigna a una suscripción en una única operación que se puede auditar y seguir.Ultimately, each is assigned to a subscription in a single operation that can be audited and tracked.

Casi todo lo que se puede querer incluir para la implementación en un plano técnico se puede conseguir con una plantilla de Resource Manager.Nearly everything that you want to include for deployment in Blueprints can be accomplished with a Resource Manager template. Sin embargo, una plantilla de Resource Manager es un documento que no existe de forma nativa en Azure, cada una se almacena localmente o en el control de código fuente.However, a Resource Manager template is a document that doesn't exist natively in Azure – each is stored either locally or in source control. La plantilla se usa para las implementaciones de uno o varios recursos de Azure pero, una vez implementados los recursos, no hay conexión activa ni relación con la plantilla.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.

Con Azure Blueprint, la relación entre la definición del plano técnico (lo que debe ser implementado) y su asignación (lo que se ha implementado) permanece.With Blueprints, the relationship between the blueprint definition (what should be deployed) and the blueprint assignment (what was deployed) is preserved. Esta conexión permite un seguimiento mejorado y la auditoría de las implementaciones.This connection supports improved tracking and auditing of deployments. Los planos técnicos también pueden actualizar varias suscripciones a la vez que se rigen por el mismo plano técnico.Blueprints can also upgrade several subscriptions at once that are governed by the same blueprint.

No hay que elegir entre una plantilla de Resource Manager y un plano técnico.There's no need to choose between a Resource Manager template and a blueprint. Cada instancia del plano técnico puede tener o no artefactos de una plantilla de Resource Manager.Each blueprint can consist of zero or more Resource Manager template artifacts. Esto significa que se pueden reutilizar los trabajos anteriores para desarrollar y mantener una biblioteca de plantillas de Resource Manager en Azure Blueprint.This support means that previous efforts to develop and maintain a library of Resource Manager templates are reusable in Blueprints.

¿En qué difiere de Azure Policy?How it's different from Azure Policy

Un plano técnico es un paquete o contenedor para crear conjuntos muy específicos de estándares, patrones y requisitos relacionados con la implementación de los servicios en la nube de Azure, la seguridad y el diseño que se pueden reutilizar para garantizar la coherencia y el cumplimiento normativo.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.

Una directiva es un sistema de denegación explícita y permisos predeterminados que se centra en las propiedades de recursos durante su implementación y para los recursos ya existentes.A policy is a default allow and explicit deny system focused on resource properties during deployment and for already existing resources. Admite la gobernanza de la nube al validar que los recursos de una suscripción cumplen los requisitos y estándares.It supports cloud governance by validating that resources within a subscription adhere to requirements and standards.

La inclusión de una directiva en un plano técnico permite la creación del diseño o el patrón correcto durante la asignación del plano técnico.Including a policy in a blueprint enables the creation of the right pattern or design during assignment of the blueprint. La inclusión de la directiva garantiza que solo se pueden realizar en el entorno cambios aprobados o esperados para proteger el cumplimiento continuo en el ámbito del plano técnico.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.

Se puede incluir una directiva como uno de muchos artefactos en una definición de plano técnico.A policy can be included as one of many artifacts in a blueprint definition. Los planos técnicos también permiten usar parámetros con las directivas y las iniciativas.Blueprints also support using parameters with policies and initiatives.

Definición del plano técnicoBlueprint definition

Un plano técnico se compone de artefactos.A blueprint is made up of artifacts. Los planos técnicos actualmente admiten los siguientes recursos como artefactos:Blueprints currently support the following resources as artifacts:

ResourceResource Opciones de la jerarquíaHierarchy options DESCRIPCIÓNDescription
Grupos de recursosResource Groups SubscriptionSubscription Cree un nuevo grupo de recursos para que lo usen otros artefactos incluidos en el plano técnico.Create a new resource group for use by other artifacts within the blueprint. Estos grupos de recursos de marcador de posición permiten organizar los recursos exactamente como desee que se estructuren y proporciona un limitador de ámbito para los artefactos de asignación de roles y directivas, así como plantillas de Azure Resource Manager.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 Azure Resource Manager templates.
Plantilla del Administrador de recursos de AzureAzure Resource Manager template Suscripción, grupo de recursosSubscription, Resource Group Las plantillas se utilizan para crear entornos complejos.Templates are used to compose complex environments. Ejemplo de entornos: una granja de servidores SharePoint, Azure Automation State Configuration o un área de trabajo de Log Analytics.Example environments: a SharePoint farm, Azure Automation State Configuration, or a Log Analytics workspace.
Asignación de directivaPolicy Assignment Suscripción, grupo de recursosSubscription, Resource Group Permite la asignación de una directiva o iniciativa a la suscripción a la que está asignado el plano técnico.Allows assignment of a policy or initiative to the subscription the blueprint is assigned to. La directiva o iniciativa debe estar dentro del ámbito de la ubicación de la definición del plano técnico.The policy or initiative must be within the scope of the blueprint definition location. Si la directiva o iniciativa tiene parámetros, estos se asignan en la creación del plano técnico o durante su asignación.If the policy or initiative has parameters, these parameters are assigned at creation of the blueprint or during blueprint assignment.
Asignación de rolesRole Assignment Suscripción, grupo de recursosSubscription, Resource Group Agregue un grupo o usuario existente a un rol integrado para asegurarse de que las personas adecuadas siempre tienen derechos de acceso a los 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. Las asignaciones de roles se pueden definir para toda la suscripción o anidarse para un grupo de recursos específico incluido en el plano técnico.Role assignments can be defined for the entire subscription or nested to a specific resource group included in the blueprint.

Ubicaciones de definición de plano técnicoBlueprint definition locations

Al crear una definición de plano técnico, definirá dónde se guarda.When creating a blueprint definition, you'll define where the blueprint is saved. Los planos técnicos se pueden guardar en un grupo de administración o suscripción a los que tenga acceso de colaborador.Blueprints can be saved to a management group or subscription that you have Contributor access to. Si la ubicación es un grupo de administración, el plano técnico está disponible para asignarlo a cualquier suscripción secundaria de ese grupo de administración.If the location is a management group, the blueprint is available to assign to any child subscription of that management group.

Parámetros de plano técnicoBlueprint parameters

Los planos técnicos pueden pasar parámetros a una iniciativa o directiva, o a una plantilla de Azure Resource Manager.Blueprints can pass parameters to either a policy/initiative or an Azure Resource Manager template. Cuando algún artefacto se agrega a un plano técnico, el autor es capaz de decidir si proporcionar un valor definido para cada asignación de plano técnico o permitir que cada asignación del plano técnico proporcione un valor en el momento de la asignación.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. Esta flexibilidad permite definir un valor predeterminado para todos los usos del plano técnico o que esa decisión se tome en el momento de la asignación.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.

Nota

Un plano técnico puede tener sus propios parámetros, pero actualmente solo se pueden crear si el plano técnico se genera desde la API REST en lugar de mediante el 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 más información, consulte el artículo sobre los parámetros de un plano técnico.For more information, see blueprint parameters.

Publicación de planos técnicosBlueprint publishing

Cuando se crea por primera vez un plano técnico, se considera que está en modo borrador.When a blueprint is first created, it's considered to be in Draft mode. Cuando está preparado para asignarse, se debe publicar.When it's ready to be assigned, it needs to be Published. La publicación requiere la definición de una cadena de versión (letras, números y guiones con una longitud máxima de 20 caracteres) junto con notas de cambio opcionales.Publishing requires defining a Version string (letters, numbers, and hyphens with a max length of 20 characters) along with optional Change notes. La versión la diferencia de los cambios futuros del mismo plano técnico y permite la asignación de cada versión.The Version differentiates it from future changes to the same blueprint and allows each version to be assigned. Esto también significa que a la misma suscripción se le pueden asignar versiones diferentes del mismo plano técnico.This versioning also means different Versions of the same blueprint can be assigned to the same subscription. Cuando se realizan cambios adicionales en el plano técnico, la versión publicada sigue existiendo, al igual que los cambios sin publicar.When additional changes are made to the blueprint, the Published Version still exists, as do the Unpublished changes. Una vez completados los cambios, el plano técnico actualizado se publica con una versión nueva y única, y ahora también se puede asignar.Once the changes are complete, the updated blueprint is Published with a new and unique Version and can now also be assigned.

Asignación de plano técnicoBlueprint assignment

Cada versión publicada de un plano técnico se puede asignar a una suscripción existente (con una longitud máxima del nombre de 90 caracteres).Each Published Version of a blueprint can be assigned (with a max name length of 90 characters) to an existing subscription. En el portal, el plano técnico tiene de forma predeterminada la versión publicada más recientemente.In the portal, the blueprint defaults the Version to the one Published most recently. Si hay parámetros de artefacto (o parámetros de plano técnico), se definirán durante el proceso de asignación.If there are artifact parameters (or blueprint parameters), then the parameters are defined during the assignment process.

Permisos de Azure BlueprintPermissions in Azure Blueprints

Para poder utilizar planos técnicos, se le deben conceder permisos mediante el control de acceso basado en rol (RBAC).To use blueprints, you must be granted permissions through Role-based access control (RBAC). Para crear planos técnicos, su cuenta necesita los siguientes permisos:To create blueprints, your account needs the following permissions:

  • Microsoft.Blueprint/blueprints/write: para crear una definición de plano técnicoMicrosoft.Blueprint/blueprints/write - Create a blueprint definition
  • Microsoft.Blueprint/blueprints/artifacts/write: para crear artefactos en una definición de plano técnicoMicrosoft.Blueprint/blueprints/artifacts/write - Create artifacts on a blueprint definition
  • Microsoft.Blueprint/blueprints/versions/write: para publicar un plano técnicoMicrosoft.Blueprint/blueprints/versions/write - Publish a blueprint

Para eliminar planos técnicos, su cuenta necesita los siguientes permisos:To delete blueprints, your account needs the following permissions:

  • Microsoft.Blueprint/blueprints/delete
  • Microsoft.Blueprint/blueprints/artifacts/delete
  • Microsoft.Blueprint/blueprints/versions/delete

Nota

Los permisos de definición de plano técnico deben ser concedidos o heredados en el ámbito de la suscripción o grupo de administración donde se guarda.The blueprint definition permissions must be granted or inherited on the management group or subscription scope where it is saved.

Para asignar o cancelar la asignación de un plano técnico, la cuenta necesita los siguientes permisos:To assign or unassign a blueprint, your account needs the following permissions:

  • Microsoft.Blueprint/blueprintAssignments/write: para asignar un plano técnicoMicrosoft.Blueprint/blueprintAssignments/write - Assign a blueprint
  • Microsoft.Blueprint/blueprintAssignments/delete: para cancelar la asignación de un plano técnicoMicrosoft.Blueprint/blueprintAssignments/delete - Unassign a blueprint

Nota

Como las asignaciones de planos técnicos se crean en una suscripción, los permisos de asignación y de cancelación de la asignación deben concederse o heredarse en el ámbito de una suscripción.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.

Están disponibles los siguientes roles integrados:The following built-in roles are available:

Rol de RBACRBAC Role DESCRIPCIÓNDescription
PropietarioOwner Además de otros permisos, incluye todos los permisos relacionados con Azure Blueprints.In addition to other permissions, includes all Azure Blueprint related permissions.
ColaboradorContributor Además de otros permisos, puede crear y eliminar definiciones de planos técnicos, pero no tiene permisos para asignarlos.In addition to other permissions, can create and delete blueprint definitions, but doesn't have blueprint assignment permissions.
Colaborador de plano técnicoBlueprint Contributor Puede administrar las definiciones del plano técnico, pero no asignarlas.Can manage blueprint definitions, but not assign them.
Operador del plano técnicoBlueprint Operator Puede asignar los planos técnicos publicados existentes, pero no puede crear nuevos.Can assign existing published blueprints, but can't create new blueprint definitions. Las asignaciones solo funcionan si se realizan con una identidad administrada asignada por el usuario.Blueprint assignment only works if the assignment is done with a user-assigned managed identity.

Si estos roles integrados no satisfacen sus necesidades de seguridad, considere la posibilidad de crear un rol personalizado.If these built-in roles don't fit your security needs, consider creating a custom role.

Nota

Si usa una identidad administrada asignada por el sistema, la entidad de servicio para Azure Blueprints requiere el rol Propietario en la suscripción asignada con el fin de habilitar la implementación.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. Si usa el portal, este rol se le concede automáticamente y se revoca para la implementación.If using the portal, this role is automatically granted and revoked for the deployment. Si usa la API REST, este rol se debe conceder manualmente, pero se sigue revocando de forma automática una vez finalizada la implementación.If using the REST API, this role must be manually granted, but is still automatically revoked after the deployment completes. Si usa una identidad administrada asignada por el usuario, solo el usuario que crea la asignación de plano técnico necesita permisos de propietario.If using a user-assigned managed identity, only the user creating the blueprint assignment needs Owner permissions.

Límites de nomenclaturaNaming limits

Existen las siguientes limitaciones para determinados campos:The following limitations exist for certain fields:

ObjectObject CampoField Caracteres permitidosAllowed Characters Máx.Max. LengthLength
Plano técnicoBlueprint NOMBREName letras, números, guiones y puntosletters, numbers, hyphens, and periods 4848
Plano técnicoBlueprint VersiónVersion letras, números, guiones y puntosletters, numbers, hyphens, and periods 2020
Asignación de plano técnicoBlueprint assignment NOMBREName letras, números, guiones y puntosletters, numbers, hyphens, and periods 9090
Artefactos de plano técnicoBlueprint artifact NOMBREName letras, números, guiones y puntosletters, numbers, hyphens, and periods 4848

Introducción en vídeoVideo overview

La siguiente introducción sobre Azure Blueprints es de Azure Fridays.The following overview of Azure Blueprints is from Azure Fridays. Para descargar el vídeo, visite Azure Fridays - An overview of Azure Blueprints (Azure Fridays - Introducción a Azure Blueprints) en Channel 9.For video download, visit Azure Fridays - An overview of Azure Blueprints on Channel 9.

Pasos siguientesNext steps