Exercice : Configurer votre environnement

Effectué

Important

Vous avez besoin de votre propre abonnement Azure pour exécuter cet exercice et des frais pourraient vous être facturés. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Avant de commencer à publier le code Bicep réutilisable de votre entreprise de jouets, vous devez configurer votre environnement. Dans cette section, vous vérifiez que vos environnements Azure et Azure DevOps sont configurés pour effectuer le reste de ce module.

Pour atteindre ces objectifs, vous allez :

  • Configurez un projet Azure DevOps pour ce module.
  • Cloner le dépôt du projet sur votre ordinateur.
  • Créer un groupe de ressources dans Azure.
  • Créer une connexion de service dans Azure Pipelines.

Obtenir le projet Azure DevOps

Dans cette section, vous allez vérifier que votre organisation Azure DevOps est configurée pour effectuer les étapes restantes de ce module. Vous la configurez en exécutant un modèle qui crée un projet dans Azure DevOps.

Les modules de ce parcours d’apprentissage font partie d’une progression. Pour les besoins de l’apprentissage, chaque module est associé à un projet Azure DevOps.

Conseil

Même si vous avez terminé le module précédent dans le parcours d’apprentissage, suivez ces instructions pour créer un nouveau projet. Veillez à attribuer un nouveau nom au projet.

Exécuter le modèle

Exécuter un modèle qui configure votre projet Azure DevOps.

Sur le site Générateur de démonstration Azure DevOps :

  1. Sélectionnez Sign In, puis acceptez les conditions d’utilisation du site en sélectionnant Accept.

  2. Dans la page Create New Project, sélectionnez votre organisation Azure DevOps, puis, dans la zone New Project Name, entrez un nom de projet, tel que toy-reusable.

    Capture d’écran du volet Azure DevOps Demo Generator pour la création d’un nouveau projet

  3. Sélectionnez Create Project.

    L’exécution du modèle prend quelques instants. Il crée automatiquement un pipeline et un fichier Bicep que vous allez utiliser dans les exercices suivants.

  4. Sélectionnez Navigate to project pour accéder à votre projet dans Azure DevOps.

Important

L’exercice final de ce module contient des étapes de nettoyage importantes. Veillez à suivre les étapes de nettoyage même si vous n’allez pas au bout de ce module.

Cloner le référentiel

  1. Sélectionnez Dépôts>Fichiers.

    Capture d’écran d’Azure DevOps montrant le menu Dépôts, avec Fichiers en surbrillance.

  2. Sélectionnez Cloner.

    Capture d’écran d’Azure DevOps montrant le dépôt, avec le bouton Cloner en surbrillance.

  3. Cliquez sur Générer les informations d'identification Git. Copiez votre mot de passe et enregistrez-le. Vous aurez besoin de ces informations d’identification lors de l’authentification auprès de votre référentiel lorsque vous validez ultérieurement les mises à jour dans vos fichiers YAML.

    Capture d’écran d’Azure DevOps montrant les paramètres du référentiel, avec le bouton Générer des informations d’identification Git mis en surbrillance.

  4. Sélectionnez Cloner dans VS code. Si vous êtes invité à autoriser l’ouverture de Visual Studio Code, sélectionnez Ouvrir.

    Capture d’écran d’Azure DevOps montrant les paramètres du dépôt, avec le bouton Cloner dans VS Code mis en évidence.

  5. Créez un dossier à utiliser pour le référentiel, puis sélectionnez Sélectionner l’emplacement du référentiel.

  6. Si vous utilisez ce référentiel pour la première fois, vous pouvez être invité à vous connecter.

    • Si vous utilisez Windows, entrez les informations d’identification que vous avez précédemment utilisées pour vous connecter à Azure DevOps dans cet exercice.

    • Si vous utilisez macOS, entrez le nom d’utilisateur et le mot de passe Git que vous avez générés il y a quelques instants.

  7. Visual Studio Code vous invite à ouvrir le référentiel. Sélectionnez Ouvrir.

    Capture d’écran de Visual Studio Code avec une invite pour ouvrir le référentiel cloné et le bouton Ouvrir en surbrillance.

Connexion à Azure

Pour utiliser des groupes de ressources dans Azure, connectez-vous à votre compte Azure à partir du terminal Visual Studio Code. Assurez-vous que vous avez déjà installé les outils Azure CLI.

  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.

    L’interpréteur de commandes par défaut est généralement pwsh, comme indiqué sur le côté droit de la fenêtre de terminal.

    Capture d’écran de la fenêtre de terminal de Visual Studio Code, dans laquelle pwsh est l’option d’interpréteur de commandes.

  2. Sélectionnez la liste déroulante Lancer le profil, puis sélectionnez Azure Cloud Shell (Bash).

    Capture d’écran de la fenêtre du terminal Visual Studio Code. La liste déroulante de l’interpréteur de commandes de terminal et l’élément de menu Azure Cloud Shell (Bash) sont affichés.

    Un nouvel interpréteur de commandes s’ouvre.

Connexion à Azure avec l’interface Azure CLI

  1. Dans le terminal Visual Studio Code, exécutez la commande suivante pour vous connecter à Azure :

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

Pour utiliser des groupes de ressources dans Azure, connectez-vous à votre compte Azure à partir du terminal Visual Studio Code. Assurez-vous que vous avez déjà installé Azure PowerShell.

  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.

    L’interpréteur de commandes par défaut est généralement pwsh, comme indiqué sur le côté droit de la fenêtre de terminal.

    Capture d’écran de la fenêtre de terminal de Visual Studio Code, dans laquelle pwsh est l’option d’interpréteur de commandes.

  2. Sélectionnez la liste déroulante Lancer le profil, puis sélectionnez Azure Cloud Shell (PowerShell).

    Capture d’écran de la fenêtre du terminal Visual Studio Code. La liste déroulante de l’interpréteur de commandes de terminal et l’élément de menu Azure Cloud Shell (PowerShell) sont affichés.

    Un nouvel interpréteur de commandes s’ouvre.

Connectez-vous à Azure en utilisant Azure PowerShell

  1. Dans le terminal Visual Studio Code, exécutez la commande suivante pour vous connecter à Azure :

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

Créer un groupe de ressources dans Azure

Pour créer un groupe de ressources, exécutez cette commande Azure CLI dans le terminal Visual Studio Code :

az group create --name ToyReusable --location westus3

Exécutez cette commande Azure PowerShell dans le terminal Visual Studio Code pour créer un groupe de ressources :

New-AzResourceGroup -Name ToyReusable -Location westus3

Créer une connexion de service dans Azure Pipelines

Ensuite, créez une connexion de service dans Azure Pipelines. Ce processus crée automatiquement un principal de service dans Azure. Cela accorde également au principal du service le rôle Contributeur sur votre groupe de ressources, ce qui permet au pipeline de déployer sur le groupe de ressources.

  1. Dans votre navigateur, sélectionnez Paramètres du projet.

    Capture d’écran d’Azure DevOps montrant le menu, avec l’élément Paramètres du projet mis en évidence.

  2. Sélectionnez Connexions de service>Créer une connexion de service.

    Capture d’écran d’Azure DevOps montrant le volet « Connexions de service » avec le bouton « Créer une connexion de service » en surbrillance

  3. Sélectionnez Azure Resource Manager>Suivant.

    Capture d’écran d’Azure DevOps montrant le volet « Connexions de service » avec le type de connexion de service « Azure Resource Manager » en surbrillance

  4. Sélectionnez Principal de service (automatique)>Suivant.

    Capture d’écran d’Azure DevOps montrant le volet Nouvelle connexion au service Azure, avec l’option Principal de service (automatique) mise en évidence.

  5. Dans la liste déroulante Abonnement, sélectionnez votre abonnement Azure.

    Si une fenêtre contextuelle s’affiche avec un message vous invitant à vous connecter à Azure, entrez vos informations d’identification et connectez-vous.

  6. Dans la liste déroulante Groupe de ressources, sélectionnez ToyReusable.

  7. Dans la zone Nom de la connexion au service, entrez ToyReusable. Assurez-vous que la case Autoriser l’accès à tous les pipelines est cochée.

    Capture d’écran d’Azure DevOps qui montre le volet « Nouvelle connexion au service Azure », avec les détails renseignés et le bouton « Enregistrer » en surbrillance.

    Conseil

    Dans cet exercice, par souci de simplicité, vous donnez à tous les pipelines l’accès à votre connexion de service. Lorsque vous créez des connexions de service réelles qui fonctionnent avec des ressources en production, limitez l’accès aux pipelines qui en ont besoin.

  8. Sélectionnez Enregistrer.