Préparation de votre environnement pour Azure CLI

Dans cette étape du tutoriel, 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 l’interface de ligne de commande Microsoft Azure

Commencez par sélectionner votre environnement.

• Utilisez l’environnement Bash dans Azure Cloud Shell en sélectionnant le bouton Ouvrir 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, installez Azure CLI.

La version actuelle d’Azure CLI est 2.63.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.

Se connecter à Azure à l’aide d’Azure CLI

Il existe plusieurs options d’authentification lors de l’utilisation d’Azure CLI. La méthode d’authentification par défaut d’Azure CLI utilise un navigateur web et un jeton d’accès pour la connexion.

1. Exécutez la commande az login.

   az login
   

   Si Azure CLI peut ouvrir votre navigateur par défaut, il lance le flux de code d’autorisation 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 l’ouverture du navigateur web échoue, vous devrez peut-être forcer le flux de code d’appareil avec la commande 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é à 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 az account show la commande :

{
  "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. Vérifiez d’abord si le nom souhaité est disponible à l’aide du groupe az existe commande. 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 Choisir la région Azure appropriée 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 le 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é d’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 de la 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

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 paramètres .location et .group par défaut utilisés 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 avez choisi de travailler dans Azure Cloud Shell ou d’installer Azure CLI localement, la sortie par défaut est automatiquement définie sur json. Toutefois, il s’agit de l’une des valeurs par défaut les plus importantes à 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.

   Azure CLI dispose d’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
   

   La première chose agréable sur az init est qu’il vous donne 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 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: 
   

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 AZURE_CONFIG_DIR est $HOME/.azure sur Linux et macOS, et %USERPROFILE%\.azure sous Windows. Recherchez votre fichier de configuration maintenant et voyez ce qu’il contient.

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 découvrir les différences de script entre Bash, PowerShell et Cmd.