Condividi tramite


Preparare l'ambiente per il Azure CLI

In questo passaggio dell'esercitazione si eseguono i primi comandi Azure CLI. Ciò include la ricerca e l'impostazione della sottoscrizione attiva e l'impostazione dei valori predefiniti. Si apprenderà anche come creare gruppi di risorse contenenti un ID casuale per garantire sempre un nome di risorsa univoco.

Se non si ha una sottoscrizione Azure, creare un account Azure gratuito prima di iniziare.

Per completare questo passaggio dell'esercitazione, sono necessarie autorizzazioni di livello contributor o superiore sul tuo abbonamento.

Installare il Azure CLI

Per iniziare, selezionare l'ambiente.

  • Usare l'ambiente Bash in Azure Cloud Shell selezionando il pulsante Apri Cloud Shell nell'angolo superiore destro di ogni blocco di codice Azure CLI.

  • Se si preferisce eseguire i comandi di riferimento Azure CLI in locale, install il Azure CLI.

La versione corrente del Azure CLI è 2.84.0. Per informazioni sull'ultima versione, vedere le note di rilascio . Per individuare la versione installata e verificare se è necessario aggiornarla, eseguire az version.

Accedere a Azure usando il Azure CLI

Esistono diverse opzioni autenticazione quando si lavora con il Azure CLI. Il metodo di autenticazione predefinito della CLI di Azure per i login usa un web browser e un token di accesso per accedere.

  1. Eseguire il comando az login.

    az login
    

    Se Azure CLI può aprire il browser predefinito, avvia flusso del codice di autenticazione e apre il browser predefinito per caricare una pagina di accesso Azure.

    In caso contrario, avvia il flusso di codice del dispositivo e ti istruisce ad aprire una pagina del browser su . Immettere quindi il codice visualizzato nel terminale.

    Se non è disponibile alcun Web browser o l'apertura del Web browser non riesce, è possibile forzare il flusso del codice del dispositivo con az login --use-device-code.

  2. Accedere con le credenziali dell'account nel browser.

Trovare e modificare la sottoscrizione attiva

Dopo aver eseguito l'accesso al Azure CLI, controllare sempre la sottoscrizione corrente. Se non stai lavorando sotto la sottoscrizione che preferisci, modifica la tua sottoscrizione usando az account set. Ecco un esempio di codice da usare:

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

Output della console per il 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"
  }
}

Informazioni sui gruppi di risorse

Un gruppo di risorse è un contenitore per Azure risorse. Per creare un gruppo di risorse, sono necessarie autorizzazioni pari a contributor o superiori nella sottoscrizione.

Creare un gruppo di risorse

  1. All'interno di una sottoscrizione, il nome di un gruppo di risorse deve essere univoco. Controllare prima di tutto se il nome desiderato è disponibile usando il comando az group exists . Un valore di output di false significa che il nome è disponibile.

    az group exists --name <myUniqueRGname>
    
  2. Recuperare un elenco di aree supportate per la sottoscrizione con il comando az account list-locations . Per un elenco delle località di Azure disponibili, vedere Scegliere l'area Azure giusta.

    az account list-locations --query "[].{Region:name}" --output table
    
  3. È ora di creare il tuo gruppo di risorse. Usa il comando az group create.

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

Creare un gruppo di risorse contenente un ID casuale

Quando si esegue il test, è consigliabile creare un gruppo di risorse contenente un ID casuale nel nome. L'aggiunta di un ID casuale al nome del gruppo di risorse consente di ripetere il codice senza dover attendere che un gruppo di risorse precedente con lo stesso nome venga rimosso da Azure.

La sintassi delle variabili Bash e PowerShell è diversa. Copia lo script corretto per il tuo ambiente.

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

Output della console Bash e 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"
}

Impostare le variabili di ambiente

Il Azure CLI offre diverse opzioni per consentire di riutilizzare i valori dei parametri comuni. Questi valori predefiniti vengono archiviati nelle variabili di ambiente e sono univoci per ogni accesso.

  1. Impostare il gruppo di risorse predefinito.

    az config set defaults.group=<msdocs-tutorial-rg-0000000>
    
  2. Impostare più variabili di ambiente contemporaneamente.

    Molti parametri Azure CLI accettano più valori separati da uno spazio. I valori di configurazione sono un'istanza di questo tipo. Nel prossimo esempio vengono impostati i valori predefiniti per .location e .group che sono utilizzati dai parametri --location e --resource-group di ogni comando Azure CLI.

    az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
    
  3. Impostare l'output predefinito.

    Quando si sceglie di lavorare in Azure Cloud Shell o installare il Azure CLI in locale, l'output predefinito viene impostato automaticamente su json. Tuttavia, questa impostazione è una delle impostazioni predefinite più importanti da comprendere e impostare. L'output determina cosa viene visualizzato nella console e cosa viene scritto nel file di log. Utilizzare sempre un output di none quando si creano risorse che restituiscono chiavi, password e segreti.

    az config set core.output=none
    

    In questa esercitazione non si lavora con i segreti. Impostare di nuovo il valore predefinito su json per visualizzare l'output restituito di ogni comando di riferimento in questa esercitazione.

    az config set core.output=json
    
  4. Informazioni su come usare az init.

    Il Azure CLI include un comando di riferimento che illustra la configurazione dell'ambiente. Digitare az init nella console e premere INVIO. Seguire le istruzioni fornite.

    az init
    

    Un aspetto importante di az init è che visualizza tutte le impostazioni correnti. Di seguito è riportato un esempio dell'output:

    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 its 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. Trovare e leggere il file di configurazione.

    Se si lavora con una mentalità "attendibile ma verifica", si vuole sapere dove vengono archiviati i file di configurazione e cosa contengono. Il file di configurazione stesso si trova in $AZURE_CONFIG_DIR/config. Il valore predefinito di AZURE_CONFIG_DIR è $HOME/.azure in Linux e macOS e %USERPROFILE%\.azure in Windows. Individuare il file di configurazione ed esaminarne il contenuto.

Ottenere altri dettagli

Vuoi maggiori dettagli su uno degli argomenti trattati in questo passaggio dell'esercitazione? Per altre informazioni, usare i collegamenti in questa tabella.

Oggetto Ulteriori informazioni
Ambienti Scegliere lo strumento da riga di comando Azure corretto
Opzioni di accesso Accedere con Azure CLI
Termini Azure CLI terminologia e livelli di supporto
Sottoscrizioni Gestisci le sottoscrizioni con Azure CLI
Gruppi di risorse Gestisci i gruppi di risorse usando il Azure CLI
Configurazioni Configurare il Azure CLI
ruoli Azure Ruoli di Azure, ruoli di Microsoft Entra e ruoli di amministratore della sottoscrizione classica

Passaggio successivo

Dopo aver appreso come configurare l'ambiente, procedere con il passaggio successivo per comprendere le differenze di scripting tra Bash, PowerShell e Cmd.exe.