Конфигурация Azure CLI

Azure CLI позволяет настроить пользователя для таких параметров, как ведение журнала, сбор данных и значения аргументов по умолчанию. Интерфейс командной строки предлагает удобную команду для управления некоторыми значениями az configпо умолчанию и интерактивным вариантом az init. Другие значения можно задать в файле конфигурации или с переменными среды. В этой статье содержатся дополнительные сведения об этих параметрах конфигурации пользователей и настройке Azure CLI.

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

1. Параметры командной строки
2. Переменные среды
3. Значения в файле конфигурации задаются с помощью az config или az init

Настройка параметров с помощью az init

Самый простой способ задать конфигурации Azure CLI — использовать интерактивную команду az init . Выберите общую конфигурацию, например "взаимодействие" или "автоматизацию", или выберите отдельные конфигурации. Что особенно полезно в этом подходе, так это az init, который приводит причины, по которым вы можете захотеть выбрать один вариант конфигурации вместо другого.

az init

Настройка параметров с помощью az config

Вы можете задать значения по умолчанию для интерфейса командной строки с помощью команды az config set . Эта команда принимает разделенный пробелом список key=value пар в качестве аргумента. Указанные значения используются Azure CLI вместо обязательных аргументов.

В следующей таблице содержится список доступных ключей конфигурации.

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

az config set defaults.location=westus2 defaults.group=MyResourceGroup

Следующая команда отключает ссылки опроса при выполнении команд Azure CLI:

az config set core.survey_message=no

Файл конфигурации CLI

Файл конфигурации CLI содержит другие параметры, используемые для управления поведением ИНТЕРФЕЙСА командной строки. Файл конфигурации расположен здесь: $AZURE_CONFIG_DIR/config. По умолчанию для AZURE_CONFIG_DIR устанавливается значение $HOME/.azure в Linux и macOS и %USERPROFILE%\.azure в Windows.

Файлы конфигурации записываются в формате INI-файла. Заголовки разделов определяют формат файла, за которым следует список записей с ключом-значением.

• Заголовки разделов записываются как [section-name]. Имена разделов чувствительны к регистру.
• Записи записываются как key=value. Имена ключей не учитывает регистр.
• Примечания — это любая строка, начинающаяся с или #;. Встроенные комментарии не допускаются.

Булевы значения не чувствительны к регистру. Следующие значения представляют логические значения:

• True: 1, yes, true, on
• False: 0, no, false, off

Ниже приведен пример файла конфигурации CLI, который отключает любые запросы подтверждения и настраивает ведение журнала в /var/log/azure каталоге.

[core]
disable_confirm_prompt=Yes

[logging]
enable_log_file=yes
log_dir=/var/log/azure

Дополнительные сведения обо всех доступных значениях конфигурации и их значении см. в следующем разделе. Полные сведения о формате ФАЙЛА INI см. в документации по Python в INI.

Значения конфигурации CLI и переменные среды

В следующей таблице содержатся все разделы и имена параметров, которые можно поместить в файл конфигурации. Соответствующие переменные среды задаются как AZURE_{section}_{name}в всех ограничениях. Например, output значение по умолчанию задано в core переменной, AZURE_CORE_OUTPUT значение по умолчанию storage_account задано в batchai переменной, а значение по умолчанию AZURE_BATCHAI_STORAGE_ACCOUNTlocation задано в переменнойAZURE_DEFAULTS_LOCATION.

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