Compartir a través de

Introducción a los entornos de la CLI para desarrolladores de Azure

La CLI para desarrolladores de Azure (azd) permite administrar varios entornos de implementación para los proyectos, para mantener las configuraciones independientes para el desarrollo, las pruebas y la producción. En este artículo se explican los conceptos esenciales sobre cómo puede usar entornos para administrar el proceso de desarrollo e implementación.

¿Qué son los entornos?

Un entorno de la CLI para desarrolladores de Azure (azd) es un conjunto con nombre de configuraciones para una implementación de la aplicación, como desarrollo, prueba o prod. Se pueden configurar diferentes entornos con valores diferentes. Los entornos sirven para varios propósitos importantes:

  • Aislamiento: mantenga independientes las implementaciones de desarrollo, pruebas y producción.
  • Administración de configuración: mantenga diferentes opciones de configuración para cada entorno.
  • Colaboración: habilite a los miembros del equipo para que trabajen con sus propios entornos.
  • Organización de recursos: aprovisione y aprovisione recursos de Azure por entorno.
  • Reproducibilidad: garantice implementaciones coherentes en distintas fases.

Cada entorno tiene sus propios valores de configuración y grupo de recursos de Azure. Este aislamiento del entorno ayuda a evitar que los cambios de un entorno afecten a otros.

Estructura y configuración del entorno

Los entornos de la CLI para desarrolladores de Azure (azd) residen en una estructura de directorios dentro del proyecto:

├── .azure                          [Created when you run azd init or azd up]
│   ├── <environment-name-1>        [Directory for environment-specific configurations]
│   │   ├── .env                    [Environment variables for this environment]
│   │   └── config.json             [Additional configuration parameters for this environment]
│   ├── <environment-name-2>        [Another environment]
│   │   ├── .env                    
│   │   └── config.json
│   └── config.json                 [Global azd configuration]

Los componentes clave de esta estructura son:

  • .azure directory: directorio raíz para todas las configuraciones de entorno. Se excluye del control de código fuente por el .gitignore archivo de forma predeterminada.
  • Directorios específicos del entorno: directorios denominados después de los entornos, como dev, test, prod.
  • .env file: contiene variables específicas del entorno usadas por la aplicación y durante la implementación.
  • config.json: se usa para controlar la configuración que influye en azd el comportamiento y las características de los comandos. Este archivo no está pensado para que los usuarios finales los usen directamente.

Nombres de entorno

La nomenclatura del entorno suele seguir estos patrones:

  • Proyectos de equipo: <project-name-[dev/int/prod]>
  • Proyectos personales: <personal-unique-alias-[dev/int/prod]>

El usuario no aplica azd estas convenciones de nomenclatura y las puede configurar.

Variables de entorno

Las variables de entorno de la CLI para desarrolladores de Azure proporcionan una manera de almacenar las opciones de configuración que influyen y pueden variar entre entornos. Al ejecutar comandos de la CLI para desarrolladores de Azure, estas variables se usan para:

  • Configure las opciones de la aplicación, como los puntos de conexión para los servicios de Azure.
  • Defina parámetros de infraestructura para influir en el proceso de aprovisionamiento.

El .env archivo contiene estas variables en un formato estándar:

AZURE_ENV_NAME=dev
AZURE_LOCATION=eastus
AZURE_SUBSCRIPTION_ID=00000000-0000-0000-0000-000000000000
AZURE_RESOURCE_GROUP=rg-dev-12345
SERVICE_WEB_HOSTNAME=web-dev-12345.azurewebsites.net
SERVICE_API_HOSTNAME=api-dev-12345.azurewebsites.net

Entre las variables de entorno comunes se incluyen:

Variable Descripción
AZURE_ENV_NAME Nombre del entorno actual
AZURE_LOCATION Región de Azure donde se implementan los recursos
AZURE_SUBSCRIPTION_ID Identificador de la suscripción de Azure que se usa para este entorno
AZURE_RESOURCE_GROUP Nombre del grupo de recursos para este entorno

Sugerencia

Para ver otras variables de entorno comunes y ejemplos específicos del servicio, visite la documentación de variables de entorno .

Al trabajar con variables de entorno:

  • Evite confirmar .env archivos en el control de código fuente. Si es necesario conservar o compartir la configuración del entorno, los usuarios deben usar entornos remotos.
  • Use nombres coherentes entre entornos.
  • Use el azd env set comando para actualizar variables de forma segura.

Advertencia

Nunca almacene secretos en un archivo de la CLI .env para desarrolladores de Azure. Estos archivos se pueden compartir o copiar fácilmente en ubicaciones no autorizadas o se pueden comprobar en el control de código fuente. Use servicios como Azure Key Vault o Control de acceso basado en rol de Azure (RBAC) para soluciones protegidas o sin secretos.

Comparación de otros entornos de marco

Muchos marcos de programación y herramientas como Node.js, Django o React usan .env archivos para la configuración. Aunque la CLI para desarrolladores de Azure (azd) también usa .env archivos, hay diferencias importantes:

Concepto CLI para desarrolladores de Azure .env Archivos de marco .env
Ubicación Almacenado en .azure/<environment-name>/.env Normalmente se almacena en el directorio raíz del proyecto
Compatibilidad con entornos Compatibilidad con varios entornos definidos por el usuario (desarrollo, prueba, prod) A menudo se requieren convenciones manuales de cambio de archivos o nomenclatura (.env.development, .env.production)
Mecanismo de carga Cargado automáticamente por azd comandos Normalmente, se requiere una carga explícita en el código de aplicación o los scripts de compilación
Integración Profundamente integrado con los servicios de Azure y el aprovisionamiento de recursos Configuración de uso general, no específica de Azure
Administración de variables Administrado a través de azd env comandos Normalmente se edita manualmente o a través de scripts personalizados

Aunque ambos sirven para propósitos similares, el enfoque de la CLI para .env desarrolladores de Azure agrega estructura y herramientas diseñadas para administrar varios entornos de implementación y recursos de Azure.

Nota:

Si el proyecto ya usa archivos específicos .env del marco de trabajo, puede mantener ambos sistemas de configuración sin conflictos. azd Las variables de entorno invalidan las variables de entorno del sistema con el mismo nombre para algunas operaciones.

Pasos siguientes

Trabajar con entornos

Administración de variables de entorno en la CLI para desarrolladores de Azure

  • Last updated on