Crear un recurso de Azure de forma interactiva con la CLI de Azure

5 minutos

En modo interactivo, la CLI de Azure permite escribir y ejecutar comandos inmediatamente.

En el ejemplo de gestión de relaciones con los clientes (CRM), el objetivo es crear tres entornos de prueba, cada uno de los cuales contendrá máquinas virtuales (VM). Use grupos de recursos para asegurarse de que las máquinas virtuales se organizan en entornos independientes:

Pruebas unitarias
Pruebas de integración
Pruebas de aceptación

Puesto que solo necesita crear los grupos de recursos una vez, el uso de la CLI de Azure de forma interactiva para esta tarea es una opción razonable.

Ejemplo: Cómo crear un grupo de recursos con la CLI de Azure

Vamos a realizar una tarea común: crear un grupo de recursos. Los grupos de recursos le ayudan a administrar los recursos relacionados colectivamente y la creación de un nuevo grupo de recursos suele ser una de las primeras tareas que se realizan al iniciar una nueva solución de Azure.

Estos son los tres pasos que debe seguir:

Conéctese a Azure mediante az login.
Trabaje con suscripciones de Azure mediante az account.
Trabaje con grupos de recursos mediante az group.

Conexión con Azure

Al usar una instalación local de la CLI de Azure, debe autenticarse antes de ejecutar los comandos de la CLI de Azure. El comando az login le solicita las credenciales de Azure y, a continuación, se conecta a la suscripción de Azure.

Para conectarse de forma interactiva, no es necesario especificar parámetros:

az login

Este comando abre un símbolo del sistema para las credenciales de Azure y establece una conexión a la suscripción de Azure.

Estas son algunas sugerencias útiles al autenticarse en Azure con la CLI de Azure:

Si ejecuta la CLI de Azure en Azure Cloud Shell...
- Se autentica automáticamente.
- Es posible que tenga que cambiar la suscripción predeterminada.
Al ejecutar la CLI de Azure a través de una instalación local...
- Se le pedirán las credenciales de Azure.
- Hay un selector de suscripción en el momento del inicio de sesión.

Trabajo con suscripciones

Si es nuevo en Azure, sólo tiene una suscripción. Sin embargo, si lleva un tiempo utilizando Azure, es posible que tenga varias suscripciones. La CLI de Azure permite configurar en qué suscripción se ejecutan los comandos.

Sólo puede estar activo en una suscripción a la vez. Use el comando de referencia az account show para determinar qué suscripción está activa actualmente. Si no es la correcta, puede cambiar las suscripciones mediante el comando de referencia az account set.

Obtenga una lista de todas las suscripciones que devuelven los resultados en una tabla:
```
az account list --output table
```
Obtenga solo la suscripción activa actual:
```
az account show
```

Cambie la suscripción activa:

az account set --subscription "00000000-0000-0000-0000-000000000000"

Trabajar con grupos de recursos

Al crear recursos en Azure, los coloca en un grupo de recursos con fines de administración.

Para crear un grupo de recursos, use el comando de referencia az group create. Debe especificar un nombre y una ubicación, y el nombre debe ser único dentro de la suscripción. The location determines where the metadata for your resource group is stored, which can be important for compliance reasons. Use el comando az account list-locations para determinar las ubicaciones disponibles.

Nota:

Si trabaja en un espacio aislado de Azure, crea automáticamente el grupo de recursos. Si prefiere trabajar en su propia suscripción, use los siguientes comandos.

La sintaxis para crear un grupo de recursos es:

az group create --name MyResourceGroup --location eastus

Para recuperar una lista de todos los grupos de recursos de la suscripción activa, use el comando az group list.

az group list

Para obtener una vista más concisa, puede devolver la lista en una tabla:

az group list --output table

Al desarrollar y probar un script de la CLI de Azure, 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.

#!/bin/bash
let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Ejemplo: Crear una máquina virtual de Azure

La creación de máquinas virtuales (VM) es una tarea común que puede realizar con la CLI de Azure.

El comando az vm create se usa para crear una máquina virtual. Este comando tiene varios parámetros para controlar las amplias opciones de configuración de una máquina virtual. La mayoría de los parámetros tienen valores predeterminados razonables, por lo que normalmente debe especificar solo cinco elementos clave:

resource-group: El grupo de recursos donde se coloca la nueva máquina virtual.
nombre: el nombre de la máquina virtual en Azure.
ubicación: Región geográfica donde se aprovisiona la máquina virtual.
imagen: Imagen de sistema operativo que se va a usar para la máquina virtual, normalmente una distribución de Linux o Windows Server.
admin-username: Nombre de usuario del administrador de la máquina virtual. Se le pedirá que escriba una contraseña en la línea de comandos.

Bash
PowerShell

Este es un ejemplo de script de Bash:

#!/bin/bash

# Create variables
rgName="myResourceGroupName"
vmName="myVMname"
vmImage="Win2022AzureEditionCore"
vmAdminUserName="myAzureUserName"

# Create the VM
az vm create \
    --resource-group $rgName \
    --name $vmName \
    --image $vmImage \
    --public-ip-sku Standard \
    --admin-username $vmAdminUserName

Este es el ejemplo equivalente para crear una máquina virtual en un entorno de PowerShell:

# Create variables
$rgName = "myResourceGroupName"
$vmName = "myVMname"
$vmImage = "Win2022AzureEditionCore"
$vmAdminUserName = "myAzureUserName"

# Create the VM
az vm create `
    --resource-group $rgName `
    --name $vmName `
    --image $vmImage `
    --public-ip-sku Standard `
    --admin-username $vmAdminUserName

Ejemplo: Obtención de información para una máquina virtual

Puede enumerar las máquinas virtuales de la suscripción con el comando az vm list. Este comando también admite la recuperación de una máquina virtual específica especificando el parámetro --name.

Aquí se muestra cómo almacenar el identificador de una máquina virtual en una variable:

#!/bin/bash
rgName="myResourceGroupName"
vmID=$(az vm list --resource-group $rgName \
    --query "[?name=='myVMname'].id" --output tsv)
echo $vmID

Con el comando az vm update, cambie el tamaño de la máquina virtual:

#!/bin/bash
rgName="myResourceGroupName"
vmName="msdocs-vm-01"
newVMsize="Standard_DS3_v2"

# Get the VM ID
vmID=$(az vm list --resource-group $rgName \
    --query "[?name=='$vmName'].id" --output tsv)

# Update the VM size
az vm update --ids $vmID --size $newVMsize

# Show the new properties of the VM
az vm show --resource-group $rgName --name $vmName

En este ejercicio se ha mostrado un patrón típico de una sesión interactiva de la CLI de Azure. Primero ha usado un comando estándar para crear un grupo de recursos. A continuación, ha usado un conjunto de comandos para implementar un recurso (en este ejemplo, una máquina virtual) en este grupo de recursos. Podría combinar fácilmente este conjunto de comandos en un script de shell y ejecutarlo cada vez que sea necesario crear el mismo recurso.