Compartir a través de


Configuración de la CLI de Azure

La CLI de Azure permite que el usuario configure opciones tales como el registro, la recopilación de datos y los valores de argumento predeterminados. La CLI ofrece un comando práctico para administrar algunos valores predeterminados, az config, y una opción interactiva mediante az init. Otros valores se pueden establecer en un archivo de configuración o con variables de entorno. En este artículo se proporciona más información sobre estos valores de la configuración del usuario y sobre cómo configurar la CLI de Azure.

Los valores de configuración usados por la CLI se evalúan según la siguiente prioridad, con mayor prioridad en los elementos superiores de la lista.

  1. Parámetros de línea de comandos
  2. Variables de entorno
  3. Valores en el archivo de configuración o establecidos con az config o az init

Configuración de los valores mediante az init

La manera más fácil de establecer configuraciones de la CLI de Azure es usar el comando az init interactivo. Elija una configuración común como "interacción" o "automatización" u opte por recorrer configuraciones individuales. Lo que resulta especialmente útil con este enfoque es az init, que proporciona el motivo por el que es posible que desee elegir una opción de configuración sobre otra.

az init

Configuración de los valores mediante az config

Los valores predeterminados de la CLI se establecen con el comando az configure set. Este comando toma como argumento una lista de pares key=value separada por espacios. La CLI de Azure utiliza los valores proporcionados en lugar de los argumentos necesarios.

La tabla siguiente contiene una lista de las claves de configuración disponibles.

Nombre Descripción
defaults.group El grupo de recursos predeterminado que se utilizará para todos los comandos.
defaults.location La ubicación predeterminada que se utilizará para todos los comandos.
defaults.web El nombre de la aplicación predeterminada que se usará para los comandos az webapp.
defaults.vm El nombre de la máquina virtual predeterminada que se usará para los comandos az vm.
defaults.vmss Nombre del conjunto de escalado de máquinas virtuales (VMSS) predeterminado que se usará para los comandos az vmss.
defaults.acr El nombre del registro de contenedor predeterminado que se usará para los comandos az acr.

Por ejemplo, aquí se muestra cómo se establecería el grupo de recursos y la ubicación de forma predeterminada para todos los comandos.

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

El siguiente comando desactiva los vínculos de encuestas mientras se ejecutan los comandos de la CLI de Azure:

az config set output.show_survey_link=no

Archivo de configuración de la CLI

El archivo de configuración de la CLI contiene otros valores que se usan para administrar el comportamiento de la CLI. El archivo de configuración se encuentra en $AZURE_CONFIG_DIR/config. El valor predeterminado de AZURE_CONFIG_DIR es $HOME/.azure en Linux y macOS y %USERPROFILE%\.azure en Windows.

Los archivos de configuración se escriben en el formato de archivos INI. Los encabezados de sección definen el formato de archivo, seguido de una lista de entradas clave-valor.

  • Los encabezados de sección se escriben como [section-name]. Los nombres de sección distinguen entre mayúsculas y minúsculas.
  • Las entradas se escriben como key=value. Los nombres de clave no distinguen mayúsculas de minúsculas.
  • Los comentarios son cualquier línea que comience por un # o ;. No se permiten comentarios insertados.

Los valores booleanos no distinguen mayúsculas de minúsculas. Los valores siguientes representan valores booleanos:

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

Este es un ejemplo de un archivo de configuración de la CLI que deshabilita los avisos de confirmación y establece el registro en el directorio /var/log/azure.

[core]
disable_confirm_prompt=Yes

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

Consulte la siguiente sección para obtener los detalles de todos los valores de configuración disponibles y su significado. Para obtener los detalles completos sobre el formato de archivos INI, consulte la documentación de Python sobre INI.

Valores de configuración de la CLI y variables de entorno

La tabla siguiente contiene todos los nombres de las secciones y de las opciones que se pueden utilizar en un archivo de configuración. Las variables de entorno correspondientes se establecen como AZURE_{section}_{name}, todo en mayúsculas. Por ejemplo, el valor predeterminado output de core se establece en la variable AZURE_CORE_OUTPUT, el valor predeterminado storage_account de batchai se establece en la variable AZURE_BATCHAI_STORAGE_ACCOUNT, y el valor predeterminado location se establece en la variable AZURE_DEFAULTS_LOCATION.

Al proporcionar un valor predeterminado, ningún comando necesita ya ese argumento. En su lugar, se usa el valor predeterminado.

Sección Nombre Escribir Descripción
core output string El formato de salida predeterminado. Valores permitidos: json (predeterminado), jsonc, yaml, yamlc, table, tsv, none. Para más información, consulte Formatos de salida de los comandos de la CLI de Azure.
disable_confirm_prompt boolean Activa o desactiva los mensajes de confirmación.
display_region_identified boolean Los clientes de Azure pueden implementar recursos en diversas regiones. En algunos casos, es posible que los clientes puedan reducir los costos si seleccionan regiones cercanas que ofrecen los mismos servicios. Si se identifica una región cercana, un mensaje indicará la región que se va a seleccionar para futuras implementaciones. Esta configuración controla si se muestra el mensaje.
collect_telemetry boolean Permite que Microsoft recopile datos anónimos sobre el uso de la CLI. Para más información sobre privacidad, consulte la licencia MIT de la CLI de Azure.
only_show_errors boolean Solo muestra los errores durante la invocación del comando. En otras palabras, solo se escriben los errores en stderr. Suprime las advertencias de los comandos en versión preliminar, en desuso y experimentales. También está disponible para comandos individuales con el parámetro --only-show-errors.
enable_broker_on_windows boolean Use el Administrador de cuentas web (WAM) para autenticarse en Azure mediante el az login comando .
login_experience_v2 boolean Active o desactive el az login selector de suscripción.
no_color boolean Deshabilita el color. Los mensajes que originalmente tenían color tienen como prefijo DEBUG, INFO, WARNING y ERROR. Este valor booleano omite el problema de una biblioteca de terceros en la que el color del terminal no se puede revertir después de un redireccionamiento de stdout.
Clientes show_secrets_warning boolean Active o desactive la advertencia para la salida de información confidencial.
logging enable_log_file boolean Activar o desactivar el registro.
log_dir string El directorio en el que se escribe el registro. De manera predeterminada, este valor es ${AZURE_CONFIG_DIR}/logs*.
defaults group string El grupo de recursos predeterminado que se utilizará para todos los comandos.
ubicación string La ubicación predeterminada que se utilizará para todos los comandos.
web string El nombre de la aplicación predeterminada que se usará para los comandos az webapp.
vm string El nombre de la máquina virtual predeterminada que se usará para los comandos az vm.
vmss string Nombre del conjunto de escalado de máquinas virtuales (VMSS) predeterminado que se usará para los comandos az vmss.
acr string El nombre del registro de contenedor predeterminado que se usará para los comandos az acr.
storage account cadena Nombre de la cuenta de almacenamiento predeterminada (por ejemplo, mystorageaccount en https://mystorageaccount.blob.core.windows.net para usar con los comandos del plano de datos az storage (por ejemplo, az storage container list).
key string Clave de acceso predeterminada que se va a utilizar para los comandos del plano de datos az storage.
sas_token string Token SAS predeterminado que se va a utilizar para los comandos del plano de datos az storage.
connection_string string Cadena de conexión predeterminada que se va a utilizar para los comandos del plano de datos az storage.
batchai storage_account string La cuenta de almacenamiento predeterminada que se usará para los comandos az batchai.
storage_key string La clave de almacenamiento predeterminada que se usará para los comandos az batchai.
batch account string El nombre de la cuenta de Azure Batch predeterminada que se usará para los comandos az batch.
access_key string La clave de acceso predeterminada que se usará para los comandos az batch. Solo se usa con autorización aad.
endpoint string El punto de conexión predeterminado para los comandos az batch.
auth_mode string El modo de autorización que se usará para los comandos az batch. Valores permitidos: shared_key, aad.
cloud name string La nube predeterminada para todos los comandos az. Valores permitidos: AzureCloud (predeterminado), AzureChinaCloud, AzureUSGovernment. Para cambiar de nube, puede usar el comando az cloud set –name. Para obtener un ejemplo, consulte Administración de nubes con la CLI de Azure.
extension use_dynamic_install string Instale una extensión si aún no se ha agregado al ejecutar un comando de la misma. Valores permitidos: no (predeterminado), yes_prompt, yes_without_prompt.
run_after_dynamic_install boolean Continúe con la ejecución del comando cuando se instala dinámicamente una extensión. El valor predeterminado es False.
index_url string Dirección URL del archivo de índice de extensión privada según el formato de index.json. Una vez especificada, la ejecución de az extension add --name <extension-name> usa ese archivo para buscar la extensión que se va a agregar.

Nota:

Puede ver otros valores en el archivo de configuración, pero estos se administran directamente mediante comandos de la CLI, incluido az config. Los que aparecen en la tabla anterior son los únicos valores que debe cambiar usted mismo.