Procedimientos recomendados para catálogos del entorno de implementación de Azure

En este artículo se describen las instrucciones de procedimientos recomendados para estructurar un catálogo de Azure Deployment Environments.

Estructuración del catálogo para un almacenamiento en caché eficaz

Como ingeniero de plataforma, debe estructurar el catálogo de forma que sea más fácil y rápido para Azure Deployment Environments encontrar y almacenar en caché las definiciones de entorno de forma eficiente. Al organizar el repositorio en una estructura específica, puede dirigirse mejor a los archivos para almacenar en caché y mejorar el rendimiento general del proceso de implementación. Es esencial que los ingenieros de plataforma comprendan estas directrices y estructuren sus repositorios en consecuencia para garantizar resultados óptimos.

Al adjuntar un catálogo a un centro de desarrollo, Deployment Environments examina el catálogo de un archivo environment.yaml. Al localizar el archivo, ADE asume que los archivos de esa carpeta y subcarpeta forman una definición de entorno. ADE almacena en caché solo los archivos necesarios, no todo el repositorio.

En el siguiente diagrama se muestra la estructura recomendada para un repositorio. Cada plantilla reside dentro de una sola carpeta.

Diagrama que muestra la estructura de carpetas recomendada para un catálogo de Azure Deployment Environments.

Definiciones de entorno vinculado

En un escenario de definiciones de entorno vinculado, varios archivos de .json pueden apuntar a una sola plantilla. ADE comprueba las definiciones de entorno vinculadas secuencialmente y recupera los archivos vinculados y las definiciones de entorno del repositorio. Para obtener el mejor rendimiento, estas interacciones deben minimizarse.

Actualización de definiciones de entorno y cambios de sincronización

Con el tiempo, las definiciones de entorno necesitan actualizaciones. Estas actualizaciones se realizan en el repositorio de Git, y luego debe sincronizar manualmente el catálogo para actualizar los cambios en ADE.

En el siguiente ejemplo, el archivo Azuredeploy.json está por encima del archivo environment.yaml en la estructura de carpetas. Esta estructura no es válida para los catálogos de Azure Deployment Environments. Las definiciones de entorno no pueden hacer referencia al contenido fuera de la carpeta de elementos de catálogo.

Diagrama que muestra una estructura no admitida para un catálogo de Azure Deployment Environments, con un archivo JSON en una carpeta por encima del archivo environment.yaml.