Configuração da CLI do Azure

A CLI do Azure permite a configuração do usuário para definições como log, coleta de dados e valores de argumento padrão. A CLI oferece um comando de conveniência para gerenciar alguns padrões, az confige uma opção interativa através do az init. Outros valores podem ser definidos num ficheiro de configuração ou com variáveis de ambiente. Este artigo fornece mais informações sobre essas definições de configuração do usuário e como configurar a CLI do Azure.

Os valores de configuração utilizados pela CLI são avaliados na seguinte precedência, em que os itens mais acima na lista têm prioridade.

1. Parâmetros de linha de comando
2. Variáveis de ambiente
3. Valores no arquivo de configuração definido com az config ou az init

Definir configurações usando az init

A maneira mais fácil de definir as configurações da CLI do Azure é usar o comando interativo az init . Escolha uma configuração comum, como "interação" ou "automação", ou opte por percorrer configurações individuais. O que é especialmente útil com essa abordagem é az init fornecer razões pelas quais você pode querer escolher uma opção de configuração em vez de outra.

az init

Definir configurações usando az config

Você pode definir padrões para a CLI com o comando az config set . Este comando usa uma lista de pares separados por key=value espaço como um argumento. Os valores fornecidos são usados pela CLI do Azure no lugar dos argumentos necessários.

A tabela seguinte contém uma lista das chaves de configuração disponíveis.

Como exemplo, eis como pode definir o grupo de recursos predefinido e a localização para todos os comandos.

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

O comando a seguir desativa os links de pesquisa durante a execução dos comandos da CLI do Azure:

az config set core.survey_message=no

Ficheiro de configuração de CLI

O ficheiro de configuração da CLI contém outras definições que são utilizadas para gerir o comportamento da CLI. O próprio ficheiro de configuração está localizado em $AZURE_CONFIG_DIR/config. O valor predefinido de AZURE_CONFIG_DIR é $HOME/.azure em Linux e macOS, e %USERPROFILE%\.azure no Windows.

Os ficheiros de configuração são escritos no formato de ficheiro INI. Os cabeçalhos de seção definem o formato do arquivo, seguido por uma lista de entradas chave-valor.

• Os cabeçalhos de secção são escritos como [section-name]. Os nomes de secção são sensíveis às maiúsculas e minúsculas.
• As entradas são escritas como key=value. Os nomes das chaves não diferenciam maiúsculas de minúsculas.
• Os comentários consistem em qualquer linha que comece com um # ou ;. Comentários embutidos não são permitidos.

Os booleanos não diferenciam maiúsculas de minúsculas. Os seguintes valores representam booleanos:

• Verdadeiro: 1, yes, true, , on
• Falso: 0, no, false, , off

Segue-se um exemplo de um ficheiro de configuração de CLI que desativa qualquer pedido de confirmação e configura o registo no diretório /var/log/azure.

[core]
disable_confirm_prompt=Yes

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

Consulte a secção seguinte para obter detalhes sobre todos os valores de configuração disponíveis e o que significam. Para mais informações sobre o formato de ficheiro INI, consulte a documentação Python no INI.

Valores de configuração da CLI e as variáveis de ambiente

A tabela seguinte contém todas as secções e os nomes das opções que podem ser colocados num ficheiro de configuração. As variáveis de ambiente correspondentes são definidas como AZURE_{section}_{name}, em maiúsculas. Por exemplo, output o padrão para core é definido na AZURE_CORE_OUTPUT variável, o storage_account padrão para batchai é definido na AZURE_BATCHAI_STORAGE_ACCOUNT variável e o padrão ___location é definido na AZURE_DEFAULTS_LOCATION variável.

Quando fornecer um valor predefinido, esse argumento já não é preciso para qualquer comando. Em vez disso, é utilizado o valor predefinido.