Configuración de la CLI de Azure

La CLI de Azure permite la configuración del usuario para ajustes como el registro de eventos, la recopilación de datos y los valores de argumento predeterminados. La CLI ofrece un comando cómodo para administrar algunos valores predeterminados, az configy una opción interactiva a través de 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 estas opciones de configuración de usuario y cómo configurar la CLI de Azure.

Los valores de configuración usados por la CLI se evalúan en la siguiente prioridad, con elementos más altos en la lista teniendo prioridad.

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

Configuración de las opciones mediante az init

La manera más fácil de establecer las 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" o opte por recorrer configuraciones individuales. Lo que resulta especialmente útil con este enfoque es que az init proporciona razones por las cuales es posible elegir una opción de configuración sobre otra.

az init

Configuración de las opciones mediante az config

Puede establecer los valores predeterminados de la CLI con el comando az config set . Este comando toma una lista de pares separados por espacios de key=value como argumento. La CLI de Azure usa los valores proporcionados en lugar de los argumentos necesarios.

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

Nombre	Descripción
defaults.group	Grupo de recursos predeterminado que se va a usar para todos los comandos.
ubicación por defecto	Ubicación predeterminada que se va a usar para todos los comandos.
defaults.web	Nombre de aplicación predeterminado para usar con los comandos az webapp.
defaults.vm	Nombre de máquina virtual predeterminado para usar en los comandos az vm.
defaults.vmss	Nombre predeterminado del conjunto de escalado de máquinas virtuales (VMSS) que se utilizará para los comandos az vmss.
defaults.acr	Nombre predeterminado del registro de contenedor para usar en los comandos az acr.

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

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

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

az config set core.survey_message=no

Archivo de configuración de la CLI

El archivo de configuración de la CLI contiene otras opciones 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 archivo 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 las secciones son sensibles a 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 con # o ;. No se permiten comentarios insertados.

Los booleanos no distinguen entre mayúsculas y 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 las solicitudes de confirmación y configura el registro en el /var/log/azure directorio.

[core]
disable_confirm_prompt=Yes

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

Consulte la sección siguiente para obtener más información sobre todos los valores de configuración disponibles y lo que significan. Para obtener los detalles completos sobre el formato de archivo INI, consulte la documentación de Python sobre INI.

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

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

Cuando se proporciona un valor predeterminado, ese argumento ya no es necesario para ningún comando. En su lugar, se usa el valor predeterminado.

Sección	Nombre	Tipo	Descripción
núcleo	resultado	cuerda / cadena	Formato de salida predeterminado. Valores permitidos: json (valor predeterminado), jsonc, yaml, yamlctable, , tsv, . none Para más información, consulte Formatos de salida de los comandos de la CLI de Azure.
	desactivar_mensaje_de_confirmación	booleano	Active o desactive las indicaciones de confirmación.
	mostrar_región_identificada	booleano	Los clientes de Azure pueden optar por implementar recursos en muchas regiones diferentes. En algunos casos, es posible que los clientes puedan reducir los costos seleccionando regiones cercanas que ofrecen los mismos servicios. Si se identifica una región cercana, un mensaje mostrará la región que se va a seleccionar para futuras implementaciones. Esta configuración controla si se muestra el mensaje.
	recoger_telemetría	booleano	Permitir que Microsoft recopile datos anónimos sobre el uso de la CLI. Para obtener información de privacidad, consulte la licencia MIT de la CLI de Azure.
	Solo_mostrar_errores	booleano	Solo se muestran errores durante la invocación del comando. En otras palabras, solo se escriben errores en stderr. Suprime las advertencias de los comandos preliminares, en desuso y experimentales. También está disponible para comandos individuales con el --only-show-errors parámetro .
	habilitar_broker_en_windows	booleano	Use el Administrador de cuentas web (WAM) para autenticarse en Azure mediante el az login comando .
	login_experience_v2	booleano	Active o desactive el az login selector de suscripción.
	no_color	booleano	Desactivar color. Los mensajes coloreados originalmente tienen el prefijo DEBUG, INFOWARNING y ERROR. Este valor booleano evita el problema causado por una biblioteca de terceros en la que el color del terminal no se puede revertir después de una stdout redirección.
Clientes	advertencia_mostrar_secretos	booleano	Active o desactive la advertencia para la salida de información confidencial.
Registro	habilitar archivo de registro	booleano	Activa o desactiva el registro de actividad.
	log_dir	cuerda / cadena	Directorio en el que se van a escribir registros. De forma predeterminada, este valor es ${AZURE_CONFIG_DIR}/logs*.
Predeterminados	grupo	cuerda / cadena	Grupo de recursos predeterminado que se va a usar para todos los comandos.
	ubicación	cuerda / cadena	Ubicación predeterminada que se va a usar para todos los comandos.
	web	cuerda / cadena	Nombre de aplicación predeterminado para usar con los comandos az webapp.
	Vm	cuerda / cadena	Nombre de máquina virtual predeterminado para usar en los comandos az vm.
	vmss	cuerda / cadena	Nombre predeterminado del conjunto de escalado de máquinas virtuales (VMSS) que se utilizará para los comandos az vmss.
	ACR	cuerda / cadena	Nombre predeterminado del registro de contenedor para usar en los comandos az acr.
almacenamiento	cuenta	cuerda / cadena	Nombre de la cuenta de almacenamiento predeterminada (por ejemplo, mystorageaccount en https://mystorageaccount.blob.core.windows.net) que se utilizará para los comandos del plano de datos az storage (por ejemplo, az storage container list).
	clave	cuerda / cadena	Clave de acceso predeterminada para usar en los comandos del plano de datos az storage.
	sas_token	cuerda / cadena	Token de SAS predeterminado que se va a usar para az storage los comandos del plano de datos.
	cadena_de_conexión	cuerda / cadena	Cadena de conexión predeterminada para usar en los comandos del plano de datos az storage.
batchai	cuenta_de_almacenamiento	cuerda / cadena	La cuenta de almacenamiento predeterminada que se va a usar para az batchai comandos.
	clave_de_almacenamiento	cuerda / cadena	Clave de almacenamiento predeterminada para usar en az batchai comandos.
lote	cuenta	cuerda / cadena	Nombre predeterminado de la cuenta de Azure Batch que se va a usar para az batch los comandos.
	clave_de_acceso	cuerda / cadena	La clave de acceso predeterminada para usar con los comandos az batch. Solo se usa con aad autorización.
	punto final	cuerda / cadena	Punto de conexión predeterminado al que se va a conectar para los comandos az batch.
	modo de autenticación	cuerda / cadena	El modo de autorización que se utilizará para comandos az batch. Valores permitidos: shared_key, aad.
nube	nombre	cuerda / cadena	La nube predeterminada para todos los az comandos. Valores permitidos: AzureCloud (valor predeterminado), AzureChinaCloud, AzureUSGovernment. Para cambiar las nubes, puede usar el az cloud set -–name comando . Para ver un ejemplo, consulte Administración de nubes con la CLI de Azure.
extensión	usar_instalación_dinámica	cuerda / cadena	Instale una extensión si aún no se agrega al ejecutar un comando desde ella. Valores permitidos: no (valor predeterminado), yes_prompt, yes_without_prompt.
	ejecutar_despues_de_instalacion_dinamica	booleano	Continúe ejecutando el comando cuando se instala dinámicamente una extensión para él. El valor predeterminado es False.
	index_url	cuerda / cadena	Dirección URL del archivo de índice de extensión privada siguiendo el formato de index.json. Una vez especificado, ejecutar az extension add --name <extension-name> utiliza ese archivo para encontrar la extensión que se va a agregar.

Nota:

Es posible que vea otros valores en el archivo de configuración, pero estos se administran directamente a través de comandos de la CLI, incluidos az config. Los que aparecen en la tabla anteriormente son los únicos valores que debe cambiar usted mismo.