Creación de un entorno mediante Azure Developer CLI
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:
- Familiarícese con Azure Deployment Environments Revise ¿Qué son los Azure Deployment Environments? y Conceptos clave de los Azure Deployment Environments.
- Cree y configure un centro de desarrollo con un proyecto, tipos de entorno y un catálogo. Use los siguientes artículos como guía:
- Un catálogo adjunto al centro de desarrollo.
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 la extensión de Azure Developer CLI para Visual Studio Code
Al instalar azd, las herramientas azd se instalan dentro del ámbito azd en lugar de globalmente y se quitan si se desinstala azd. Puede instalar azd en Visual Studio Code o desde la línea de comandos.
Para habilitar las características de Azure Developer CLI en Visual Studio Code, instale la extensión Azure Developer CLI, versión v0.8.0-alpha.1-beta.3173884. Seleccione el icono Extensiones de la barra Actividad, busque la Azure Developer CLI y, a continuación, seleccione Instalar.
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:
La salida de los comandos emitidos desde la paleta de comandos se muestra en un terminal azd dev como en el ejemplo siguiente:
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 entornoazd 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.
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.
Implementación de código en Azure Deployment Environments
Cuando se aprovisiona el entorno, puede implementar el código en el entorno.
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).
Confirme que desea eliminar el entorno escribiendo y
cuando se le solicite.
Contenido relacionado
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de