Compartir a través de


Preparación del entorno para la CLI de Azure

¡En este paso del tutorial, ejecutará los primeros comandos de la CLI de Azure! Esto incluye buscar y establecer la suscripción activa y establecer los valores predeterminados. También aprenderá a crear grupos de recursos que contengan un identificador aleatorio para garantizar siempre un nombre de recurso único.

Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.

Para completar este paso del tutorial, necesita contributor o permisos superiores en la suscripción.

Instalación de la CLI de Azure

Para comenzar, seleccione primero el entorno.

  • Use el entorno de Bash en Azure Cloud Shell seleccionando el botónAbrir Cloud Shell en la esquina superior derecha de cada bloque de código de la CLI de Azure.

  • Si prefiere ejecutar los comandos de referencia de la CLI de Azure localmente, instalar la CLI de Azure.

La versión actual de la CLI de Azure es la 2.63.0. Para más información sobre la versión más reciente, consulte las notas de la versión. Para averiguar la versión instalada y ver si tiene que actualizar, ejecute az version.

Inicio de sesión en Azure mediante la CLI de Azure

Hay varias opciones de autenticación al trabajar con la CLI de Azure. El método de autenticación predeterminado de la CLI de Azure para los inicios de sesión usa un explorador web y un token de acceso para iniciar sesión.

  1. Ejecute el comando az login.

    az login
    

    Si la CLI de Azure puede abrir el explorador predeterminado, inicia el flujo de código de autorización y abre el explorador predeterminado para cargar una página de inicio de sesión de Azure.

    De lo contrario, inicie el flujo de código del dispositivo y le indica que abra una página del explorador en https://aka.ms/devicelogin. A continuación, escriba el código que se muestra en el terminal.

    Si no hay ningún explorador web disponible o no se puede abrir el explorador web, es posible que tenga que forzar el flujo de código de dispositivo con az login --use-device-code.

  2. Inicie sesión con las credenciales de su cuenta en el explorador.

Búsqueda y cambio de la suscripción activa

Después de iniciar sesión en la CLI de Azure, compruebe siempre la suscripción actual. Si no está trabajando en la suscripción que prefiera, cambie la suscripción mediante az account set. Este es un ejemplo de código que se va a usar:

# see your current/default subscription
az account show

# find the list of subscriptions available to you
az account list --output table

# change your current/default subscription
az account set --subscription <mySubscriptionName>

# you can also set your subscription using a subscription ID
az account set --subscription <00000000-0000-0000-0000-000000000000>

Salida de la consola para el comando az account show:

{
  "environmentName": "AzureCloud",
  "homeTenantId": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "isDefault": true,
  "managedByTenants": [],
  "name": "Your storage account name",
  "state": "Enabled",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "user": {
    "name": "yourName@contoso.com",
    "type": "user"
  }
}

Más información acerca de los grupos de recursos

Un grupo de recursos es un contenedor para recursos de Azure. Para crear un grupo de recursos, necesita contributor permisos o superior en la suscripción.

Crear un grupo de recursos

  1. Dentro de una suscripción, un nombre de grupo de recursos debe ser único. En primer lugar, compruebe si el nombre que desea está disponible mediante el comando az group exists. Un valor de salida false significa que el nombre está disponible.

    az group exists --name <myUniqueRGname>
    
  2. Recupere una lista de regiones admitidas para la suscripción con el comando az account list-locations. Para obtener una lista de las ubicaciones de Azure disponibles, consulte Elección de la región de Azure adecuada.

    az account list-locations --query "[].{Region:name}" --output table
    
  3. ¡Es el momento de crear el grupo de recursos! Use el comando az group create.

    az group create --location <myLocation> --name <myUniqueRGname>
    

Creación de un grupo de recursos que contenga un identificador aleatorio

Al realizar pruebas, es mejor crear un grupo de recursos que contenga un identificador aleatorio en el nombre. Agregar un identificador aleatorio al nombre del grupo de recursos permite volver a probar el código sin tener que esperar a que se quite un grupo de recursos anterior del mismo nombre de Azure.

La sintaxis de las variables de Bash y PowerShell es diferente. Copie el script correcto para su entorno.

let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Salida de la consola de Bash y PowerShell:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/msdocs-tutorial-rg-000000000",
  "location": "eastus",
  "managedBy": null,
  "name": "msdocs-tutorial-rg-000000000",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Establecimiento de variables de entorno

La CLI de Azure ofrece varias opciones para permitirle reutilizar valores de parámetro comunes. Estos valores predeterminados se almacenan en variables de entorno y son únicos para cada inicio de sesión.

  1. Establezca el grupo de recursos predeterminado.

    az config set defaults.group=<msdocs-tutorial-rg-0000000>
    
  2. Establezca varias variables de entorno a la vez.

    Muchos parámetros de la CLI de Azure toman varios valores separados por un espacio. Los valores de configuración son una de estas instancias. En el ejemplo siguiente se establecen los valores predeterminados .location y .group que usan los parámetros--location y --resource-group de cada comando de la CLI de Azure.

    az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
    
  3. Establezca la salida predeterminada.

    Cuando ha elegido trabajar en Azure Cloud Shell o instalar la CLI de Azure localmente, la salida predeterminada se establece automáticamente enjson. Sin embargo, este es uno de los valores predeterminados más importantes para reconocer y establecer. La salida determina lo que aparece en la consola y lo que se escribe en el archivo de registro. Use siempre una salida de none cuando cree recursos que devuelvan claves, contraseñas y secretos.

    az config set core.output=none
    

    En este tutorial, no estamos trabajando con secretos. Establezca el valor predeterminado en json para que pueda ver la salida devuelta de cada comando de referencia en este tutorial.

    az config set core.output=json
    
  4. Aprenda a usar az init.

    La CLI de Azure tiene un comando de referencia que le guía a través de la configuración del entorno. Escriba az init en la consola y presione Entrar. Siga las indicaciones proporcionadas.

    az init
    

    ¡La primera ventaja de az init es que te proporciona todos los ajustes de valor! Esta es la salida de ejemplo:

    Your current config settings:
    
      Output format: JSON 
      [core.output = json]
    
      Standard error stream (stderr): All events 
      [core.only_show_errors = false]
    
      Error output: Show recommendations 
      [core.error_recommendation = on]
    
      Syntax highlighting: On 
      [core.no_color = false]
    
      Progress Bar: On 
      [core.disable_progress_bar = false]
    
    
    Select an option by typing it's number
    
      [1] Optimize for interaction
          These settings improve the output legibility and optimize for human interaction
    
      [2] Optimize for automation
          These settings optimize for machine efficiency
    
      [3] Customize settings
          A walk through to customize common configurations
    
      [4] Exit (default)
          Return to the command prompt
    
    ? Your selection: 
    
  5. Busque y lea el archivo de configuración.

    Si trabaja con una mentalidad de "confianza pero comprobación", quiere saber dónde se almacenan los archivos de configuración y qué contienen. 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. Busque el archivo de configuración ahora y vea lo que contiene.

Obtenga más detalles

¿Desea obtener más detalles sobre uno de los temas tratados en este paso del tutorial? Use los vínculos de esta tabla para obtener más información.

Asunto Más información
Entornos Seleccione de la herramienta de la línea de comandos de Azure adecuada
Opciones de inicio de sesión Inicio de sesión con la CLI de Azure
Términos Terminología de la CLI de Azure y niveles de soporte técnico
Suscripciones Administración de suscripciones mediante la CLI de Azure
Grupos de recursos Administración de grupos de recursos mediante la CLI de Azure
Configuraciones Configuración de la CLI de Azure
Roles de Azure Roles de Azure, roles de Microsoft Entra y roles de administrador de suscripciones clásicos

siguiente paso

Ahora que ha aprendido a configurar el entorno, continúe con el paso siguiente para aprender las diferencias de scripting entre Bash, PowerShell y Cmd.