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.
- Parámetros de línea de comandos
- Variables de entorno
- Valores en el archivo de configuración o establecidos con
az configoaz 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.
