Preparare l'ambiente per l'interfaccia della riga di comando di Azure

Articolo
12/06/2023

In questo passaggio dell'esercitazione si eseguono i primi comandi dell'interfaccia della riga di comando di Azure. 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 di Azure, creare un account Azure gratuito prima di iniziare.

Per completare questo passaggio dell'esercitazione, sono necessarie contributor o più autorizzazioni per la sottoscrizione.

Installare l'interfaccia della riga di comando di Azure

Per iniziare, selezionare prima di tutto l'ambiente.

Usare l'ambiente Bash in Azure Cloud Shell selezionando il pulsante Apri Cloud Shell nell'angolo in alto a destra di ogni blocco di codice dell'interfaccia della riga di comando di Azure.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando di Azure in locale, installare l'interfaccia della riga di comando di Azure.

La versione corrente dell'interfaccia della riga di comando di Azure è 2.68.0. Per informazioni sulla versione più recente, vedere le note sulla versione. Per individuare la versione installata e verificare se è necessario aggiornarla, eseguire az version.

Quando si usa l'interfaccia della riga di comando di Azure, sono disponibili diverse opzioni di autenticazione. Il metodo di autenticazione predefinito dell'interfaccia della riga di comando di Azure per gli account di accesso usa un Web browser e un token di accesso per accedere.

Eseguire il comando az login.
```
az login
```
Se l'interfaccia della riga di comando di Azure può aprire il browser predefinito, avvia il flusso del codice di autorizzazione e apre il browser predefinito per caricare una pagina di accesso di Azure.

In caso contrario, avvia il flusso del codice del dispositivo e indica di aprire una pagina del browser in https://aka.ms/devicelogin. 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.
Accedere con le credenziali dell'account nel browser.

Trovare e modificare la sottoscrizione attiva

Dopo aver eseguito l'accesso all'interfaccia della riga di comando di Azure, controllare sempre la sottoscrizione corrente. Se non si lavora nella sottoscrizione preferita, modificare la 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 az account show il comando:

{
  "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 le risorse di Azure. Per creare un gruppo di risorse, sono necessarie contributor autorizzazioni o superiori nella sottoscrizione.

Creare un gruppo di risorse

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 indica false che il nome è disponibile.
```
az group exists --name <myUniqueRGname>
```
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 di Azure appropriata.
```
az account list-locations --query "[].{Region:name}" --output table
```
È il momento di creare il gruppo di risorse. Usare 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. Copiare lo script corretto per l'ambiente.

Bash
PowerShell

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

$randomIdentifier = (New-Guid).ToString().Substring(0,8)
$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

L'interfaccia della riga di comando di Azure offre diverse opzioni per consentire di riutilizzare i valori comuni dei parametri. Questi valori predefiniti vengono archiviati nelle variabili di ambiente e sono univoci per ogni accesso.

Impostare il gruppo di risorse predefinito.

az config set defaults.group=<msdocs-tutorial-rg-0000000>

Impostare più variabili di ambiente contemporaneamente.

Molti parametri dell'interfaccia della riga di comando di Azure accettano più valori separati da uno spazio. I valori di configurazione sono un'istanza di questo tipo. Nell'esempio seguente vengono impostati i .location valori predefiniti e usati dai parametri e .group--location di ogni comando dell'interfaccia --resource-group della riga di comando di Azure.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Impostare l'output predefinito.

Quando si sceglie di lavorare in Azure Cloud Shell o si installa l'interfaccia della riga di comando di Azure in locale, l'output predefinito viene impostato automaticamente su json. Tuttavia, si tratta di uno dei valori predefiniti più importanti da comprendere e impostare. L'output determina cosa viene visualizzato nella console e cosa viene scritto nel file di log. Usare 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
```

Informazioni su come usare az init.

L'interfaccia della riga di comando di Azure 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

La prima cosa interessante di az init è che offre tutte le impostazioni correnti! Ecco l'output di esempio:

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:

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 su Linux e macOS e %USERPROFILE%\.azure su Windows. Trovare ora il file di configurazione e vedere cosa contiene.

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	Altre informazioni
Ambienti	Scegliere lo strumento da riga di comando di Azure appropriato
Opzioni di accesso	Accedere tramite l'interfaccia della riga di comando di Azure
Terms	Terminologia e livelli di supporto dell'interfaccia della riga di comando di Azure
Sottoscrizioni	Gestire le sottoscrizioni con l'interfaccia della riga di comando di Azure
Gruppi di risorse	Gestire i gruppi di risorse usando l'interfaccia della riga di comando di Azure
Configurazioni	Configurare l'interfaccia della riga di comando di Azure
Ruoli di 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 apprendere le differenze di scripting tra Bash, PowerShell e Cmd.

Informazioni sulle differenze di sintassi dell'interfaccia della riga di comando di Azure in Bash, PowerShell e Cmd

Condividi tramite

Preparare l'ambiente per l'interfaccia della riga di comando di Azure

Installare l'interfaccia della riga di comando di Azure

Trovare e modificare la sottoscrizione attiva

Informazioni sui gruppi di risorse

Creare un gruppo di risorse

Creare un gruppo di risorse contenente un ID casuale

Impostare le variabili di ambiente

Ottenere altri dettagli

Passaggio successivo

Risorse aggiuntive

Condividi tramite

Preparare l'ambiente per l'interfaccia della riga di comando di Azure

Installare l'interfaccia della riga di comando di Azure

Accedere ad Azure usando l'interfaccia della riga di comando di Azure

Trovare e modificare la sottoscrizione attiva

Informazioni sui gruppi di risorse

Creare un gruppo di risorse

Creare un gruppo di risorse contenente un ID casuale

Impostare le variabili di ambiente

Ottenere altri dettagli

Passaggio successivo

Risorse aggiuntive