Поделиться через


Установка или обновление интерфейса командной строки разработчика Azure

Добро пожаловать в интерфейс командной строки разработчика Azure (azd)! Давайте приступим к установке и обучению запуску azd.

Начните с выбора среды разработки. Дополнительные сведения о преимуществах и недостатках различных вариантов среды разработки см. в поддерживаемых средах Azure Developer CLI (azd).

Для более сложных сценариев установки и инструкций см. в разделе Скрипты установщика Azure CLI для разработчиков.

Примечание: При установке azd следующие средства устанавливаются в пределах области azd (то есть они не устанавливаются глобально) и удаляются при удалении azd.

Установите azd

winget install microsoft.azd

Обновить azd

winget upgrade microsoft.azd

Удалить azd

winget uninstall microsoft.azd

Замечание

Для Apple Silicon Macs (M1 и M2) azd требуется Rosetta 2. Если Rosetta 2 еще не установлен, выполните softwareupdate --install-rosetta из терминала.

Процесс azd установки автоматически выбирает правильный двоичный файл для архитектуры компьютера.

Установите azd

brew install azure/azd/azd

Если вы используете brew для обновления azd с версии, не установленной с помощью brew, удалите существующую версию azd, используя сценарий удаления (если установлена в расположение по умолчанию) или удалите двоичный файл azd вручную. Это автоматически установит правильную версию.

Обновить azd

brew upgrade azure/azd/azd

Удалить azd

brew uninstall azd

Установите azd

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

Обновить azd

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

При установке azd следующие средства устанавливаются в области azd (т. е. они не устанавливаются глобально) и удаляются при удалении azd:

Удалить azd

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

Предпосылки

Прежде чем приступить к использованию azd, убедитесь, что у вас есть следующие сведения:

Установка azd в контейнере разработки

Контейнер разработки — это образ Docker, включающий все необходимые компоненты, необходимые для запуска приложения на локальном компьютере. Установите azd как функцию в контейнере разработки, выполнив следующие действия.

  1. Добавьте функцию azd в файл devcontainer.json в папке .devcontainer в корневой папке шаблона.

    {
        "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. Перестройте и запустите контейнер разработки. В Visual Studio Code используйте палитру команд command palette для выполнения команды Перестроить и открыть заново в контейнере разработки.

Автоматическая установка расширений azd

Функция azd контейнера разработки поддерживает extensions возможность автоматической установки списка, разделенного запятыми, расширений azd во время сборки контейнера. Расширения, установленные таким образом, доступны сразу после запуска контейнера, что сокращает необходимость ручной настройки и позволяет выполнять команды azd с уже установленными расширениями.

Для автоматической установки расширений добавьте параметр extensions в запись функции azd в файл devcontainer.json :

{
    "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"
        }
    }
}

Это extensions значение представляет собой разделенный запятыми список имен расширений azd . Установка происходит во время сборки контейнера, и, как следствие, расширения готовы к использованию сразу после запуска контейнера. После изменения списка расширений используйте команду "Перестроить и повторно открыть" в Контейнере разработки в Visual Studio Code, чтобы перестроить контейнер с обновленными расширениями.

Узнайте больше о функции контейнера azd Dev.

Проверка установки

azd Убедитесь, что установка выполнена успешно, выполнив azd version команду в терминале:

azd version

azd выводит текущую версию:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Обновление интерфейса командной строки разработчика Azure

При работе с устаревшей версией azdвы увидите предупреждение об обновлении до последней версии. Следуйте инструкциям в предупреждении, чтобы обновить до последней версии.

Запрос помощи

Чтобы получить информацию о том, как сообщить об ошибке, запросить помощь или предложить новую функцию для интерфейса командной строки разработчика Azure (CLI), перейдите на страницу устранения неполадок и поддержки.

Дальнейшие шаги