Creación de un entorno mediante Azure Developer CLI

  • Artículo

En este artículo, instalará Azure Developer CLI (AZD), creará un nuevo entorno de implementación mediante el aprovisionamiento de la infraestructura de la aplicación en Azure Deployment Environments e implementará el código de la aplicación en el entorno de implementación aprovisionado.

Azure Developer CLI (AZD) es una herramienta de código abierto que acelera el tiempo necesario para obtener la aplicación desde el entorno de desarrollo local a Azure. AZD proporciona comandos descriptivos de procedimientos recomendados para desarrolladores que se asignan a las fases clave del flujo de trabajo, tanto si estuviera trabajando en el terminal, en el editor, como en el entorno de desarrollo integrado (IDE) o en CI/CD (integración continua/integración continua).

Para obtener información sobre cómo configurar AZD para trabajar con Azure Deployment Environments, consulte Uso de Azure Developer CLI con Azure Deployment Environments.

Requisitos previos

Debería hacer lo siguiente:

Preparación para trabajar con AZD

Cuando trabaja con AZD por primera vez, hay algunas tareas de configuración única que debe completar. Estas tareas incluyen la instalación de Azure Developer CLI, el inicio de sesión en su cuenta de Azure y la habilitación de la compatibilidad de AZD con Azure Deployment Environments.

Instalación de Azure Developer CLI

Al instalar azd, las herramientas azd se instalan dentro del ámbito azd en lugar de globalmente y se quitan si se desinstala azd. Para usar herramientas de azd en Visual Studio Code, instale la extensión.

Para habilitar las características de Azure Developer CLI en Visual Studio Code, instale la extensión Azure Developer CLI, versión v0.8.3. Seleccione el icono Extensiones de la barra Actividad, busque la Azure Developer CLI y, a continuación, seleccione Instalar.

Captura de pantalla de Visual Studio Code que muestra el comando Iniciar sesión en la paleta de comandos.

Inicio de sesión con Azure Developer CLI

Acceda a los recursos de Azure iniciando sesión. Al iniciar un inicio de sesión, se abre una ventana del explorador y se le pide que inicie sesión en Azure. Después de iniciar sesión, el terminal muestra un mensaje que indica que ha iniciado sesión en Azure.

Inicie sesión en AZD con la paleta de comandos:

Captura de pantalla de Visual Studio Code que muestra el panel Extensiones con Azure Developer CLI e Instalar resaltados.

La salida de los comandos emitidos desde la paleta de comandos se muestra en un terminal azd dev como en el ejemplo siguiente:

Captura de pantalla del terminal azd dev en la que se muestra el mensaje pulse cualquier tecla para cerrar.

Habilitación de la compatibilidad de AZD con ADE

Puede configurar AZD para aprovisionar e implementar recursos en los entornos de implementación mediante comandos estándar como azd up o azd provision. Cuando platform.type se establece en devcenter, todo el estado del entorno remoto de AZD y el aprovisionamiento usan componentes del centro de desarrollo. AZD usa una de las plantillas de infraestructura definidas en el catálogo del centro de desarrollo para el aprovisionamiento de recursos. En esta configuración, no se usa la carpeta de infraestructura en las plantillas locales.

Captura de pantalla de Visual Studio Code que muestra el comando Habilitar soporte técnico en la paleta de comandos.

Creación de un entorno a partir del código existente

Ahora está listo para crear un entorno en el que trabajar. Puede comenzar con el código en una carpeta local o puede clonar un repositorio existente. En este ejemplo, creará un entorno mediante código en una carpeta local.

Inicialización de una nueva aplicación

Al inicializar una nueva aplicación, se crean los archivos y las carpetas necesarios para que AZD trabaje con la aplicación.

AZD usa un archivo azure.yaml para definir el entorno. El archivo azure.yaml define y describe las aplicaciones y los tipos de recursos de Azure que usa la aplicación. Para más información sobre azure.yaml, consulte el esquema azure.yaml de la Azure Developer CLI.

  1. En Visual Studio Code, abra la carpeta que contiene el código de la aplicación.

  2. Abra la paleta de comandos y escriba Azure Developer CLI init y, a continuación, en la lista, seleccione Azure Developer CLI (azd): init.

    Captura de pantalla de la paleta de comandos de Visual Studio Code con Azure Developer CLI (azd): init resaltado.

  3. En la lista de plantillas, para continuar sin seleccionar una plantilla, presione ENTRAR dos veces.

  4. En el terminal AZD, seleccione Usar código en el directorio actual.

    Captura de pantalla del terminal de AZD en Visual Studio Code en la que se muestra el comando Usar código en el directorio actual.

  5. azd init identifica los servicios definidos en el código de la aplicación y le pide que confirme y continúe, quite un servicio o agregue un servicio. Seleccione Confirmar y continuar inicializando mi aplicación.

    Captura de pantalla que muestra el comando AZD init para confirmar y continuar, quitar un servicio o agregar un servicio.

  6. azd init continúa recopilando información para configurar su aplicación. Para esta aplicación de ejemplo, se le pedirá el nombre de la instancia de base de datos de MongoDB y los puertos en los que escuchan los servicios.

    Captura de pantalla que muestra el comando azd init para un nombre de base de datos.

  7. Escriba un nombre para el entorno de AZD local.

    Captura de pantalla que muestra el comando de azd init Enter a new environment (Escriba un nuevo nombre de entorno).

  8. azd init muestra una lista de los proyectos a los que tiene acceso. Selección del proyecto para el entorno

    Captura de pantalla que muestra el comando azd init Select project (Seleccionar proyecto).

  9. azd init muestra una lista de definiciones de entorno en el proyecto. Seleccione una definición de entorno.

    Captura de pantalla que muestra el comando azd init Select environment definitions (Seleccionar definiciones de entorno).

    AZD crea los recursos del proyecto, incluido un archivoazure.yaml en la raíz del proyecto.

Aprovisionamiento de la infraestructura en el entorno de implementación de Azure

Cuando esté listo, puede aprovisionar el entorno local en un entorno remoto de Azure Deployment Environments. Este proceso aprovisiona la infraestructura y los recursos definidos en la definición del entorno en el catálogo del centro de desarrollo.

  1. En el Explorador, haga clic con el botón derecho en azure.yaml y seleccione Azure Developer CLI (azd)>Aprovisionar recursos de Azure (aprovisionamiento).

    Captura de pantalla de Visual Studio Code con azure.yaml resaltado y el menú contextual de AZD con Azure Developer CLI y Entorno de aprovisionamiento resaltados.

  2. AZD examina los Azure Deployment Environments de los proyectos a los que tiene acceso. En el terminal de AZD, seleccione o escriba la siguiente información:

    1. Proyecto
    2. Definición del entorno
    3. Tipo de entorno
    4. Location

  3. AZD indica a ADE que cree un nuevo entorno en función de la información que proporcionó en el paso anterior.

  4. Puede ver los recursos creados en Azure Portal o en el portal para desarrolladores.

Enumeración de entornos existentes (opcional)

Compruebe que el entorno se crea enumerando los entornos existentes.

  1. En el Explorador, haga clic con el botón derecho en azure.yaml y, a continuación, seleccione Azure Developer CLI (azd)>Ver entornos locales y remotos (env list).

    Captura de pantalla de Visual Studio Code con azure.yaml resaltado y el menú contextual de AZD con Azure Developer CLI y Ver entornos locales y remotos resaltados.

    Se le pedirá que seleccione un proyecto y una definición de entorno.

Implementación de código en Azure Deployment Environments

Cuando se aprovisiona el entorno, puede implementar el código en el entorno.

  1. En el Explorador, haga clic con el botón derecho en azure.yaml y seleccione Azure Developer CLI (azd)>Implementar recursos de Azure (implementación).

    Captura de pantalla de Visual Studio Code con azure.yaml resaltado y el menú contextual de AZD con Azure Developer CLI e Implementar en Azure resaltados.

  2. Para comprobar que el código está implementado, seleccione las direcciones URL de punto de conexión enumeradas en el terminal de AZD.

Limpieza de recursos

Cuando haya terminado con su entorno, puede eliminar los recursos de Azure.

En el Explorador, haga clic con el botón derecho en azure.yaml y seleccione Azure Developer CLI (azd)>Eliminar recursos de Azure (fuera de servicio).

Captura de pantalla de Visual Studio Code con azure.yaml resaltado y el menú contextual de AZD con Azure Developer CLI y Eliminar implementación y recursos (abajo) resaltados.

Confirme que desea eliminar el entorno escribiendo y cuando se le solicite.

Contenido relacionado