Creación de un entorno mediante Azure Developer CLI
Artikulua
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).
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.
En Visual Studio 2022 17.3 versión preliminar 2 o posterior, puede habilitar la integración con azd como característica en versión preliminar.
Para habilitar la característica azd, vaya a Herramientas>Opciones>Entorno>Característica en vista previa y seleccione Integración con azd, Azure Developer CLI.
Cuando la característica está habilitada, puede usar la CLI para desarrolladores de Azure Developer CLI desde el terminal que prefiera en Windows, Linux o macOS.
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.
La salida de los comandos emitidos desde la paleta de comandos se muestra en un terminal azd dev como en el ejemplo siguiente:
Inicie sesión en Azure en la CLI con el comando siguiente:
azd auth login
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.
Para abrir el símbolo del sistema para desarrolladores:
En el menú Herramientas, seleccione Terminal.
En la ventana Terminal, seleccione Símbolo del sistema para desarrolladores.
Inicie sesión en AZD mediante el terminal de comandos para desarrolladores:
azd auth login
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.
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.
En Visual Studio Code, abra la carpeta que contiene el código de la aplicación.
Abra la paleta de comandos y escriba Azure Developer CLI init y, a continuación, en la lista, seleccione Azure Developer CLI (azd): init.
En la lista de plantillas, para continuar sin seleccionar una plantilla, presione ENTRAR dos veces.
En el terminal AZD, seleccione Usar código en el directorio actual.
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.
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.
Escriba un nombre para el entorno de AZD local.
azd init muestra una lista de los proyectos a los que tiene acceso. Selección del proyecto para el entorno
azd init muestra una lista de definiciones de entorno en el proyecto. Seleccione una definición de entorno.
AZD crea los recursos del proyecto, incluido un archivoazure.yaml en la raíz del proyecto.
En la CLI, vaya a la carpeta que contiene el código de la aplicación.
Ejecute el siguiente comando para inicializar la aplicación y proporcionar información cuando se le solicite:
azd init
En el terminal AZD, seleccione Usar código en el directorio actual.
AZD examina el directorio actual y recopila más información en función del tipo de aplicación que esté compilando. Siga las indicaciones para configurar el entorno de AZD.
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.
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.
Escriba un nombre para el entorno de AZD local.
azd init muestra una lista de los proyectos a los que tiene acceso. Seleccione el proyecto para su entorno.
azd init muestra una lista de definiciones de entorno en el proyecto. Seleccione una definición de entorno.
AZD crea los recursos del proyecto, incluido un archivoazure.yaml en la raíz del proyecto.
En la CLI, vaya a la carpeta que contiene el código de la aplicación.
Ejecute el siguiente comando para inicializar la aplicación y proporcionar información cuando se le solicite:
azd init
En el terminal AZD, seleccione Usar código en el directorio actual.
AZD examina el directorio actual y recopila más información en función del tipo de aplicación que esté compilando. Siga las indicaciones para configurar el entorno de AZD.
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.
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.
Escriba un nombre para el entorno de AZD local.
azd init muestra una lista de los proyectos a los que tiene acceso. Seleccione el proyecto para su entorno.
azd init muestra una lista de definiciones de entorno en el proyecto. Seleccione una definición 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.
En el Explorador, haga clic con el botón derecho en azure.yaml y seleccione Azure Developer CLI (azd)>Aprovisionar recursos de Azure (aprovisionamiento).
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:
Proyecto
Definición del entorno
Tipo de entorno
Location
AZD indica a ADE que cree un nuevo entorno en función de la información que proporcionó en el paso anterior.
Aprovisione la aplicación en Azure mediante el siguiente comando:
azd provision
"azd provision" proporciona una lista de proyectos a los que tiene acceso. Seleccione el proyecto al que desea aprovisionar la aplicación.
"azd provision" proporciona una lista de definiciones de entorno en el proyecto seleccionado. Seleccione la definición de entorno que desea usar para aprovisionar la aplicación.
"azd provision" proporciona una lista de tipos de entorno en el proyecto seleccionado. Seleccione el tipo de entorno que desea usar para aprovisionar la aplicación.
AZD indica a ADE que cree un nuevo entorno en función de la información que proporcionó en el paso anterior.
Aprovisione la aplicación en Azure mediante el siguiente comando:
azd provision
"azd provision" proporciona una lista de proyectos a los que tiene acceso. Seleccione el proyecto al que desea aprovisionar la aplicación.
"azd provision" proporciona una lista de definiciones de entorno en el proyecto seleccionado. Seleccione la definición de entorno que desea usar para aprovisionar la aplicación.
"azd provision" proporciona una lista de tipos de entorno en el proyecto seleccionado. Seleccione el tipo de entorno que desea usar para aprovisionar la aplicación.
AZD indica a ADE que cree un nuevo entorno en función de la información que proporcionó en el paso anterior.
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).
Se le pedirá que seleccione un proyecto y una definición de entorno.
Use el siguiente comando para ver los entornos a los que tiene acceso: el entorno de AZD local y el entorno remoto de Azure Deployment Environments.
azd env list
azd env list le pide que seleccione un proyecto y una definición de entorno.
Use el siguiente comando para ver los entornos a los que tiene acceso: el entorno de AZD local y el entorno remoto de Azure Deployment Environments.
azd env list
azd env list le pide 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.