Использование Azure Developer CLI в национальных облаках

В этом руководстве объясняется, как настроить интерфейс командной строки разработчика Azure для подготовки ресурсов и развертывания приложений в разных облаках.

Интерфейс командной строки разработчика Azure поддерживает следующие облака:

  • Azure Public (AzureCloud) по умолчанию
  • Azure под управлением 21Vianet Cloud (AzureChinaCloud)
  • Azure для государственных организаций США (AzureUSGovernment)

Общедоступное облако Azure используется по умолчанию и используется, если облако не указано.

Аутентификация

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

В следующем примере устанавливается национальное облако и выполняется azd auth login для проверки подлинности в этом облаке:

azd config set cloud.name AzureUSGovernment
azd auth login

Облачные конфигурации

Облака можно настроить на уровне пользователя, проекта или среды. Порядок приоритета конфигурации:

  1. Сначала выбрана конфигурация среды
  2. Если в среде не настроено облако, используется конфигурация проекта (azure.yaml)
  3. Если в конфигурации проекта нет облака, используется конфигурация пользователя (azd config set)
  4. Если облако не задано в конфигурации пользователя, azd использует общедоступную AzureCloud

Настройка облаков с параметрами пользователя (azd config set)

Настройка облака для всех azd операций с помощью azd config

azd config set cloud.name AzureCloud
azd config set cloud.name AzureChinaCloud
azd config set cloud.name AzureUSGovernment

Настройка облаков в файле azure.yaml проекта

cloud Используйте объект, чтобы задать имя облака в файле azure.yaml проекта.

name: project-name
cloud:
  name: AzureCloud
name: project-name
cloud:
  name: AzureChinaCloud
name: project-name
cloud:
  name: AzureUSGovernment

Настройка облаков в файле config.json среды

Настройте облако для конкретных сред, обновив файл конфигурации среды в .azure/<environment-name>/config.json. Это позволяет, например, развертывать в разных облаках для разных сред.

{
    "cloud": {
        "name": "AzureCloud"
    }
}
{
    "cloud": {
        "name": "AzureChinaCloud"
    }
}
{
    "cloud": {
        "name": "AzureUSGovernment"
    }
}

Поддерживаемые команды и платформы

Поддерживаемые команды включают

  • auth
  • config
  • развертывание
  • вниз
  • окружение
  • снабжение
  • вверх
  • монитор
  • шоу

azd pipeline не поддерживается в национальных облаках.

devcenter платформа не поддерживается в Суверенных облаках.

Развертывание с помощью Terraform

При развертывании в суверенном облаке с помощью azd и Terraform, интерфейс командной строки az также должен быть настроен для использования требуемого облака. См. документацию Terraform по проверке подлинности с использованием Azure CLI.

Установите переменную среды ARM_ENVIRONMENT на нужную среду. К общим значениям относятся:

  • public (по умолчанию)
  • usgovernment
  • china

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

az cloud set --name AzureCloud
az cloud set --name AzureChinaCloud
az cloud set --name AzureUSGovernment