¿Qué es Azure Blueprints (versión preliminar)?
Importante
El 11 de julio de 2026, Blueprints (versión preliminar) quedará en desuso. Migre las definiciones y asignaciones de planos técnicos existentes a Especificaciones de plantilla y Pilas de implementación. Los artefactos de plano técnico se convertirán en plantillas JSON de ARM o archivos de Bicep que se usan para definir pilas de implementación. Para obtener información sobre cómo crear un artefacto como un recurso de ARM, consulte:
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. Azure Blueprints permite a los equipos de desarrollo compilar e iniciar rápidamente nuevos entornos sabiendo que se compilan cumpliendo los estándares organizativos y que contienen un conjunto de componentes integrados, como las redes, para acelerar el desarrollo y la entrega.
Los planos técnicos son una manera declarativa de organizar la implementación de varias plantillas de recursos y de otros artefactos, como son:
- Asignaciones de roles
- Asignaciones de directiva
- Plantillas de Azure Resource Manager (plantillas de ARM)
- Grupos de recursos
El servicio Azure Blueprints está respaldado por la distribución global Azure Cosmos DB. Los objetos de plano técnico se replican en varias regiones de Azure. 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 Azure Blueprints implemente el recurso.
¿En qué se diferencia de las plantillas de Resource Manager?
El servicio está diseñado para ayudar con la configuración del entorno. A menudo, esta configuración consta de un conjunto de grupos de recursos, directivas, asignaciones de roles e implementaciones de plantillas de Resource Manager. Un plano técnico es un paquete para reunir todos estos tipos de artefacto y permite componer y crear la versión del paquete, incluso mediante una canalización de integración continua y entrega continua (CI/CD). En última instancia, cada uno se asigna a una suscripción en una única operación que se puede auditar y seguir.
Casi todo lo que desee incluir para la implementación en Azure Blueprints se puede conseguir con una plantilla de Resource Manager. Sin embargo, una plantilla de Resource Manager es un documento que no existe de forma nativa en Azure, cada una se almacena localmente, en el control de código fuente o en Plantillas (versión preliminar). 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.
Con Azure Blueprints, 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. Esta conexión permite un seguimiento mejorado y la auditoría de las implementaciones. Azure Blueprints también puede actualizar varias suscripciones a la vez que se rigen por el mismo plano técnico.
No es preciso elegir entre una plantilla de Resource Manager y un plano técnico. Cada plano técnico puede tener cero o más artefactos de una plantilla de Resource Manager. Esta compatibilidad significa que se pueden reutilizar los trabajos anteriores para desarrollar y mantener una biblioteca de plantillas de Resource Manager en Azure Blueprints.
¿En qué difiere de 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.
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. Admite la gobernanza de la nube al validar que los recursos de una suscripción cumplen los requisitos y estándares.
La inclusión de una directiva en un plano técnico permite crear el patrón o diseño adecuado durante la asignación del plano. 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.
Se puede incluir una directiva como uno de muchos artefactos en una definición de plano técnico. Los planos técnicos también permiten usar parámetros con las directivas y las iniciativas.
Definición del plano técnico
Un plano técnico se compone de artefactos. Azure Blueprints admite actualmente los siguientes recursos como artefactos:
| Recurso | Opciones de jerarquía | Descripción |
|---|---|---|
| Grupos de recursos | Subscription | Cree un nuevo grupo de recursos para que lo usen otros artefactos incluidos en el plano técnico. 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 Resource Manager. |
| Plantilla ARM | Suscripción, grupo de recursos | Las plantillas, incluidas las plantillas anidadas y vinculadas, se usan para crear entornos complejos. Ejemplo de entornos: una granja de servidores SharePoint, Azure Automation State Configuration o un área de trabajo de Log Analytics. |
| Asignación de directiva | Suscripción, grupo de recursos | Permite la asignación de una directiva o iniciativa a la suscripción a la que está asignado el plano técnico. La directiva o iniciativa debe estar dentro del ámbito de la ubicación de la definición del plano técnico. Si la directiva o iniciativa tiene parámetros, estos se asignan en la creación del plano técnico o durante su asignación. |
| Asignación de roles | Suscripción, grupo de recursos | 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. 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. |
Nota
Cada artefacto debe tener 2 MB o menos. Si el artefacto supera este valor, se producirá un error HTTP 500 (error interno del servidor).
Ubicaciones de definición de plano técnico
Al crear una definición de plano técnico, definirá dónde se guarda. Los planos técnicos se pueden guardar en un grupo de administración o suscripción a los que tenga acceso de colaborador. 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.
Parámetros de plano técnico
Los planos técnicos pueden pasar parámetros a una directiva o iniciativa, o bien a una plantilla de ARM. Cuando algún artefacto se agrega a un plano técnico, el autor decide si proporciona un valor definido para cada asignación de plano técnico o si permite que cada asignación de plano técnico proporcione un valor en el momento de la asignación. 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.
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.
Para más información, consulte el artículo sobre los parámetros de un plano técnico.
Publicación de planos técnicos
Cuando se crea por primera vez un plano técnico, se considera que está en modo borrador. Cuando está preparado para asignarse, se debe publicar. 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. La versión la diferencia de los cambios futuros del mismo plano técnico y permite la asignación de cada versión. Esto también significa que a la misma suscripción se le pueden asignar versiones diferentes del mismo plano técnico. Cuando se realizan cambios adicionales en el plano técnico, la versiónpublicada sigue existiendo, al igual que los cambios sin publicar. 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.
Asignación de plano técnico
Cada versión publicada de un plano técnico (con una longitud máxima del nombre de 90 caracteres) se puede asignar a un grupo de administración o una suscripción existentes. En el portal, el plano técnico tiene de forma predeterminada la versiónpublicada más recientemente. Si hay parámetros de artefacto o parámetros de plano técnico, se definirán durante el proceso de asignación.
Nota
Asignar una definición de plano técnico a un grupo de administración significa que el objeto de asignación existe en el grupo de administración. La implementación de artefactos sigue teniendo como destino una suscripción. Para realizar una asignación de grupo de administración, se debe usar la API REST para crear o actualizar y el cuerpo de la solicitud debe incluir un valor para properties.scope para definir la suscripción de destino.
Permisos de Azure Blueprint
Para poder utilizar planos técnicos, se le deben conceder permisos mediante el control de acceso basado en rol de Azure (Azure RBAC). Para leer o ver un plano técnico en Azure Portal, la cuenta debe tener acceso de lectura al ámbito en que se encuentra la definición del mismo.
Para crear planos técnicos, su cuenta necesita los siguientes permisos:
Microsoft.Blueprint/blueprints/write: para crear una definición de plano técnicoMicrosoft.Blueprint/blueprints/artifacts/write: para crear artefactos en una definición de plano técnicoMicrosoft.Blueprint/blueprints/versions/write: para publicar un plano técnico
Para eliminar planos técnicos, su cuenta necesita los siguientes permisos:
Microsoft.Blueprint/blueprints/deleteMicrosoft.Blueprint/blueprints/artifacts/deleteMicrosoft.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.
Para asignar o cancelar la asignación de un plano técnico, la cuenta necesita los siguientes permisos:
Microsoft.Blueprint/blueprintAssignments/write: para asignar un plano técnicoMicrosoft.Blueprint/blueprintAssignments/delete: para cancelar la asignación de un plano técnico
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.
Están disponibles los siguientes roles integrados:
| Rol de Azure | Descripción |
|---|---|
| Propietario | Además de otros permisos, incluye todos los permisos relacionados con Azure Blueprints. |
| Colaborador | Además de otros permisos, puede crear y eliminar definiciones de planos técnicos, pero no tiene permisos para asignarlos. |
| Colaborador de plano técnico | Puede administrar las definiciones del plano técnico, pero no asignarlas. |
| Operador del plano técnico | Puede asignar los planos técnicos publicados existentes, pero no puede crear nuevos. Las asignaciones solo funcionan si se realizan con una identidad administrada asignada por el usuario. |
Si estos roles integrados no satisfacen sus necesidades de seguridad, considere la posibilidad de crear un rol personalizado.
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. Si usa el portal, este rol se le concede automáticamente y se revoca para la implementación. 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. Si usa una identidad administrada asignada por el usuario, solo el usuario que crea la asignación de planos necesita el permiso Microsoft.Blueprint/blueprintAssignments/write, que se incluye en los roles integrados Propietario y Operador de planos.
Límites de nomenclatura
Existen las siguientes limitaciones para determinados campos:
| Object | Campo | Caracteres permitidos | Máx. Length |
|---|---|---|---|
| Plano técnico | Nombre | letras, números, guiones y caracteres de subrayado | 48 |
| Plano técnico | Versión | letras, números, guiones y puntos | 20 |
| Asignación de plano técnico | Nombre | letras, números, guiones y caracteres de subrayado | 90 |
| Artefactos de plano técnico | Nombre | letras, números, guiones y puntos | 48 |
Introducción en vídeo
La siguiente introducción sobre Azure Blueprints es de 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.