Créer une ressource Azure de façon interactive avec Azure CLI

  • 5 minutes

En mode interactif, Azure CLI vous permet d’entrer et d’exécuter immédiatement des commandes.

Dans l’exemple de Gestion des relations client (CRM), l’objectif est de créer trois environnements de test, chacun contenant des machines virtuelles. Utilisez des groupes de ressources pour vous assurer que les machines virtuelles sont organisées en environnements distincts :

  • Test des unités
  • Tests d’intégration
  • Tests d’acceptation

Comme vous ne devez créer les groupes de ressources qu’une seule fois, utiliser Azure CLI de façon interactive est un choix raisonnable pour cette tâche.

Exemple : Comment créer un groupe de ressources avec Azure CLI

Effectuons une tâche courante : créer un groupe de ressources. Les groupes de ressources vous aident à gérer les ressources associées collectivement, et créer un groupe de ressources est souvent l’une des premières tâches que vous effectuez lors du démarrage d’une nouvelle solution Azure.

Voici les trois étapes à suivre :

  1. Connectez-vous à Azure en utilisant az login.

  2. Travaillez avec des abonnements Azure en utilisant az account.

  3. Travaillez avec des groupes de ressources en utilisant az group.

Connexion à Azure

Quand vous utilisez une installation locale d’Azure CLI, vous devez vous authentifier avant d’exécuter des commandes Azure CLI. La commande az login vous demande d’entrer vos informations d’identification Azure, puis se connecte à votre abonnement Azure.

Pour vous connecter de façon interactive, vous n’avez pas besoin de spécifier des paramètres :

az login

Cette commande ouvre une invite pour vos informations d’identification Azure et établit une connexion à votre abonnement Azure.

Voici quelques conseils pratiques pour l’authentification auprès d’Azure avec Azure CLI :

  • Si vous exécutez Azure CLI dans Azure Cloud Shell...

    • Vous êtes authentifié automatiquement.
    • Il peut être nécessaire de changer votre abonnement par défaut.

  • Quand vous exécutez Azure CLI via une installation locale...

    • Vous êtes invité à entrer vos informations d’identification Azure.
    • Un sélecteur d’abonnement apparaît au moment de la connexion.

Utiliser des abonnements

Si vous débutez avec Azure, vous n’avez qu’un seul abonnement. Cependant, si vous utilisez Azure depuis un certain temps, vous disposez peut-être de plusieurs abonnements. Azure CLI vous permet de configurer l’abonnement sur lequel vos commandes sont exécutées.

Vous ne pouvez être actif que dans un seul abonnement à la fois. Utilisez la commande de référence az account show pour déterminer l’abonnement actuellement actif. Si ce n’est pas l’abonnement correct, vous pouvez changer d’abonnement en utilisant la commande de référence az account set.

  1. Obtenez la liste de tous vos abonnements en retournant les résultats dans une table :

    az account list --output table

  2. Obtenez simplement l’abonnement actif actuel :

    az account show

  3. Modifiez votre abonnement actif :

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

Travailler avec des groupes de ressources

Lorsque vous créez des ressources dans Azure, vous les placez dans un groupe de ressources pour pouvoir les gérer.

Pour créer un groupe de ressources, utilisez la commande de référence az group create. Vous devez spécifier un nom et un emplacement, et le nom doit être unique dans votre abonnement. L’emplacement détermine où sont stockées les métadonnées de votre groupe de ressources, ce qui peut être important pour des raisons de conformité. Utilisez la commande az account list-locations pour déterminer les emplacements disponibles.

Remarque

Si vous travaillez dans un bac à sable Azure, elle crée le groupe de ressources pour vous. Si vous préférez travailler dans votre propre abonnement, utilisez les commandes suivantes.

Voici la syntaxe pour créer un groupe de ressources :

az group create --name MyResourceGroup --location eastus

Pour récupérer une liste de tous les groupes de ressources dans l’abonnement actif, utilisez la commande az group list.

az group list

Pour une vue plus concise, vous pouvez retourner la liste dans une table :

az group list --output table

Quand vous développez et que vous testez un script Azure CLI, il est préférable de créer un groupe de ressources dont le nom contient un ID aléatoire. 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.

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

Exemple : Créer une machine virtuelle Azure

La création de machines virtuelles est une tâche courante que vous pouvez effectuer avec Azure CLI.

La commande az vm create est utilisée pour créer une machine virtuelle. Cette commande a plusieurs paramètres permettant de gérer des valeurs de configuration étendues pour une machine virtuelle. La plupart des paramètres ont des valeurs par défaut raisonnables. Vous devez donc généralement spécifier seulement cinq éléments clés :

  • resource-group : Groupe de ressources où la nouvelle machine virtuelle est placée.
  • name : Nom de la machine virtuelle dans Azure.
  • location : Région géographique où la machine virtuelle est approvisionnée.
  • image : Image du système d’exploitation à utiliser pour la machine virtuelle. Il s’agit généralement d’une distribution Linux ou de Windows Server.
  • admin-username : Nom de l’administrateur pour la machine virtuelle. Vous êtes invité à entrer un mot de passe sur la ligne de commande.

Voici un exemple de 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

Exemple : Obtenir des informations pour une machine virtuelle

Vous pouvez lister les machines virtuelles de votre abonnement à l’aide de la commande az vm list. Cette commande prend également en charge la récupération d’une machine virtuelle spécifique en spécifiant le paramètre --name.

Voici comment stocker l’ID d’une machine virtuelle dans une variable :

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

En utilisant la commande az vm update, changez la taille de votre machine virtuelle :

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

Cet exercice a présenté un modèle classique d’une session Azure CLI interactive. Vous avez commencé par utiliser une commande standard pour créer un nouveau groupe de ressources. Vous avez ensuite utilisé un ensemble de commandes pour déployer une ressource (dans cet exemple, une machine virtuelle) dans ce groupe de ressources. Vous pouvez facilement combiner cet ensemble de commandes dans un script d’interpréteur de commandes et l’exécuter chaque fois que vous avez besoin de créer la même ressource.