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

Работа с средами командной строки разработчика Azure

Интерфейс командной строки разработчика Azure (azd) помогает создавать среды с собственными конфигурациями, такими как разработка, тестирование и использование. В этой статье показано, как создавать среды и управлять ими и как использовать их с файлами инфраструктуры Bicep.

Создание сред

Создайте новую среду с помощью azd env new команды:

azd env new <environment-name>

Например, чтобы создать среду разработки:

azd env new dev

При выполнении такой команды, как azd up или azd deploy, azd вам будет предложено выбрать подписку Azure и расположение для новой среды. Параметры запроса хранятся в новой среде .env или config.json файлах.

Вы также можете указать подписку и расположение непосредственно в команде:

azd env new prod --subscription "My Production Subscription" --location eastus2

Список сред

Чтобы просмотреть все доступные среды для проекта, используйте:

azd env list

Эта команда отображает все созданные среды, выделите текущую активную среду:

NAME      DEFAULT   LOCAL     REMOTE
dev       true      true      false
test      false     true      false
prod      false     true      false

Переключение между средами

Чтобы переключиться в другую среду, используйте azd env select команду:

azd env select <environment-name>

Например, чтобы переключиться на рабочую среду, выполните приведенные ниже действия.

azd env select prod

Замечание

Эта команда изменяет активную среду, которая влияет на последующие azd команды, например provision или deploy.

Общие сведения о среде по умолчанию

Глобальный файл .azure/config.json конфигурации отслеживает текущую выбранную среду. При выполнении azd init и отсутствии сред еще не существует, azd автоматически создает первую среду и задает ее в качестве значения по умолчанию. Если у вас уже есть одна или несколько сред и выполняется azd env new <name>, azd появится запрос на выбор того, следует ли создать новую среду по умолчанию. При отклонении создается новая среда, но текущий выбор остается неизменным.

Вы можете временно переопределить среду по умолчанию для одной команды с помощью флага --environment . Использование этого флага не изменяет значение по умолчанию для будущих команд.

Обновление параметров среды

Вы можете обновить переменные локальной azd env refresh среды с помощью команды. Эта команда находит последнее развертывание Azure для приложения, извлекает значения переменной среды по имени, а затем обновляет локальный .env файл с этими последними значениями для выбранной среды. Например, если вы подготовили dev и prod версию, и dev вы выбрали среду, она извлекает последние выходные данные из этого развертывания, чтобы заполнить env-файл.

azd env refresh

Замечание

Команда azd env refresh не развертывает ресурсы. Она обновляет только конфигурацию локальной среды, чтобы она соответствовала текущему состоянию в Azure.

Обновление среды полезно при следующих случаях:

  • Вы хотите убедиться, что локальный .env файл отражает последние выходные данные инфраструктуры (например, строки подключения, конечные точки и т. д.).
  • Необходимо синхронизировать переменные среды после обновления среды товарища по команде.

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

Выполнение команд в определенных средах

Вы можете выполнять множество azd команд в определенной среде, не изменяя активную среду с помощью или -e флага--environment:

azd up --environment dev

Эта команда запускает рабочий up процесс (подготовка и развертывание) в dev среде без изменения активной среды.

Кроме того, сначала можно переключиться в предназначенную среду:

azd env select test
azd up

Замечание

Teams должны использовать конвейеры CICD с помощью azd pipeline config команды, а не прямые развертывания с помощью таких команд, как azd up или azd provision.

Удаление ресурсов среды

Чтобы удалить ресурсы Azure для определенной среды, выполните следующую azd down команду:

azd down <environment-name>

Замечание

В настоящее время невозможно удалить или переименовать azd среды напрямую с помощью команд. Если необходимо переименовать среду:

  • Используется azd down для удаления ресурсов среды.
  • Выполните команду azd env new <new-name> , чтобы создать новую среду.
  • Вручную удалите старую .env папку из .azure.

Использование имени среды в файлах инфраструктуры

Переменную из файла среды .env можно использовать AZURE_ENV_NAME для настройки развертываний инфраструктуры в Bicep. Это полезно для именования, тегов или настройки ресурсов на основе текущей среды.

Замечание

Ознакомьтесь с переменными среды , чтобы узнать больше об использовании переменных среды для настройки проектов Azure Developer CLI.

  1. azd AZURE_ENV_NAME задает переменную среды при инициализации проекта.

    AZURE_ENV_NAME=dev

  2. main.parameters.json В файле наведите ссылку на переменную среды, чтобы azd заменить ее значение:

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "environmentName": {
      "value": "${AZURE_ENV_NAME}"
    }
  }
}

    При развертывании с azdпомощью значения из .env файла Bicep передается из main.parameters.jsonфайла Bicep.

  3. В шаблоне Bicep определите параметр для имени среды:

    param environmentName string

  4. Параметр можно использовать environmentName для тега ресурсов, что упрощает определение среды, к которой принадлежит ресурс:

    param environmentName string

resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
  name: 'mystorage${uniqueString(resourceGroup().id)}'
  location: resourceGroup().location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  tags: {
    Environment: environmentName
    Project: 'myproject'
  }
}

Этот подход помогает управлять ресурсами, отслеживать затраты и автоматизацию путем связывания каждого ресурса с его средой развертывания.

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

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

Настройка рабочих процессов Azure Developer CLI с помощью перехватчиков

  • Last updated on