Instalación o actualización de la CLI para desarrolladores de Azure

Le damos la bienvenida a la CLI para desarrolladores de Azure (azd)! Vamos a empezar a instalar y aprender a ejecutar azd.

Para empezar, seleccione el entorno de desarrollo. Para obtener más información sobre las ventajas y desventajas de las distintas opciones del entorno de desarrollo, consulte Azure entornos compatibles con la CLI para desarrolladores (azd).

Para obtener instrucciones e escenarios de instalación más avanzados, consulte Azure Scripts del instalador de la CLI para desarrolladores.

Nota: Al instalar azd, las siguientes herramientas se instalan dentro azd del ámbito (lo que significa que no se instalan globalmente) y se quitan si se desinstala azd:

Instalar azd

winget install microsoft.azd

Actualización azd

winget upgrade microsoft.azd

Desinstalar azd

winget uninstall microsoft.azd

Nota:

En Apple Silicon Macs (M1 y M2) azd requiere Rosetta 2. Si Rosetta 2 aún no está instalado, ejecute softwareupdate --install-rosetta desde el terminal.

El azd proceso de instalación elegirá automáticamente el binario correcto para la arquitectura de la máquina.

Instalar azd

brew install azure/azd/azd

Si usa brew para actualizar azd desde una versión no instalada mediante brew, quite la versión existente de azd mediante el script de desinstalación (si se instala en la ubicación predeterminada) o elimine el azd archivo binario manualmente. Esto instalará automáticamente la versión correcta.

Actualización azd

brew upgrade --cask azure/azd/azd

Desinstalar azd

brew uninstall azd

Instalar azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Actualización azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Al instalar azd, las siguientes herramientas se instalan dentro azd del ámbito (lo que significa que no se instalan globalmente) y se quitan si se desinstala azd:

Desinstalar azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

Prerrequisitos

Antes de empezar a usar azd, asegúrese de que tiene:

Instalar azd en un contenedor de desarrollo

Un contenedor de desarrollo es una imagen de Docker que incluye todos los requisitos previos necesarios para ejecutar una aplicación en el equipo local. Instale azd como una característica en el contenedor de desarrollo mediante los pasos siguientes:

  1. Agregue la azd característica al devcontainer.json archivo de la .devcontainer carpeta en la raíz de la plantilla.

    {
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        // See https://containers.dev/features for list of features
        "ghcr.io/devcontainers/features/docker-in-docker:2": {
        },
        "ghcr.io/azure/azure-dev/azd:latest": {}
    }
    // Rest of file omitted...
}

  2. Recompile y ejecute el contenedor de desarrollo. En Visual Studio Code, use la paleta de comandos para ejecutar el comando Reconstruir y Reabrir en Contenedor de Desarrollo.

Instalación automática de extensiones azd

La azd característica de contenedor de desarrollo admite una extensions opción para instalar automáticamente una lista separada por comas de azd extensiones durante la compilación del contenedor. Las extensiones instaladas de esta manera están disponibles en cuanto se inicia el contenedor, lo que reduce la configuración manual y habilita la ejecución azd de comandos con las extensiones necesarias ya instaladas.

Para instalar automáticamente las extensiones, agregue la extensions opción a la entrada de características en azd el devcontainer.json archivo:

{
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        "ghcr.io/azure/azure-dev/azd:latest": {
            "extensions": "my-ext-1,my-ext-2"
        }
    }
}

El extensions valor es una lista separada por comas de nombres de azd extensión. La instalación se produce durante la compilación del contenedor, por lo que las extensiones están listas para usarse tan pronto como se inicie el contenedor. Después de cambiar la lista de extensiones, use el comando Rebuild y Reopen in Dev Container en Visual Studio Code para recompilar el contenedor con las extensiones actualizadas.

Obtenga más información sobre azd Dev Container Feature.

Compruebe la instalación

Compruebe que la azd instalación se completó correctamente ejecutando el azd version comando en un terminal:

azd version

azd imprime la versión actual:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Actualización de la CLI para desarrolladores de Azure

Puede actualizar azd mediante el comando integrado azd update (Beta) o manualmente mediante el mismo método que usó para instalarlo.

Usar azd update (Beta)

El azd update comando detecta cómo azd se instaló originalmente y delega automáticamente al método de actualización adecuado:

Método de instalación ¿Qué hace?azd update
winget Ejecuta winget upgrade Microsoft.Azd
choco Ejecuciones choco upgrade azd
Instalar un script o MSI (Windows) Ejecuta install-azd.ps1 con copia de seguridad y restauración automáticas
Script de instalación (Linux/macOS) Ejecuciones install-azd.sh
Homebrew Ejecuciones brew upgrade --cask azure/azd/azd
.deb / .rpm paquete Descarga y reemplaza directamente el archivo binario

Ejecute el siguiente comando para actualizar a la versión estable más reciente:

azd update

Nota:

El azd update comando está actualmente en beta. Obtenga más información sobre el soporte de características alfa y beta en la página de estrategia de versionado y lanzamiento de características.

Cambiar canales de actualización

azd admite dos canales de actualización: stable (valor predeterminado) y daily. El cambio de canal es compatible con las instalaciones basadas en scripts y Homebrew. Si ha instalado azd a través de winget o choco, las compilaciones diarias no están disponibles a través de esos administradores de paquetes — azd update mostrará instrucciones para reinstalar primero a través del script.

Para cambiar al daily canal y actualizar:

azd update --channel daily

Para volver al stable canal:

azd update --channel stable

Al cambiar de canal, azd se solicita confirmación antes de continuar.

Usa un administrador de paquetes o un script de instalación

También puede actualizar manualmente en cualquier momento mediante el mismo administrador de paquetes o comandos de script de instalación que se muestran en las secciones de instalación anteriores. Cuando azd no está actualizado, muestra un mensaje de advertencia con el comando de actualización aplicable para el método de instalación.

Solicitar ayuda

Para obtener información sobre cómo archivar un error, solicitar ayuda o proponer una nueva característica para la CLI para desarrolladores de Azure, visite la página troubleshooting and support.

Pasos siguientes

Inicio rápido: Selección e implementación de una plantilla azd

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

Preguntas más frecuentes sobre la CLI para desarrolladores de Azure

  • Last updated on