Exercice - Créer un registre

Effectué

Notes

La première fois que vous activez un bac à sable et que vous acceptez les conditions d’utilisation, votre compte Microsoft est associé à un nouveau répertoire Azure appelé Microsoft Learn Sandbox (bac à sable Microsoft Learn). Vous êtes également ajouté à un abonnement spécial nommé Abonnement Concierge.

Avant de pouvoir publier les modules Bicep pour le CDN et le site web, vous devez créer un registre pour votre organisation. Publiez ensuite les modules partagés sur le registre. D’autres équipes peuvent alors créer des déploiements qui comprennent les modules partagés.

Dans cet exercice, vous allez :

  • Déployez un nouveau registre privé pour votre entreprise de jouets.
  • Connectez-vous à votre registre pour vérifier qu’il a bien été créé.

Pour déployer ces ressources sur Azure, vous devez vous connecter à votre compte Azure à partir du terminal Visual Studio Code. Veillez à installer Azure CLI et connectez-vous avec le même compte que celui utilisé pour activer le bac à sable.

  1. Dans le menu Terminal, sélectionnez Nouveau terminal. La fenêtre de terminal s’ouvre généralement dans la moitié inférieure de votre écran.

  2. Si l’interpréteur de commandes affiché sur le côté droit de la fenêtre de terminal est bash, il s’agit du bon interpréteur de commandes qui est ouvert et vous pouvez passer à la section suivante.

    Capture d’écran de la fenêtre de terminal Visual Studio Code avec l’option bash affichée.

  3. Si un interpréteur de commandes autre que bash apparaît, sélectionnez la flèche déroulante des interpréteurs de commandes, puis Azure Cloud Shell (Bash).

    Capture d’écran de la fenêtre de terminal Visual Studio Code avec la liste déroulante de l’interpréteur de commande affichée et l’option Git Bash par défaut sélectionnée.

  4. Dans la liste des interpréteurs de commandes de terminal, sélectionnez bash.

    Capture d’écran de la fenêtre de terminal Visual Studio Code avec le terminal bash sélectionné.

  5. Dans le terminal, accédez au répertoire où vous avez enregistré votre modèle. Par exemple, si vous avez enregistré votre modèle dans le dossier templates, vous pouvez utiliser la commande suivante :

    cd templates
    

Installer Bicep

Exécutez la commande suivante pour vous assurer de disposer de la dernière version de Bicep :

az bicep install && az bicep upgrade

Connexion à Azure

  1. Dans le terminal Visual Studio Code, connectez-vous à Azure en exécutant la commande suivante :

    az login
    
  2. Dans le navigateur qui s’ouvre, connectez-vous à votre compte Azure.

    Le terminal Visual Studio Code affiche la liste des abonnements associés à ce compte.

  3. Définissez l’abonnement par défaut pour toutes les commandes Azure CLI que vous exécutez dans cette session.

    az account set --subscription "Concierge Subscription"
    

    Notes

    Si vous avez utilisé plusieurs bacs à sable récemment, le terminal risque d’afficher plusieurs instances de l’abonnement Concierge. Dans ce cas, utilisez les deux étapes suivantes pour en définir un comme l’abonnement par défaut. Si la commande précédente a réussi et qu’un seul abonnement Concierge est listé, ignorez les deux étapes suivantes.

  4. Obtenez les ID des abonnements Concierge.

     az account list \
       --refresh \
       --query "[?contains(name, 'Concierge Subscription')].id" \
       --output table
    
  5. Définissez l’abonnement par défaut en utilisant l’ID d’abonnement. Remplacez {your subscription ID} par l’ID du dernier abonnement Concierge.

    az account set --subscription {your subscription ID}
    

Définir le groupe de ressources par défaut

Quand vous utilisez Azure CLI, vous pouvez définir le groupe de ressources par défaut et omettre le paramètre du reste des commandes Azure CLI dans cet exercice. Définissez le paramètre par défaut sur le groupe de ressources qui est créé pour vous dans l’environnement de bac à sable.

az configure --defaults group="<rgn>[sandbox resource group name]</rgn>"

Pour déployer ces ressources sur Azure, vous devez vous connecter à votre compte Azure à partir du terminal Visual Studio Code. Vérifiez que vous avez installé Azure PowerShell et connectez-vous au même compte que celui qui a activé le bac à sable.

  1. Dans le menu Terminal, sélectionnez Nouveau terminal. La fenêtre de terminal s’ouvre généralement dans la moitié inférieure de votre écran.

  2. Si l’interpréteur de commandes affiché sur le côté droit de la fenêtre de terminal est powershell ou pwsh, il s’agit du bon interpréteur de commandes qui est ouvert et vous pouvez passer à la section suivante.

    Capture d’écran de la fenêtre de terminal Visual Studio Code, avec l’option pwsh indiquée dans la liste déroulante de l’interpréteur de commande.

  3. Si un shell autre que powershell ou pwsh apparaît, sélectionnez la flèche déroulante des interpréteurs de commandes, puis PowerShell.

    Capture d’écran de la fenêtre de terminal Visual Studio Code avec la liste déroulante de l’interpréteur de commande affichée avec PowerShell sélectionné.

  4. Dans la liste d’interpréteurs de commandes de terminal, sélectionnez powershell ou pwsh.

    Capture d’écran de la fenêtre de terminal Visual Studio Code avec le terminal PowerShell sélectionné.

  5. Dans le terminal, accédez au répertoire où vous avez enregistré votre modèle. Par exemple, si vous avez enregistré votre modèle dans le dossier templates, vous pouvez utiliser la commande suivante :

    Set-Location -Path templates
    

Installer l’interface CLI Bicep

Pour utiliser Bicep à partir d’Azure PowerShell, installez l’interface CLI de Bicep.

Connectez-vous à Azure en utilisant Azure PowerShell

  1. Dans le terminal Visual Studio Code, exécutez la commande suivante :

    Connect-AzAccount
    

    Un navigateur s’ouvre pour vous permettre de vous connecter à votre compte Azure.

  2. Une fois que vous êtes connecté à Azure, le terminal affiche une liste des abonnements associés à ce compte.

    Si vous avez activé le bac à sable, un abonnement appelé Abonnement Concierge s’affiche. Utilisez-le pour le reste de l’exercice.

  3. Définissez l’abonnement par défaut pour toutes les commandes Azure PowerShell que vous exécutez dans cette session.

    $context = Get-AzSubscription -SubscriptionName 'Concierge Subscription'
    Set-AzContext $context
    

    Notes

    Si vous avez utilisé plusieurs bacs à sable récemment, le terminal risque d’afficher plusieurs instances de l’abonnement Concierge. Dans ce cas, utilisez les deux étapes suivantes pour en définir un comme l’abonnement par défaut. Si la commande précédente a réussi et qu’un seul abonnement Concierge est listé, ignorez les deux étapes suivantes.

  4. Obtenir l’ID d’abonnement. L’exécution de la commande suivante liste vos abonnements et leurs ID. Recherchez Concierge Subscription, puis copiez l’ID de la deuxième colonne. Il doit ressembler à ceci : cf49fbbc-217c-4eb6-9eb5-a6a6c68295a0.

    Get-AzSubscription
    
  5. Remplacez votre abonnement actif par l’abonnement Concierge. Veillez à remplacer {Votre ID d’abonnement} par celui que vous avez copié.

    $context = Get-AzSubscription -SubscriptionId {Your subscription ID}
    Set-AzContext $context
    

Définir votre groupe de ressources par défaut

Vous pouvez définir le groupe de ressources par défaut et omettre le paramètre du reste des commandes Azure PowerShell dans cet exercice. Définissez ce paramètre par défaut sur le groupe de ressources créé pour vous dans l’environnement de bac à sable.

Set-AzDefault -ResourceGroupName <rgn>[sandbox resource group name]</rgn>

Créer un registre de conteneur

Ici, vous créez un nouveau registre pour stocker et partager vos modules Bicep. Cet exemple utilise Azure Container Registry.

  1. Sélectionnez un nom unique pour votre registre de conteneurs. Le nom doit être globalement unique dans tout Azure. Choisissez un nom de 5 à 50 caractères contenant des lettres et des chiffres. Vous utilisez le nom dans les étapes suivantes.

  2. Créez un registre de conteneurs en exécutant cette commande dans le terminal Visual Studio Code. Remplacez l’espace réservé YOUR_CONTAINER_REGISTRY_NAME par le nom que vous avez sélectionné à l’étape précédente.

    az acr create \
      --name YOUR_CONTAINER_REGISTRY_NAME \
      --sku Basic \
      --location westus
    

Conseil

Vous pouvez également créer un registre de conteneurs en utilisant Bicep. Dans cet exemple, nous utilisons Azure CLI pour plus de simplicité.

  1. Sélectionnez un nom unique pour votre registre de conteneurs. Le nom doit être globalement unique dans tout Azure. Choisissez un nom de 5 à 50 caractères contenant des lettres et des chiffres. Vous utilisez le nom dans les étapes suivantes.

  2. Créez un registre de conteneurs en exécutant cette commande dans le terminal Visual Studio Code. Remplacez l’espace réservé YOUR_CONTAINER_REGISTRY_NAME par le nom que vous avez sélectionné à l’étape précédente.

    New-AzContainerRegistry `
      -Name YOUR_CONTAINER_REGISTRY_NAME `
      -Sku Basic `
      -Location westus
    

Conseil

Vous pouvez également créer un registre de conteneurs en utilisant Bicep. Dans cet exemple, nous utilisons la cmdlet Azure PowerShell pour plus de simplicité.

Répertorier les modules dans votre registre

Maintenant que vous avez créé votre registre, vous pouvez vous y connecter pour vérifier qu’il fonctionne.

  1. Répertoriez les modules dans le registre en exécutant cette commande. Remplacez l’espace réservé YOUR_CONTAINER_REGISTRY_NAME par le nom que vous avez sélectionné précédemment.

    az acr repository list \
      --name YOUR_CONTAINER_REGISTRY_NAME
    

    Notez que vous ne spécifiez pas d’informations d’identification pour la connexion au registre de conteneurs. Azure CLI utilise les mêmes informations d’identification que celles utilisées pour la connexion à Azure CLI. Vous avez accès au registre de conteneurs, car vous l’avez créé.

  2. La commande Azure CLI retourne une liste sans résultats :

    []
    

    Vous ne voyez aucun résultat, car vous n’avez pas encore publié de modules. Vous en apprendrez davantage sur la publication des modules dans l’unité suivante.

  1. Répertoriez les modules dans le registre en exécutant cette commande. Remplacez l’espace réservé YOUR_CONTAINER_REGISTRY_NAME par le nom que vous avez sélectionné précédemment.

    Get-AzContainerRegistryRepository `
      -RegistryName YOUR_CONTAINER_REGISTRY_NAME
    

    Notez que vous ne spécifiez pas d’informations d’identification pour la connexion au registre de conteneurs. Azure PowerShell utilise les mêmes informations d’identification que celles utilisées pour la connexion aux applets de commande Azure PowerShell. Vous avez accès au registre de conteneurs, car vous l’avez créé.

  2. La cmdlet Azure PowerShell n’affiche aucune sortie.

    Il n’y a aucun résultat, car vous n’avez pas encore publié de modules. Vous en apprendrez davantage sur la publication des modules dans l’unité suivante.