Préparer votre environnement pour l’Azure CLI

Dans cette étape du didacticiel, vous exécutez vos premières commandes Azure CLI. Cela inclut la recherche et la définition de votre abonnement actif et la définition des valeurs par défaut. Vous apprendrez également à créer des groupes de ressources contenant un ID aléatoire pour toujours garantir un nom de ressource unique.

Si vous n'avez pas d'abonnement Azure, créez un compte gratuit Azure avant de commencer.

Pour effectuer cette étape du didacticiel, vous avez besoin d’autorisations contributor ou ultérieures sur votre abonnement.

Installer le Azure CLI

Commencez par sélectionner votre environnement.

• Utilisez l’environnement Bash dans Azure Cloud Shell en sélectionnant le bouton Open Cloud Shell dans le coin supérieur droit de chaque bloc de code Azure CLI.

• Si vous préférez exécuter les commandes de référence Azure CLI localement, install la Azure CLI.

La version actuelle du Azure CLI est 2.84.0. Pour plus d’informations sur la version la plus récente, consultez les Notes de publication. Pour connaître la version que vous avez installée et savoir si elle nécessite d’être mise à jour, exécutez az version.

Connectez-vous à Azure à l’aide du Azure CLI

Il existe plusieurs options authentication lors de l’utilisation du Azure CLI. La méthode d'authentification par défaut de Azure CLI pour les connexions utilise un navigateur web et un jeton d'accès pour se connecter.

1. Exécutez la commande az login.

   az login
   

   Si Azure CLI peut ouvrir votre navigateur par défaut, elle lance flux d'autorisation par code et ouvre le navigateur par défaut pour charger une page de connexion Azure.

   Sinon, il lance le flux de code de l’appareil et vous demande d’ouvrir une page de navigateur à https://aka.ms/devicelogin. Entrez ensuite le code affiché dans votre terminal.

   Si aucun navigateur web n’est disponible ou si le navigateur web ne parvient pas à s’ouvrir, vous pouvez forcer le flux de code de l’appareil avec az login --use-device-code.

2. Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.

Rechercher et modifier votre abonnement actif

Après vous être connecté au Azure CLI, vérifiez toujours votre abonnement actuel. Si vous ne travaillez pas sous l’abonnement que vous préférez, modifiez votre abonnement à l’aide de az account set. Voici un exemple de code à utiliser :

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

Sortie de la console pour la commande 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"
  }
}

En savoir plus sur les groupes de ressources

Un groupe de ressources est un conteneur pour les ressources Azure. Pour créer un groupe de ressources, vous devez disposer d’autorisations contributor ou ultérieures dans votre abonnement.

Créer un groupe de ressources

1. Dans un abonnement, le nom d’un groupe de ressources doit être unique. Tout d’abord, vérifiez si le nom souhaité est disponible à l’aide de la commande az group exists . Une valeur de sortie de false signifie que le nom est disponible.

   az group exists --name <myUniqueRGname>
   

2. Récupérez la liste des régions prises en charge pour votre abonnement avec la commande az account list-locations. Pour obtenir la liste des emplacements Azure disponibles, consultez Choose la région appropriée Azure pour vous.

   az account list-locations --query "[].{Region:name}" --output table
   

3. Il est temps de créer votre groupe de ressources. Utilisez la commande az group create.

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

Créer un groupe de ressources contenant un ID aléatoire

Lors du test, il est préférable de créer un groupe de ressources qui contient un ID aléatoire dans son nom. L’ajout d’un ID aléatoire à votre nom de groupe de ressources vous permet de retester votre code sans avoir à attendre qu’un groupe de ressources antérieur du même nom soit supprimé de Azure.

La syntaxe des variables Bash et PowerShell est différente. Copiez le script approprié pour votre environnement.

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

Sortie console Bash et 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"
}

Définir des variables d’environnement

Le Azure CLI offre plusieurs options pour vous permettre de réutiliser les valeurs de paramètres courantes. Ces valeurs par défaut sont stockées dans des variables d’environnement et sont uniques pour chaque connexion.

1. Définissez votre groupe de ressources par défaut.

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

2. Définissez plusieurs variables d’environnement à la fois.

   De nombreux paramètres Azure CLI prennent plusieurs valeurs séparées par un espace. Les valeurs de configuration sont une instance de ce type. L’exemple suivant définit les valeurs par défaut .location et .group utilisées par les paramètres --location et --resource-group de chaque commande Azure CLI.

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

3. Définissez votre sortie par défaut.

   Lorsque vous choisissez de travailler dans Azure Cloud Shell ou d’installer le Azure CLI localement, la sortie par défaut est automatiquement définie sur json. Toutefois, ce paramètre est l’une des valeurs par défaut les plus importantes pour comprendre et définir. La sortie détermine ce qui apparaît sur votre console et ce qui est écrit dans votre fichier journal. Utilisez toujours une sortie de none lorsque vous créez des ressources qui retournent des clés, des mots de passe et des secrets.

   az config set core.output=none
   

   Dans ce tutoriel, nous ne travaillons pas avec des secrets. Définissez la valeur par défaut sur json afin que vous puissiez voir la sortie retournée de chaque commande de référence dans ce tutoriel.

   az config set core.output=json
   

4. Apprenez à utiliser az init.

   Le Azure CLI a une commande de référence qui vous guide tout au long de la configuration de votre environnement. Tapez az init dans votre console, puis appuyez sur Entrée. Suivez les invites fournies.

   az init
   

   Un aspect important d’az init est qu’il affiche tous vos paramètres actuels. Voici un exemple de sortie :

   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. Recherchez et lisez votre fichier de configuration.

   Si vous travaillez dans un état d’esprit « confiance mais vérification », vous souhaitez savoir où sont stockés vos fichiers de configuration et ce qu’ils contiennent. Le fichier de configuration se trouve sous $AZURE_CONFIG_DIR/config. La valeur par défaut de AZURE_CONFIG_DIR est $HOME/.azure sur Linux et macOS, et %USERPROFILE%\.azure sur Windows. Recherchez votre fichier de configuration et examinez son contenu.

Obtenir plus de détails

Vous voulez plus d’informations sur un des sujets abordés dans cette étape de tutoriel ? Utilisez les liens de ce tableau pour en savoir plus.

Étape suivante

Maintenant que vous avez appris à configurer votre environnement, passez à l’étape suivante pour comprendre les différences de script entre Bash, PowerShell et Cmd.exe.