Compartir vía

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

La CLI para desarrolladores de Azure (azd) está diseñada para simplificar el flujo de trabajo de desarrollador de un extremo a otro en Azure. azd proporciona comandos de alto nivel que actúan como abstracciones para simplificar tareas comunes para desarrolladores, como la inicialización del proyecto, el aprovisionamiento de infraestructura, la implementación de código y la supervisión. Los comandos azd están disponibles en el terminal, un entorno de desarrollo integrado (IDE) o a través de canalizaciones de CI/CD (integración continua o implementación continua). En este artículo, obtendrá información sobre lo siguiente:

  • Conceptos esenciales de comandos de azd
  • Comparación de comandos de azd con otras herramientas
  • Relación entre comandos y plantillas de azd
  • Comandos de azd comunes y qué tareas de desarrollo aceleran

Nota

Consulte la guía de inicio rápido Implementación de la plantilla de Azure Developer CLI para explorar un flujo de trabajo de un comando de ejemplo con más detalle.

Comparación de comandos de la CLI para desarrolladores de Azure

El énfasis en las fases de desarrollo de alto nivel diferencia los comandos azd de otras herramientas de línea de comandos, como la CLI de Azure o Azure PowerShell. Mientras que esas herramientas proporcionan numerosos comandos para el control pormenorizado sobre configuraciones y recursos individuales de Azure, azd proporciona menos comandos más amplios para automatizar tareas de desarrollo de nivel superior, como aprovisionar varios recursos o implementar varios servicios a la vez.

En la tabla siguiente se resaltan las diferencias entre un comando de azd de ejemplo y otras herramientas de línea de comandos de Azure. Tenga en cuenta que el comando azd provision realiza numerosas tareas a la vez y no tiene un equivalente directo en estas otras herramientas. Se necesitarían muchos comandos de la CLI de Azure o PowerShell para realizar la misma tarea.

Herramienta Comando de ejemplo Resultado
CLI para desarrolladores de Azure azd provision Aprovisiona varios recursos de Azure necesarios para una aplicación en función de los recursos y configuraciones del proyecto, como un grupo de recursos de Azure, una aplicación web de Azure App Service y un plan de App Service, una cuenta de Azure Storage y una instancia de Azure Key Vault.
CLI de Azure az webapp create --resource-group myResourceGroup --plan myAppServicePlan --name myWebApp Se aprovisiona una nueva aplicación web en el grupo de recursos y plan de servicio de aplicaciones especificados.
Azure PowerShell New-AzWebApp -ResourceGroupName "myResourceGroup" -Name "myWebApp" -AppServicePlan "myAppServicePlan" Se aprovisiona una nueva aplicación web en el grupo de recursos y plan de servicio de aplicaciones especificados.

Comandos y plantillas de la CLI para desarrolladores de Azure

Los comandos azd son capaces de realizar tareas de flujo de trabajo más amplias debido a su integración con el sistema de plantillas de azd. plantillas de la CLI para desarrolladores de Azure son proyectos de código que se adhieren a las convenciones estructurales de azd e incluyen código de aplicación de ejemplo, archivos de infraestructura y archivos de configuración. La mayoría de las plantillas de azd incluyen lo siguiente:

  • .azure carpeta: contiene configuraciones esenciales de Azure y variables de entorno, como la ubicación para implementar recursos u otra información de suscripción.
  • Carpeta infra: contiene toda la infraestructura de Bicep o Terraform como archivos de código para la plantilla azd.
  • src carpeta: contiene todo el código fuente de la aplicación que se puede implementar.
  • azure.yaml archivo: un archivo de configuración que define uno o varios servicios del proyecto y los asigna a los recursos de Azure definidos en la carpeta infra para la implementación.

Captura de pantalla que muestra una estructura de plantilla de la CLI para desarrolladores de Azure.

Sin azd comandos, estas plantillas son solo repositorios de código estándar. Básicamente, azd plantillas sirven como planos técnicos fundamentales, mientras que los comandos de la CLI actúan como motor que impulsa la implementación, la administración y la supervisión de las aplicaciones. Los comandos azd usan los recursos de estas plantillas para realizar diversas tareas.

Con la plantilla anterior como ejemplo:

  • El comando azd provision crea recursos en Azure mediante los archivos de infraestructura como código de la carpeta infra de una plantilla.
  • El comando azd deploy implementa una aplicación o un servicio definidos en la carpeta src.

Nota

azd también puede crear y administrar algunos recursos de Azure sin necesidad de definir plantillas de infraestructura como código manualmente mediante la nueva característica de azd compose, que se encuentra actualmente en alfa.

Exploración de comandos comunes

En las secciones siguientes se proporciona información general sobre algunos de los comandos de azd más comunes para proporcionar ejemplos de cómo trabajar con plantillas y diferentes tareas de desarrollo.

Nota

Para obtener una lista completa de los comandos azd y sus parámetros, consulte la página Referencia de Azure Developer CLI.

Inicialización y ejecución de una plantilla

  • azd init: inicializa una plantilla de azd existente o crea e inicializa una nueva plantilla. Este comando configura básicamente los archivos y directorios necesarios para empezar a trabajar con azd.
  • azd up: un comando cómodo para aprovisionar, empaquetar e implementar todos los recursos de la aplicación en un solo comando. Este comando es el equivalente de ejecutar azd provision, azd packagey azd deploy individualmente.

Aprovisionamiento de infraestructura

  • azd provision: aprovisiona los recursos de Azure necesarios, como las instancias de Azure Container App o las cuentas de Azure Storage basadas en plantillas de infraestructura como código o recursos definidos en azure.yaml.

Implementación de código

  • azd package: empaqueta el código de la aplicación que se va a implementar en Azure.
  • azd deploy: implementa el código de la aplicación en los recursos creados por el comando azd provision.

Supervisión y administración

  • azd monitor: proporciona información sobre el estado y el rendimiento de la aplicación implementada.

Configuración de la tubería CI/CD

  • azd pipeline config: configura una canalización de CI/CD para el proyecto. Este comando configura canalizaciones de integración continua e implementación continua para automatizar los procesos de compilación e implementación.

Administración del entorno

  • azd env list: enumera todos los distintos entornos (por ejemplo, desarrollo, ensayo, producción) que se han configurado para la plantilla.
  • azd env new: crea un nuevo entorno con su propia configuración y recursos, lo que le permite administrar varios entornos para distintas fases de desarrollo.

Limpieza de recursos

  • azd down: elimina los recursos de Azure creados por la plantilla para limpiar el entorno y evitar costos innecesarios.

Pasos siguientes

¿Qué son las plantillas de la CLI para desarrolladores de Azure?

  • Last updated on