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 à travailler sur le pipeline du site web de votre entreprise de jouets, vous devez configurer votre environnement. Dans cette section, vous allez vérifier 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

Ici, vous allez vérifier que votre organisation Azure DevOps est configurée pour effectuer le reste de ce module. Vous la configurerez 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 du parcours d’apprentissage, suivez ces instructions pour créer un projet avec un nouveau nom.

Exécuter le modèle

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

Sur le site Azure DevOps Demo Generator, suivez ces étapes pour exécuter le modèle :

  1. Sélectionnez Sign In et acceptez les conditions d’utilisation.

  2. Dans la page Create New Project, sélectionnez votre organisation Azure DevOps. Entrez ensuite un nom de projet, comme toy-website-test.

    Screenshot that shows creating a project through the Azure DevOps Demo Generator.

  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.

    Screenshot of Azure DevOps that shows the Repos menu, with Files highlighted.

  2. Sélectionnez Cloner.

    Screenshot of Azure DevOps that shows the repository, with the Clone button highlighted.

  3. Si vous utilisez macOS, vous avez besoin d’un mot de passe spécial pour cloner le dépôt Git. Sélectionnez Générer des informations d’identification Git et copiez le nom d’utilisateur et le mot de passe affichés en lieu sûr.

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

    Screenshot of Azure DevOps that shows the repository settings, with the button for cloning in Visual Studio Code highlighted.

  5. Si une boîte de dialogue s’affiche pour vous demander d’autoriser une extension à ouvrir l’URI de dépôt, sélectionnez Ouvrir.

  6. Créez un dossier à utiliser pour le référentiel, choisissez Sélectionner l’emplacement du référentiel.

  7. Si vous utilisez ce référentiel pour la première fois, vous êtes 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.

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

    Screenshot of Visual Studio Code that shows a prompt to open the cloned repository, with the Open button highlighted.

Connexion à Azure

Pour utiliser des groupes de ressources dans Azure, connectez-vous à votre compte Azure à partir du terminal Visual Studio Code. Veillez à installer 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.

  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.

    Screenshot of the Visual Studio Code terminal window, with the bash option shown.

  3. Si un interpréteur de commandes autre que bash s’affiche, sélectionnez la liste déroulante d’interpréteurs de commandes, puis sélectionnez Git Bash (par défaut).

    Screenshot of the Visual Studio Code terminal window, with the terminal shell dropdown shown and Git Bash Default selected.

  4. Dans la liste d’interpréteurs de commandes de terminal, sélectionnez bash, puis le signe plus pour ouvrir un nouveau terminal qui utilise l’interpréteur de commandes bash.

    Screenshot of the Visual Studio Code terminal window, with the bash terminal and the plus sign selected.

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. Vérifiez que vous avez 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.

  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.

    Screenshot of the Visual Studio Code terminal window, with the p w s h option displayed in the shell dropdown.

  3. Si un interpréteur de commandes autre que powershell ou pwsh s’affiche, sélectionnez la liste déroulante d’interpréteurs de commandes, puis sélectionnez PowerShell.

    Screenshot of the Visual Studio Code terminal window, with the terminal shell dropdown shown and powershell selected.

  4. Dans la liste d’interpréteurs de commandes de terminal, sélectionnez powershell ou pwsh, puis sélectionnez le signe plus pour ouvrir un nouveau terminal qui utilise l’interpréteur de commandes powershell ou pwsh.

    Screenshot of the Visual Studio Code terminal window, with the powershell terminal and the plus sign selected.

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 ToyWebsiteTest --location westus3

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

New-AzResourceGroup -Name ToyWebsiteTest -Location westus3

Créer une connexion de service dans Azure Pipelines

Ensuite, créez une connexion de service dans Azure Pipelines. Cette connexion 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.

    Screenshot of Azure DevOps that shows the menu item for project settings highlighted.

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

    Screenshot of Azure DevOps that shows selections for creating a service connection.

  3. Sélectionnez Azure Resource Manager>Suivant.

    Screenshot of Azure DevOps that shows the Azure Resource Manager service connection type highlighted.

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

    Screenshot of Azure DevOps that shows the service principal option highlighted.

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

    Une fenêtre contextuelle peut s’afficher pour vous inviter à vous connecter à Azure. Si c’est le cas, entrez vos informations d’identification et connectez-vous.

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

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

    Screenshot of Azure DevOps that shows the details completed for creating a service connection, with the Save button highlighted.

    Conseil

    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.