Exercice : Configurer votre environnement

6 minutes

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 unité, vous vérifiez que vos environnements Azure et Azure DevOps sont configurés pour suivre 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 deux groupes de ressources dans Azure.
Créer deux environnements et connexions de service dans Azure Pipelines.
Supprimer les ressources dont vous n’avez pas besoin dans le projet Azure DevOps créé au préalable.

Obtenir le projet Azure DevOps

Vérifiez 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 à lui attribuer un nouveau nom.

Exécuter le modèle

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

Exécuter le modèle

Sur le site Azure DevOps Demo Generator, effectuez les étapes suivantes :

Sélectionnez Sign In et acceptez les conditions d’utilisation.
Dans la page Create New Project, sélectionnez votre organisation Azure DevOps. Entrez ensuite un nom de projet, comme toy-website-environments.
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.
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

Sélectionnez Dépôts>Fichiers.
Sélectionnez Cloner.
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.
Sélectionnez Cloner dans VS code. Si vous êtes invité à autoriser l’ouverture de Visual Studio Code, sélectionnez Ouvrir.
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.
Créez un dossier à utiliser pour le référentiel, choisissez Sélectionner l’emplacement du référentiel.
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.
Visual Studio Code vous invite à ouvrir le référentiel. Sélectionnez Ouvrir.

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.

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.
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.
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).
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.

Dans le terminal Visual Studio Code, exécutez la commande suivante pour vous connecter à Azure :
```
az login
```
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.

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.
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.
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.
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.

Dans le terminal Visual Studio Code, exécutez la commande suivante pour vous connecter à Azure :
```
Connect-AzAccount
```
Dans le navigateur qui s’ouvre, connectez-vous à votre compte Azure.

Créer deux groupes de ressources dans Azure

Pour créer les deux nouveaux groupes de ressources, exécutez les commandes Azure CLI suivantes dans le terminal Visual Studio Code :

az group create --name ToyWebsiteTest --location westus3
az group create --name ToyWebsiteProduction --location westus3

Pour créer les deux nouveaux groupes de ressources, exécutez les commandes Azure PowerShell suivantes dans le terminal Visual Studio Code :

New-AzResourceGroup -Name ToyWebsiteTest -Location westus3
New-AzResourceGroup -Name ToyWebsiteProduction -Location westus3

Créer des connexions de service dans Azure Pipelines

Ensuite, créez deux connexions de service dans Azure Pipelines : une pour votre environnement de test et l’autre pour votre environnement de production. 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.

Dans votre navigateur, sélectionnez Paramètres du projet.
Sélectionnez Connexions de service>Créer une connexion de service.
Sélectionnez Azure Resource Manager>Suivant.
Sélectionnez Principal de service (automatique)>Suivant.
Dans la liste déroulante Abonnement, sélectionnez votre abonnement Azure.

Une fenêtre contextuelle peut s’afficher et vous inviter à vous connecter à Azure. Si c’est le cas, entrez vos informations d’identification et connectez-vous.
Dans la liste déroulante Groupe de ressources, sélectionnez ToyWebsiteTest.
Dans Nom de la connexion au service, entrez ToyWebsiteTest. Assurez-vous que la case Accorder une autorisation d’accès à tous les pipelines est cochée, puis sélectionnez Enregistrer.

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.
Répétez le processus précédent pour créer une autre connexion de service nommée ToyWebsiteProduction, qui est déployée dans le groupe de ressources nommé ToyWebsiteProduction.

Si la liste de groupes de ressources n’est pas mise à jour, actualisez la page dans votre navigateur, puis réessayez.

Créer des environnements dans Azure Pipelines

Dans votre navigateur, accédez à Pipelines>Environnements.
Sélectionnez Nouvel environnement.
Entrez Test comme nom d’environnement.

Laissez la description vide. Dans Ressource, sélectionnez Aucune. Sélectionnez ensuite Créer.

Notes

Dans Azure Pipelines, les environnements sont utilisés pour activer les fonctionnalités de déploiement. Certaines de ces fonctionnalités s’appliquent seulement quand vous effectuez un déploiement sur Kubernetes ou sur des machines virtuelles. Dans ce module, nous n’utilisons pas ces fonctionnalités et vous pouvez les ignorer.

Pour qu’un pipeline puisse utiliser l’environnement, vous devez lui accorder l’autorisation. Par souci de simplicité, vous autorisez tous les pipelines à accéder à l’environnement. Dans vos propres pipelines, vous devez restreindre l’accès aux environnements uniquement aux pipelines qui en ont besoin.
Sélectionnez le bouton avec trois points et sélectionnez Sécurité.
Dans la section intitulée Autorisations de pipeline, s’il existe un bouton Restreindre l’autorisation, sélectionnez-le.
Sélectionnez le bouton avec trois points. Sélectionnez Ouvrir l’accès.
Cliquez deux fois sur la flèche gauche pour revenir à la liste des environnements.
Répétez le processus pour créer un autre environnement nommé Production. N’oubliez pas de le configurer pour ouvrir l’accès.

Laissez la page de l’environnement de production ouverte.

Ajouter une vérification d’approbation à l’environnement de production

En haut à droite de la page, sélectionnez le bouton avec trois points et sélectionnez Approbations et vérifications dans le menu contextuel.
Sélectionnez Approbations.
Dans la zone de texte Approbateurs, tapez votre nom et sélectionnez-vous.
Sélectionnez le bouton avec la flèche en regard de Avancé.

Notez que, par défaut, les approbateurs sont autorisés à approuver les exécutions qu’ils ont déclenchées. Étant donné que vous êtes la seule personne qui va utiliser ce pipeline, laissez cette case cochée. Dans d’autres organisations, vous devrez peut-être spécifier un autre approbateur pour répondre aux exigences de conformité.
Sélectionnez Créer.

Supprimer l’ancien environnement

Dans les versions précédentes du pipeline, vous utilisiez un environnement unique nommé Site web. Maintenant que vous avez créé des environnements de pipeline qui représentent vos nouveaux environnements, vous allez supprimer l’ancien environnement de pipeline.

Accédez à Pipelines>Environnements.
Sélectionnez l’environnement Site web.
En haut à droite de la page, sélectionnez le bouton avec trois points et sélectionnez Supprimer dans le menu contextuel.
Sélectionnez Supprimer pour confirmer la suppression.

Supprimer les anciennes variables

Dans les versions précédentes du pipeline, vous avez utilisé un ensemble unique de variables pour définir les paramètres et la configuration du déploiement. Maintenant que vous déployez dans plusieurs environnements, vous pouvez supprimer ces variables et les remplacer rapidement par des ensembles de variables spécifiques à l’environnement.

Accédez à Pipelines>Pipelines.
Sélectionnez le pipeline toy-website-environments.
Sélectionnez le bouton Modifier.
Sélectionnez le bouton Variables.
Sélectionnez le bouton Supprimer une variable pour chacune des trois variables.
Sélectionnez Enregistrer.