Compartir a través de

Compatibilidad de la CLI para desarrolladores de Azure para entornos de implementación de Azure

  • Artículo

La CLI para desarrolladores de Azure (azd) proporciona compatibilidad con entornos de implementación de Azure. Un entorno de implementación de Azure (ADE) es una colección preconfigurada de recursos de Azure implementados en suscripciones predefinidas. La gobernanza de Azure se aplica a esas suscripciones en función del tipo de entorno, como el espacio aislado, las pruebas, el almacenamiento provisional o la producción. Con los entornos de implementación de Azure, puede aplicar directivas de seguridad empresariales y proporcionar un conjunto mantenido de plantillas predefinidas de infraestructura como código (IaC).

Prerrequisitos

Compruebe que ha completado los siguientes requisitos previos para trabajar con entornos de implementación de Azure mediante azd:

Habilitación de la compatibilidad con el entorno de implementación de Azure

Puede configurar azd para aprovisionar e implementar recursos en los entornos de implementación mediante comandos estándar, como azd up o azd provision. Para habilitar la compatibilidad con entornos de implementación de Azure, ejecute el siguiente comando:

azd config set platform.type devcenter

Cuando platform.type se establece en devcenter, todos los azd estado del entorno remoto y el aprovisionamiento aprovecharán los nuevos componentes del centro de desarrollo. Esta configuración también significa que la carpeta infra de las plantillas locales se omitirá de forma eficaz. En su lugar, azd usará una de las plantillas de infraestructura definidas en el catálogo del centro de desarrollo para el aprovisionamiento de recursos.

También puede deshabilitar la compatibilidad con el Centro de desarrollo mediante el siguiente comando:

azd config unset platform

Trabajar con entornos de implementación de Azure

Cuando la característica del centro de desarrollo está habilitada, el comportamiento predeterminado de algunos comandos comunes de azd cambia para trabajar con estos entornos remotos. La característica del centro de desarrollo se expande en la funcionalidad proporcionada por la compatibilidad estándar azdentorno remoto.

azd init

La experiencia de comandos azd init en modo centro de desarrollo muestra todas las plantillas de ADE compatibles con azd para la selección desde el catálogo configurado. Durante el proceso de inicialización, después de azd clone el código de plantilla, el archivo azure.yaml se actualizará automáticamente para incluir una sección de platform con la configuración seleccionada en función de la plantilla elegida. La configuración incluye el nombre del centro de desarrollo, el catálogo y la definición del entorno.

azd init

azd up

El comando azd up empaquetará, aprovisionará e implementará la aplicación en entornos de implementación de Azure. Sin embargo, la fase de aprovisionamiento del comando azd up usará las plantillas de infraestructura como código seleccionadas en el centro de desarrollo remoto, mientras que la fase de implementación implementará el código fuente en la plantilla de azd. Mientras el modo del centro de desarrollo está habilitado, azd omitirá la carpeta infra de la plantilla de azd local y solo aprovisionará recursos mediante las plantillas del Centro de desarrollo. El comando también le pedirá los valores necesarios, como el proyecto del entorno de implementación de Azure o el tipo de entorno.

azd up

azd template list

El comando azd template list mostrará las plantillas de infraestructura disponibles en el catálogo del centro de desarrollo, en lugar de mostrar plantillas de la galería predeterminada de AZD Awesome. Catálogos proporcionar un conjunto de plantillas de infraestructura como código seleccionadas y aprobadas que los equipos de desarrollo pueden usar para crear entornos.

azd template list

Captura de pantalla que muestra la galería de plantillas actualizada.

azd provision

El comando azd provision creará nuevos entornos del centro de desarrollo. El comando le pedirá los valores que faltan, como el tipo de entorno o el proyecto. Cuando se ejecute el comando, usará la plantilla de infraestructura asociada para aprovisionar el conjunto correcto de recursos de Azure para ese entorno. Mientras el modo del centro de desarrollo está habilitado, azd omitirá la carpeta infra de la plantilla de azd local y solo aprovisionará recursos mediante las plantillas del Centro de desarrollo.

azd provision

azd env list

El comando azd env list mostrará la misma lista de entornos que vería en el portal para desarrolladores.

azd env list

Etiquetado de recursos para entornos de implementación de Azure

azd aprovisionamiento para entornos de implementación de Azure se basa en plantillas seleccionadas del catálogo del centro de desarrollo. Las plantillas del catálogo pueden asignar o no etiquetas a los recursos de Azure aprovisionados para asociar los servicios de aplicaciones con en el archivo azure.yaml. Si las plantillas no asignan etiquetas, puede solucionar este problema de una de estas dos maneras:

  • Trabaje con el administrador del catálogo del Centro de desarrollo para asegurarse de que los recursos de Azure aprovisionados incluyen etiquetas para asociarlos a los servicios definidos en el archivo de azure.yaml.

  • Especifique el resourceName en el archivo azure.yaml en lugar de usar etiquetas:

    services:
    api:
        project: ./src/api
        host: containerapp
        language: js
        resourceName: sample-api-containerapp
    web:
        project: ./src/web
        host: containerapp
        language: js
        resourceName: sample-web-containerapp

Configuración de las opciones del centro de desarrollo

Puede definir azd configuración para los centros de desarrollo en varios lugares. La configuración se combina desde estas ubicaciones para crear el conjunto final de configuraciones en el siguiente orden de prioridad:

  1. Variables de entorno
  2. Configuración del entorno de Azd
  3. Configuración del proyecto
  4. Configuración del usuario

azd le pedirá automáticamente los valores de configuración que falten en estos orígenes. Cada una de estas opciones de configuración se detalla en las secciones siguientes.

Variables de entorno

Las siguientes variables de entorno se detectarán y usarán en azd:

  • AZURE_DEVCENTER_NAME
  • AZURE_DEVCENTER_PROJECT
  • AZURE_DEVCENTER_CATALOG
  • AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
  • AZURE_DEVCENTER_ENVIRONMENT_TYPE
  • AZURE_DEVCENTER_ENVIRONMENT_USER

Definición de configuraciones

Defina las configuraciones de los centros de desarrollo en el ámbito del entorno de azd en .azure/<env>/config.json archivo:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Ámbito del proyecto

Defina las configuraciones de los centros de desarrollo en el ámbito del proyecto de azd en el nodo platform del archivo azure.yaml:

name: todo-nodejs-mongo-aca
metadata:
    template: todo-nodejs-mongo-aca@0.0.1-beta
platform:
    type: devcenter
    config:
        catalog: SampleCatalog
        environmentDefinition: Todo
        name: sample-devcenter
        project: SampleProject
services:
    api:
        project: ./src/api
        host: containerapp
        language: js
    web:
        project: ./src/web
        host: containerapp
        language: js

Ámbito de usuario

Defina configuraciones para los centros de desarrollo en el ámbito de usuario en el archivo ~/<user_profile>/.azd/config.json:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}