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

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

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

Для более сложных сценариев установки и инструкций см. в разделе Сценарии установки Azure Developer 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 --cask 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 используйте палитру команд для выполнения командыПерестроить и открыть заново в контейнере разработки.

Автоматическая установка расширений 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 . Установка происходит во время сборки контейнера, и, как следствие, расширения готовы к использованию сразу после запуска контейнера. После изменения списка расширений используйте команду Rebuild и повторно открыть в контейнере разработки в Visual Studio Code, чтобы перестроить контейнер с обновленными расширениями.

Дополнительные сведения о функции контейнера azd Dev Container.

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

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

azd version

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

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

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

Можно обновить azd с помощью встроенной команды (бета-версии azd update ) или вручную с помощью того же метода, который использовался для его установки.

Используйте azd update (бета-версия)

Команда azd update определяет, как azd изначально установлен и делегирует соответствующему автоматически методу обновления.

Метод установки Что azd update делает
winget Выполняется winget upgrade Майкрософт.Azd
choco Работает choco upgrade azd
Установите скрипт или MSI (Windows) Выполняется install-azd.ps1 с автоматическим резервным копированием и восстановлением
Установка скрипта (Linux или macOS) Работает install-azd.sh
Homebrew Работает brew upgrade --cask azure/azd/azd
.deb / .rpm Пакет Непосредственно скачивает и заменяет двоичный файл

Выполните следующую команду, чтобы обновить последнюю стабильную версию:

azd update

Замечание

В настоящее время команда azd update находится в бета-версии. Дополнительные сведения о поддержке альфа-и бета-компонентов см. на странице стратегии управления версиями компонентов и выпуска .

Переключение каналов обновления

azd поддерживает два канала обновления: stable (по умолчанию) и daily. Переключение каналов поддерживается для установок на основе скриптов и Homebrew. Если вы установили azd через winget или choco, ежедневные сборки недоступны через эти диспетчеры пакетов — azd update будет отображать рекомендации по переустановке посредством скрипта.

Чтобы переключиться на daily канал и обновить:

azd update --channel daily

Чтобы вернуться к каналу stable , выполните следующие действия.

azd update --channel stable

При переключении каналов azd выдаёт запрос на подтверждение перед продолжением.

Использование диспетчера пакетов или скрипта установки

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

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

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

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

Быстрый старт — выбор и развертывание шаблона azd

Что такое шаблоны Azure Developer CLI?

Azure Вопросы и ответы о интерфейсе командной строки разработчика

  • Last updated on