Creare una risorsa di Azure in modo interattivo con l'interfaccia della riga di comando di Azure

  • 5 minuti

In modalità interattiva, l'interfaccia della riga di comando di Azure consente di immettere ed eseguire immediatamente i comandi.

Nell'esempio relativo alla soluzione CRM (Customer Relationship Management), l’obiettivo è creare tre ambienti di test, tutti contenenti macchine virtuali. Usare i gruppi di risorse per assicurarsi che le macchine virtuali siano organizzate in ambienti separati:

  • Unit test
  • Test di integrazione
  • Test di accettazione

Poiché è necessario creare i gruppi di risorse una sola volta, l'uso interattivo dell'interfaccia della riga di comando di Azure per questa attività è una scelta ragionevole.

Esempio: Come creare un gruppo di risorse con l'interfaccia della riga di comando di Azure

Si vedrà ora come eseguire un'attività comune: creare un gruppo di risorse. I gruppi di risorse consentono di gestire collettivamente le risorse correlate e la creazione di un nuovo gruppo di risorse è spesso una delle prime attività eseguite all'avvio di una nuova soluzione di Azure.

Ecco i tre passaggi da seguire:

  1. Connettersi ad Azure usando az login.

  2. Usare le sottoscrizioni di Azure tramite az account.

  3. Usare i gruppi di risorse tramite az group.

Connect to Azure

Quando si usa un'installazione locale dell'interfaccia della riga di comando di Azure, è necessario effettuare l'autenticazione prima di eseguire qualsiasi comando dell'interfaccia della riga di comando di Azure. Il comando az login richiede le credenziali di Azure e quindi esegue la connessione alla sottoscrizione di Azure.

Per connettersi in modo interattivo, non è necessario specificare parametri:

az login

Questo comando apre un prompt per le credenziali di Azure e stabilisce una connessione alla sottoscrizione di Azure.

Ecco alcuni suggerimenti utili per l'autenticazione in Azure con l'interfaccia della riga di comando di Azure:

  • Quando si esegue l'interfaccia della riga di comando di Azure in Azure Cloud Shell...

    • L'autenticazione viene eseguita automaticamente.
    • Potrebbe essere necessario modificare la sottoscrizione predefinita.

  • Quando si esegue l'interfaccia della riga di comando di Azure tramite un'installazione locale...

    • È necessario immettere le credenziali di Azure.
    • È disponibile un'opzione che consente di selezionare la sottoscrizione al momento dell'accesso.

Lavorare con le sottoscrizioni

Se non si ha familiarità con Azure, è perché si possiede una singola sottoscrizione. Tuttavia, se si usa Azure già da tempo, potrebbero essere disponibili più sottoscrizioni di Azure. L'interfaccia della riga di comando di Azure consente di configurare la sottoscrizione in cui vengono eseguiti i comandi.

È possibile usare una sola sottoscrizione alla volta. Usare il comando di riferimento az account show per stabilire quale sottoscrizione è attualmente attiva. Se la sottoscrizione non è quella corretta, è possibile passare a un'altra sottoscrizione usando il comando di riferimento az account set.

  1. Recuperare un elenco di tutte le sottoscrizioni facendo in modo che i risultati vengano restituiti in una tabella:

    az account list --output table

  2. Recuperare solo la sottoscrizione attualmente attiva:

    az account show

  3. Modificare la sottoscrizione attiva:

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

Utilizzare i gruppi di risorse

Quando si creano risorse in Azure, queste vengono inserite in un gruppo di risorse ai fini della gestione.

Per creare un gruppo di risorse, usare il comando di riferimento az group create. È necessario specificare un nome e un percorso e il nome deve essere univoco all'interno della sottoscrizione. La posizione determina dove vengono archiviati i metadati per il gruppo di risorse, aspetto che può essere importante per motivi di conformità. Usare il comando az account list-locations per stabilire quali posizioni sono disponibili.

Nota

Se si utilizza una sandbox di Azure, il gruppo di risorse viene creato automaticamente. Se si preferisce utilizzare la propria sottoscrizione, usare i comandi seguenti.

La sintassi per la creazione di un gruppo di risorse è la seguente:

az group create --name MyResourceGroup --location eastus

Per recuperare un elenco di tutti i gruppi di risorse nella sottoscrizione attiva, usare il comando az group list.

az group list

Per una visualizzazione più concisa, è possibile fare in modo che l'elenco venga restituito sotto forma di tabella:

az group list --output table

Per lo sviluppo e il test di uno script dell'interfaccia della riga di comando di Azure, è consigliabile creare un gruppo di risorse contenente un ID casuale nel nome. L'aggiunta di un ID casuale nel nome del gruppo di risorse consente di ripetere il test del codice senza dover attendere che un gruppo di risorse precedente con lo stesso nome venga rimosso da Azure.

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

Esempio: Creare una macchina virtuale di Azure

La creazione di macchine virtuali è un'attività comune che è possibile eseguire con l'interfaccia della riga di comando di Azure.

Per creare una macchina virtuale, viene usato il comando az vm create. Questo comando include diversi parametri per gestire le impostazioni di configurazione dettagliate per una macchina virtuale. La maggior parte dei parametri ha valori predefiniti accettabili, quindi generalmente è necessario specificare solo cinque elementi chiave:

  • resource-group: Il gruppo di risorse in cui viene inserita la nuova macchina virtuale.
  • name: Il nome della macchina virtuale in Azure.
  • location: L’area geografica in cui viene effettuato il provisioning della macchina virtuale.
  • image: L'immagine del sistema operativo da usare per la macchina virtuale, che in genere è una distribuzione di Linux o Windows Server.
  • admin-username: Nome utente dell'amministratore per la macchina virtuale. Viene richiesto di immettere una password nella riga di comando.

Ecco un esempio di script 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

Esempio: Recuperare informazioni per una macchina virtuale

È possibile elencare le macchine virtuali nella sottoscrizione usando il comando az vm list. Questo comando supporta anche il recupero di una macchina virtuale specifica tramite il parametro --name.

Per archiviare l'ID di una macchina virtuale in una variabile, procedere come segue:

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

Utilizzando il comando az vm update, modificare le dimensioni della macchina virtuale:

#!/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

In questo esercizio è stato dimostrato un criterio tipico per una sessione interattiva dell'interfaccia della riga di comando di Azure. È stato prima di tutto usato un comando standard per creare un nuovo gruppo di risorse. È stato quindi usato un set di comandi per distribuire una risorsa (in questo esempio una macchina virtuale) in questo gruppo di risorse. Questo set di comandi può essere facilmente combinato in uno script della shell da eseguire ogni volta che è necessario creare la stessa risorsa.