Ajouter et configurer un catalogue à partir de GitHub ou d’Azure Repos

Cet article explique comment ajouter et configurer un catalogue dans votre projet ou centre de développement Environnements de déploiement Azure.

Les catalogues vous aident à fournir un ensemble de modèles d’infrastructure en tant que code (IaC) organisés, appelés définitions d’environnement, que vos équipes de développement peuvent utiliser pour créer des environnements. Vous pouvez attacher votre propre référentiel de contrôle de code source à partir de GitHub ou d’Azure Repos en tant que catalogue et spécifier le dossier avec vos définitions d’environnement. Environnements de déploiement analyse le dossier à la recherche de définitions d’environnement et les rend disponibles pour les équipes de développement afin de créer des environnements.

Pour sécuriser davantage vos modèles, le catalogue est chiffré. Le service Environnements de déploiement Azure prend en charge le chiffrement au repos avec des clés de chiffrement gérées par la plateforme, qui sont gérées par Microsoft pour les services Azure.

• Pour savoir comment héberger un référentiel dans GitHub, consultez Démarrage avec GitHub.
• Pour savoir comment héberger un référentiel Git dans un projet Azure Repos, consultez Azure Repos.

Microsoft propose un catalogue de démarrage rapide que vous pouvez ajouter au projet ou centre de développement, ainsi qu’un exemple de catalogue que vous pouvez utiliser en tant que référentiel. Vous pouvez également utiliser votre propre référentiel privé, ou vous pouvez dupliquer (fork) et personnaliser les définitions d’environnement dans l’exemple de catalogue.

Dans cet article, vous apprendrez comment :

1. Configurer des catalogues au niveau du projet
2. Configurer une identité managée
3. Ajouter un catalogue à partir d’Azure Repos ou de GitHub
4. Mettre à jour un catalogue
5. Supprimer un catalogue
6. Résoudre les erreurs de synchronisation des catalogues

Configurer des catalogues au niveau du projet

L’attachement de catalogues au niveau du projet permet aux ingénieurs de plateforme de fournir des définitions d’environnement organisées spécifiques aux équipes de développement. En outre, cela permet aux responsables de l’équipe de développement affectés en tant qu’administrateurs de projet de gérer les définitions d’environnement mises à la disposition de leurs équipes.

Les ingénieurs de plateforme ont un contrôle total sur l’utilisation des catalogues au niveau du projet. L’utilisation des catalogues au niveau du projet doit être activée au niveau du centre de développement avant qu’un catalogue puisse être ajouté à un projet. Les ingénieurs de plateforme peuvent également configurer quels types d’éléments de catalogue, tels que les définitions d’environnement, peuvent être consommés au niveau du projet.

Par défaut, l’utilisation de catalogues au niveau du projet est désactivée et aucun des types d’éléments de catalogue n’est activé. Les définitions d’environnement d’un catalogue de niveau projet sont synchronisées et utilisables sous deux conditions. Tout d’abord, vous devez activer les catalogues basés sur des projets au niveau du centre de développement correspondant. Ensuite, vous devez activer l’utilisation des définitions d’environnement pour le projet.

Ajouter un catalogue à un projet

Vous devez activer les catalogues de niveau projet au niveau du centre de développement avant de pouvoir ajouter un catalogue à un projet. Vous devez également activer l’utilisation des définitions d’environnement au niveau du projet.

Pour activer l’utilisation de catalogues de niveau projet au niveau du centre de développement :

1. Dans le portail Azure, accédez à votre centre de développement.

2. Dans le menu de gauche, sous Paramètres, sélectionnez Configuration.

   

3. Dans le volet Catalogues de niveau projet, sélectionnez Activer les catalogues par projet, puis Appliquer.

   

Pour activer l’utilisation des définitions d’environnement dans le projet :

1. Dans le portail Azure, accédez à votre projet.

2. Dans le menu de gauche, sous Paramètres, sélectionnez Catalogues.

   

3. Dans la page Catalogues, sélectionnez Autorisations des éléments de catalogue.

   

4. Dans le volet Paramètres des éléments de catalogue, sélectionnez Définitions de l’environnement de déploiement Azure pour activer l’utilisation des définitions d’environnement au niveau du projet.

   

À présent, vous pouvez ajouter un catalogue au projet.

Pour les catalogues qui utilisent une identité managée ou un jeton d’accès personnel (PAT) pour l’authentification, vous devez attribuer une identité managée pour le projet. Pour les catalogues qui utilisent un jeton PAT, vous devez stocker le jeton PAT dans un coffre de clés et accorder à l’identité managée l’accès au secret du coffre de clés.

Configurer une identité managée

Avant de pouvoir attacher un catalogue à un projet ou centre de développement, vous devez configurer une identité managée, également appelée MSI (Managed Service Identity). Vous pouvez attacher une identité managée affectée par le système (identité MSI affectée par le système) ou une identité managée affectée par l’utilisateur (identité MSI affectée par l’utilisateur). Vous attribuez ensuite des rôles à l’identité managée pour permettre au projet ou centre de développement de créer des types d’environnements dans votre abonnement, et de lire le projet Azure Repos qui contient le référentiel de catalogue.

Si aucune identité MSI n’est attachée à votre projet ou centre de développement, suivez les étapes décrites dans Configurer une identité managée pour en créer une et attribuer des rôles pour l’identité managée.

Pour en savoir plus sur les identités managées, consultez Que sont les identités managées pour les ressources Azure ?

Ajouter un catalogue

Vous pouvez ajouter un catalogue depuis un référentiel Azure Repos ou un référentiel GitHub. Vous pouvez choisir d’effectuer l’authentification en affectant des autorisations à une identité MSI, ou en utilisant un jeton PAT, que vous stockez dans un coffre de clés.

Sélectionnez l’onglet correspondant au type de référentiel et d’authentification à utiliser.

Référentiel Azure Repos avec MSI

Pour ajouter un catalogue, effectuez les tâches suivantes :

• Attribuez des autorisations dans Azure Repos pour l’identité managée.
• Ajouter votre dépôt en tant que catalogue

Attribuer des autorisations dans Azure Repos pour l’identité managée

Vous devez accorder à l’identité managée des autorisations sur le référentiel dans Azure Repos.

1. Connectez-vous à votre organisation Azure DevOps.

   Remarque

   Votre organisation Azure DevOps doit se trouver dans le même annuaire que l’abonnement Azure qui contient votre projet ou centre de développement.

2. Sélectionnez Paramètres de l’organisation.

   

3. Dans la page Vue d’ensemble, sélectionnez Utilisateurs.

   

4. Dans la page Utilisateurs, sélectionnez Ajouter des utilisateurs.

   

5. Terminez Ajouter de nouveaux utilisateurs en entrant ou en sélectionnant les informations suivantes, puis sélectionnez Ajouter :

   Nom	Valeur
   Utilisateurs ou principaux de service	Entrez le nom de votre projet ou centre de développement. Quand vous utilisez une MSI affectée par le système, spécifiez le nom du projet ou centre de développement, et non l’ID d’objet du compte managé. Quand vous utilisez une identité MSI affectée par l’utilisateur, utilisez le nom du compte managé.
   Niveau d’accès	Sélectionnez De base.
   Ajouter aux projets	Sélectionnez le projet qui contient votre référentiel.
   Groupes Azure DevOps	Sélectionnez Lecteurs de projet.
   Envoyer des invitations par e-mail (aux utilisateurs uniquement)	Désactivez la case à cocher.

   

Ajouter votre dépôt en tant que catalogue

Les Environnements de déploiement Azure prennent en charge l’attachement de référentiels Azure Repos et de référentiels GitHub. Vous pouvez stocker un ensemble de modèles IaC organisés dans un référentiel. L’attachement du référentiel à un projet ou centre de développement en tant que catalogue permet à vos équipes de développement d’accéder aux modèles et leur permet de créer rapidement des environnements cohérents.

Les étapes suivantes vous permettent d’attacher un référentiel Azure Repos.

1. Sur le Portail Azure, accédez à votre projet ou centre de développement.

2. Dans le menu de gauche, sous Configuration de l’environnement, sélectionnez Catalogues, puis sélectionnez Ajouter.

   

3. Dans Ajouter un catalogue, entrez les informations suivantes, puis sélectionnez Ajouter :

   Champ	Valeur
   Nom	Entrez un nom pour le catalogue.
   Emplacement du catalogue	Sélectionner Azure DevOps.
   Type d’authentification	Sélectionnez Identité managée.
   Organisation	Sélectionnez votre organisation Azure DevOps.
   Projet	Dans la liste des projets, sélectionnez le projet qui stocke le référentiel.
   Référentiel	Dans la liste des référentiels, sélectionnez le référentiel que vous souhaitez ajouter.
   Branche	Sélectionnez la branche.
   Chemin d’accès du dossier	Dev Box récupère une liste de dossiers dans votre branche. Sélectionnez le dossier qui stocke vos modèles IaC.

   

4. Dans Catalogues pour le projet ou centre de développement, vérifiez que votre catalogue est visible. Une fois la connexion établie, l’État affiche Synchronisation réussie. La connexion à un catalogue peut prendre quelques minutes la première fois.

Référentiel Azure Repos avec PAT

Pour ajouter un catalogue, effectuez les tâches suivantes :

• Obtenir l’URL de clonage de votre référentiel Azure Repos.
• Créez un jeton PAT (jeton d’accès personnel).
• Stockez le jeton PAT en tant que secret de coffre de clés dans Azure Key Vault.
• Ajouter votre dépôt en tant que catalogue

Obtenir l’URL de clonage de votre référentiel Azure Repos

1. Accédez à la page d’accueil de votre collection d’équipe (par exemple, https://contoso-web-team.visualstudio.com), puis sélectionnez votre projet.

2. Obtenez l’URL de clonage de votre référentiel Git Azure Repos.

3. Copiez et enregistrez l’URL.

Créer un jeton d’accès personnel dans Azure Repos

1. Accédez à la page d’accueil de votre collection d’équipe (par exemple, https://contoso-web-team.visualstudio.com), puis sélectionnez votre projet.

2. Créez un jeton PAT.

3. Copiez et enregistrez le jeton généré pour l’utiliser plus tard.

Créer un coffre de clés

Vous avez besoin d’un Azure Key Vault pour stocker le jeton PAT utilisé pour octroyer à Azure l’accès à votre référentiel. Les coffres de clés peuvent contrôler l’accès à l’aide de stratégies d’accès ou du contrôle d’accès en fonction du rôle (RBAC). Si vous disposez d’un coffre de clés existant, vous pouvez l’utiliser, mais vous devez vérifier s’il utilise des stratégies d’accès ou des affectations RBAC pour contrôler l’accès. Si vous souhaitez obtenir de l’aide sur la configuration d’une stratégie d’accès pour un coffre de clés, veuillez consulter la rubrique Attribuer une stratégie d’accès au coffre de clés.

Suivez les étapes ci-dessous pour créer un coffre de clés RBAC :

1. Connectez-vous au portail Azure.

2. Dans la zone de recherche, entrez Key Vault.

3. Dans la liste des résultats, sélectionnez Key Vault.

4. Dans la page du coffre de clés, sélectionnez Créer.

5. Sous l’onglet Créer un coffre de clés, indiquez les informations suivantes :

   Nom	Valeur
   Nom	Entrez un nom pour le coffre de clés.
   Abonnement	Sélectionnez l’abonnement dans lequel vous souhaitez créer le coffre de clés.
   Groupe de ressources	Utilisez un groupe de ressources existant ou sélectionnez Créer un nouveau , puis entrez un nom pour le groupe de ressources.
   Lieu	Sélectionnez l’emplacement ou la région où vous souhaitez créer le coffre de clés.

   Conservez les valeurs par défaut des autres options.

6. Sous l’onglet Stratégie d’accès, sélectionnez Contrôle d’accès en fonction du rôle Azure, puis sélectionnez Vérifier + créer.

7. Sous l’onglet Review + create (Vérifier + créer) , sélectionnez Créer.

Si les stratégies de votre organisation vous obligent à maintenir votre Key Vault privé à partir d’Internet, vous pouvez définir votre Key Vault pour autoriser les services Microsoft approuvés à contourner votre règle de pare-feu.

Pour savoir comment autoriser les services Microsoft approuvés à contourner le pare-feu, consultez Configurer les paramètres de mise en réseau Azure Key Vault.

Stocker le jeton d’accès personnel dans le coffre de clés

1. Dans le coffre de clés, dans le menu de gauche, sélectionnez Secrets.

2. Dans la page Secrets, sélectionnez Générer/Importer.

3. Dans la page Créer un secret :

   • Dans le champ Nom, entrez un nom descriptif pour votre secret.
   • Dans la zone Valeur de secret, collez le jeton PAT que vous avez copié.
   • Sélectionnez Créer.

Obtenir l’identificateur de secret

Obtenez le chemin du secret que vous avez créé dans le coffre de clés.

1. Dans le portail Azure, accédez à votre coffre de clés.

2. Dans la page Coffre de clés, dans le menu de gauche, sélectionnez Secrets.

3. Dans la page Secrets, sélectionnez le secret que vous avez créé.

4. Sur la page des versions, sélectionnez VERSION ACTUELLE.

5. Dans la page de version actuelle, pour Identificateur de secret, sélectionnez Copier.

Ajouter votre dépôt en tant que catalogue

1. Sur le Portail Azure, accédez à votre projet ou centre de développement.

2. Vérifiez que l’identité attachée au projet ou centre de développement a accès au secret du coffre de clés où votre jeton d’accès personnel est stocké.

3. Dans le menu de gauche, sous Configuration de l’environnement, sélectionnez Catalogues, puis sélectionnez Ajouter.

4. Dans Ajouter un catalogue, entrez les informations suivantes, puis sélectionnez Ajouter :

   Champ	Valeur
   Nom	Entrez un nom pour le catalogue.
   Emplacement du catalogue	Sélectionner Azure DevOps.
   Type d’authentification	Sélectionnez Jeton d’accès personnel.
   Organisation	Sélectionnez l’organisation qui héberge le référentiel de catalogue.
   Projet	Sélectionnez le projet qui stocke le référentiel de catalogue.
   Référentiel	Sélectionnez le référentiel qui stocke le catalogue.
   Chemin d’accès du dossier	Sélectionnez le dossier qui contient vos modèles IaC.
   Identificateur de secret	Entrez l’identificateur de secret qui contient votre jeton PAT pour le référentiel. Lorsque vous copiez un identificateur de secret, la chaîne de connexion inclut un identificateur de version à la fin, par exemple : https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. La suppression de l’identificateur de version garantit que les Environnements de déploiement récupèrent la dernière version du secret à partir du coffre de clés. Si votre PAT expire, seul le coffre de clés doit être mis à jour. Exemple d’identificateur de secret : https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Dans Catalogues, vérifiez que votre catalogue est visible. Si la connexion réussit, l’État est Connecté.

Référentiel GitHub de l’application DevCenter

Pour ajouter un catalogue, effectuez les tâches suivantes :

1. Installer et configurer l’application Microsoft DevCenter
2. Attribuez des autorisations dans GitHub pour les référentiels.
3. Ajouter votre dépôt en tant que catalogue

Installer l’application Microsoft DevCenter

1. Connectez-vous au portail Azure.

2. Accédez à votre projet ou centre de développement.

3. Dans le menu de gauche, sous Configuration de l’environnement, sélectionnez Catalogues, puis sélectionnez Ajouter.

4. Dans le volet Ajouter un catalogue , entrez ou sélectionnez les éléments suivants :

   Champ	Valeur
   Nom	Entrez un nom pour le catalogue.
   Source du catalogue	Sélectionnez GitHub.
   Type d’authentification	Sélectionnez Application GitHub.

5. Pour installer l’application Microsoft DevCenter, sélectionnez Configurer vos référentiels.

   

6. Si vous êtes invité à vous authentifier auprès de GitHub, faites-le.

7. Sur la page Microsoft DevCenter, sélectionnez Configurer.

   

8. Sélectionnez l’organisation GitHub qui contient le référentiel que vous souhaitez ajouter en tant que catalogue. Vous devez être propriétaire de l’organisation pour installer cette application.

   

9. Dans la page Installer Microsoft DevCenter, sélectionnez Référentiels sélectionnés uniquement, sélectionnez le référentiel que vous souhaitez ajouter en tant que catalogue, puis sélectionnez Installer.

   

   Vous pouvez sélectionner plusieurs référentiels à ajouter en tant que catalogues. Vous devez ajouter chaque référentiel en tant que catalogue distinct, comme décrit dans Ajouter votre référentiel en tant que catalogue.

10. Sur la page Microsoft DevCenter by Microsoft souhaite être autorisé à :, passez en revue les autorisations requises, puis sélectionnez Autoriser Microsoft DevCenter.

    

Ajouter votre dépôt en tant que catalogue

1. Revenez au portail Azure.

2. Dans Ajouter un catalogue, entrez les informations suivantes, puis sélectionnez Ajouter :

   Champ	Valeur
   Référentiel	Sélectionnez le référentiel que vous souhaitez ajouter en tant que catalogue.
   Branche	Sélectionnez la branche.
   Chemin d’accès du dossier	Sélectionnez le dossier qui contient les sous-dossiers qui conservent vos définitions d’environnement.

   

3. Dans Catalogues, vérifiez que votre catalogue est visible. Une fois la connexion établie, l’État affiche Synchronisation réussie.

   

Référentiel GitHub avec jeton PAT

Pour ajouter un catalogue, effectuez les tâches suivantes :

• Obtenez l’URL de clonage de votre référentiel GitHub.
• Créez un jeton PAT (jeton d’accès personnel) dans GitHub.
• Stockez le jeton PAT en tant que secret de coffre de clés dans Azure Key Vault.
• Ajouter votre dépôt en tant que catalogue

Obtenir l’URL de clonage de votre référentiel GitHub

1. Accédez à la page d’accueil du référentiel GitHub qui contient les définitions de modèle.

2. Obtenez l’URL de clonage du référentiel GitHub.

3. Copiez et enregistrez l’URL.

Créer un jeton d’accès personnel dans GitHub

Le service Environnements de déploiement Azure prend en charge l’authentification auprès des référentiels GitHub à l’aide de jetons classiques ou de jetons de granularité fine. Dans cet exemple, vous créez un jeton de granularité fine.

1. Accédez à la page d’accueil du référentiel GitHub qui contient les définitions de modèle.

2. Dans le coin supérieur droit de GitHub, Sélectionnez l’image de profil, puis sélectionnez Paramètres.

3. Dans la barre latérale gauche, sélectionnez Paramètres de développeur>Jetons d’accès personnels>Jetons affinés.

4. Sélectionnez Générer un nouveau jeton.

5. Dans la page Nouveau jeton d’accès personnel de granularité fine, indiquez les informations suivantes :

   Nom	Valeur
   Nom du jeton	Entrez un nom descriptif pour le jeton.
   Expiration	Sélectionnez la période d’expiration du jeton en jours.
   Description	Entrez une description pour le jeton.
   Propriétaire de la ressource	Sélectionnez le propriétaire du référentiel.
   Accès aux dépôts	Sélectionner Ne sélectionner que les référentiels.
   Sélectionner des référentiels	Sélectionnez le référentiel qui contient les définitions d’environnement.
   Autorisations du référentiel	Développez Autorisations du référentiel, puis pour Contenu, dans la liste Accès, sélectionnez Code (lire).

   

6. Sélectionnez Generate token.

7. Copiez et enregistrez le jeton généré pour l’utiliser plus tard.

Important

Quand vous utilisez un référentiel privé stocké dans une organisation GitHub, vous devez vérifier que le jeton PAT GitHub est configuré pour accorder l’accès à l’organisation appropriée et aux référentiels qu’elle contient.

• Les jetons classiques de l’organisation doivent faire l’objet d’une autorisation SSO pour l’organisation appropriée, une fois qu’ils ont été créés.
• Pour permettre aux jetons de granularité fine d’être autorisés, le propriétaire de ces jetons doit être défini comme étant l’organisation elle-même.

Les jetons PAT mal configurés peuvent entraîner une erreur de type référentiel introuvable.

Créer un coffre de clés

Vous avez besoin d’un coffre Azure Key Vault afin de stocker le jeton PAT utilisé pour octroyer à Azure l’accès à votre référentiel. Les coffres de clés peuvent contrôler l’accès à l’aide de stratégies d’accès ou du contrôle d’accès en fonction du rôle (RBAC). Si vous disposez d’un coffre de clés existant, vous pouvez l’utiliser, mais vous devez vérifier s’il utilise des stratégies d’accès ou des affectations RBAC pour contrôler l’accès. Si vous souhaitez obtenir de l’aide sur la configuration d’une stratégie d’accès pour un coffre de clés, consultez la rubrique Attribuer une stratégie d’accès au coffre de clés.

Suivez les étapes ci-dessous pour créer un coffre de clés RBAC :

1. Connectez-vous au portail Azure.

2. Dans la zone de recherche, entrez key vault.

3. Dans la liste des résultats, sélectionnez Key Vault.

4. Dans la page du coffre de clés, sélectionnez Créer.

5. Sous l’onglet Créer un coffre de clés, indiquez les informations suivantes :

   Nom	Valeur
   Nom	Entrez un nom pour le coffre de clés.
   Abonnement	Sélectionnez l’abonnement dans lequel vous souhaitez créer le coffre de clés.
   Groupe de ressources	Utilisez un groupe de ressources existant ou sélectionnez Créer un nouveau , puis entrez un nom pour le groupe de ressources.
   Lieu	Sélectionnez l’emplacement ou la région où vous souhaitez créer le coffre de clés.

   Conservez les valeurs par défaut des autres options.

6. Sous l’onglet Stratégie d’accès, sélectionnez Contrôle d’accès en fonction du rôle Azure, puis sélectionnez Vérifier + créer.

7. Sous l’onglet Review + create (Vérifier + créer) , sélectionnez Créer.

Si les stratégies de votre organisation vous obligent à maintenir votre Key Vault privé à partir d’Internet, vous pouvez définir votre Key Vault pour autoriser les services Microsoft approuvés à contourner votre règle de pare-feu.

Pour savoir comment autoriser les services Microsoft approuvés à contourner le pare-feu, consultez Configurer les paramètres de mise en réseau Azure Key Vault.

Stocker le jeton d’accès personnel dans le coffre de clés

1. Dans le coffre de clés, dans le menu de gauche, sélectionnez Secrets.

2. Dans la page Secrets, sélectionnez Générer/Importer.

3. Dans la page Créer un secret :

   • Dans le champ Nom, entrez un nom descriptif pour votre secret.
   • Dans la zone Valeur secrète, collez votre jeton PAT.
   • Sélectionnez Créer.

Obtenir l’identificateur de secret

Obtenez le chemin du secret que vous avez créé dans le coffre de clés.

1. Dans le portail Azure, accédez à votre coffre de clés.

2. Dans la page Coffre de clés, dans le menu de gauche, sélectionnez Secrets.

3. Dans la page Secrets, sélectionnez le secret que vous avez créé.

4. Sur la page des versions, sélectionnez VERSION ACTUELLE.

5. Dans la page de version actuelle, pour Identificateur de secret, sélectionnez Copier.

Ajouter votre dépôt en tant que catalogue

1. Sur le Portail Azure, accédez à votre projet ou centre de développement.

2. Vérifiez que l’identité managée attachée au projet ou centre de développement a accès au secret du coffre de clés où votre jeton d’accès personnel est stocké.

3. Dans le menu de gauche, sous Configuration de l’environnement, sélectionnez Catalogues, puis sélectionnez Ajouter.

4. Dans Ajouter un catalogue, entrez les informations suivantes, puis sélectionnez Ajouter.

   Champ	Valeur
   Nom	Entrez un nom pour le catalogue.
   Emplacement du catalogue	Sélectionnez GitHub.
   Référentiel	Entrez ou collez l’URL de clonage de votre référentiel GitHub ou Azure Repos. Exemple d’échantillon de catalogue : https://github.com/Azure/deployment-environments.git
   Branche	Entrez la branche de dépôt à laquelle vous souhaitez vous connecter. Exemple d’échantillon de catalogue : main
   Chemin d’accès du dossier	Saisissez le chemin du dossier relatif à l’URI de clone qui contient des sous-dossiers avec vos définitions d’environnement. Le chemin de dossier correspond au dossier dont les sous-dossiers contiennent des fichiers d’environnement de définition d’environnement, et non au dossier où se trouve le fichier d’environnement de définition d’environnement lui-même. L’image suivante montre la structure de dossier de l’exemple de catalogue. Exemple d’échantillon de catalogue : /Environments Le chemin du dossier peut commencer avec ou sans un slash (/).
   Identificateur de secret	Entrez l’identificateur de secret qui contient votre jeton PAT pour le référentiel. Lorsque vous copiez un identificateur de secret, la chaîne de connexion inclut un identificateur de version à la fin, par exemple : https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. La suppression de l’identificateur de version permet de garantir que le service Environnements de déploiement récupère la dernière version du secret dans le coffre de clés. Si votre PAT expire, seul le coffre de clés doit être mis à jour. Exemple d’identificateur de secret : https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Dans Catalogues, vérifiez que votre catalogue est visible. Une fois la connexion établie, l’État affiche Synchronisation réussie.

Afficher les éléments de catalogue synchronisés

Quel que soit le type de référentiel que vous utilisez, vous pouvez afficher les éléments de catalogue synchronisés à partir du catalogue.

1. Dans le menu de gauche de votre projet ou centre de développement, sous Configuration de l’environnement, sélectionnez Catalogues.

2. Dans le volet Catalogues, sélectionnez le nom du catalogue.

   

3. Vous voyez une liste d’éléments de catalogue synchronisés avec succès.

   

Mettre à jour un catalogue

Si vous mettez à jour la définition ou les contenus du modèle dans le référentiel attaché, vous pouvez fournir le dernier ensemble de définitions d’environnement à vos équipes de développement en synchronisant le catalogue. Vous pouvez synchroniser un catalogue manuellement ou automatiquement.

Synchroniser manuellement un catalogue

Lorsque vous synchronisez manuellement un catalogue, Environnements de déploiement analyse le référentiel, puis met à disposition de tous les projets associés dans le centre de développement la liste la plus récente des définitions d’environnement.

1. Dans le menu de gauche de votre centre de développement, sous Configuration de l’environnement, sélectionnez Catalogues.

2. Sélectionnez le catalogue spécifique, puis sélectionnez Synchroniser sur la barre de commandes.

   

Synchroniser automatiquement un catalogue

Lorsque vous configurez un catalogue pour la synchronisation automatique, Environnements de déploiement analyse le référentiel toutes les 30 minutes, puis met à disposition de tous les projets associés dans le centre de développement la liste la plus récente des définitions d’environnement.

1. Dans le menu de gauche de votre projet ou centre de développement, sous Configuration de l’environnement, sélectionnez Catalogues.

2. Sélectionnez le catalogue spécifique, puis sélectionnez modifier.

   

3. Dans le volet Modifier le catalogue, sélectionnez Synchroniser automatiquement ce catalogue, puis Enregistrer.

   

Si une synchronisation automatique échoue, vous devez effectuer une synchronisation manuelle. Les environnements de déploiement n’effectuent pas d’autres tentatives de synchronisation automatique tant qu’une synchronisation manuelle ne réussit pas.

Supprimer un catalogue

Vous pouvez supprimer un catalogue pour le retirer du projet ou centre de développement Environnements de déploiement Azure. Les modèles d’un catalogue supprimé ne sont pas disponibles aux équipes de développement lors du déploiement de nouveaux environnements. Mettez à jour la référence des définitions d’environnement de tous les environnements existants créés à l’aide des définitions d’environnement du catalogue supprimé. Si la référence n’est pas mise à jour et que l’environnement est redéployé, le déploiement échoue.

Pour supprimer un catalogue :

1. Dans le menu de gauche de votre projet ou centre de développement, sous Configuration de l’environnement, sélectionnez Catalogues.

2. Sélectionnez le catalogue en question, puis sélectionnez Supprimer.

3. Dans la boîte de dialogue Supprimer le catalogue, sélectionnez Continuer pour supprimer le catalogue.

Résoudre les erreurs de synchronisation des catalogues

Lorsque vous ajoutez ou synchronisez un catalogue, vous pouvez rencontrer un avertissement ou une erreur de synchronisation. Une erreur de synchronisation indique qu’un catalogue n’a pas réussi à se synchroniser. Un avertissement de synchronisation indique que certains ou tous les éléments du catalogue ont des erreurs. Vous pouvez afficher l’état de synchronisation et les erreurs sur le Portail Azure, ou utiliser Azure CLI et l’API REST pour dépanner et résoudre les erreurs.

Afficher l’état de synchronisation du catalogue

Sur le Portail Azure, vous pouvez obtenir plus d’informations sur l’état de synchronisation du catalogue et les avertissements ou erreurs en sélectionnant le lien d’état. Le lien d’état ouvre un volet qui affiche l’état de synchronisation, le nombre de définitions d’environnement ajoutées et le nombre de définitions d’environnement ignorées ou ayant échoué.

Afficher les défaillances de synchronisation du catalogue

1. Dans le menu de gauche de votre projet ou centre de développement, sous Configuration de l’environnement, sélectionnez Catalogues.

2. Dans la colonne État, sélectionnez le lien d’état du catalogue qui n’a pas pu être synchronisé.

   

3. Vous voyez un volet d’informations qui affiche les modifications apportées à la dernière synchronisation, le nombre d’erreurs de synchronisation et le type d’erreurs.

   

Afficher les avertissements de synchronisation du catalogue

1. Dans le menu de gauche de votre projet ou centre de développement, sous Configuration de l’environnement, sélectionnez Catalogues.

2. Dans la colonne État, sélectionnez le lien d’état du catalogue qui a pu être synchronisé, mais qui signale un avertissement.

   

3. Vous voyez un volet d’informations qui affiche les modifications apportées à la dernière synchronisation, le nombre d’erreurs d’éléments, ainsi que le type et la source de chaque erreur.

   

4. Vous pouvez afficher les éléments qui ont été synchronisés avec succès à partir d’un catalogue qui signale également des erreurs de synchronisation. Dans le volet Catalogues, sélectionnez le nom du catalogue.

   

5. Vous voyez une liste d’éléments de catalogue synchronisés avec succès.

   

Résoudre les erreurs de synchronisation de catalogue à l’aide d’Azure CLI

Utilisez Azure CLI ou l’API REST pour obtenir (GET) le catalogue. La réponse de GET vous montre le type d’erreur :

• Définitions d’environnement ignorées, qui ont été détectées en tant que doublons.
• Définitions d’environnement non valides ayant échoué en raison d’erreurs de schéma, de référence ou de validation.

Résoudre les erreurs de définitions d’environnement ignorées

Une erreur de définition d’environnement ignorée se produit si vous ajoutez au moins deux définitions d’environnement ayant le même nom. Vous pouvez résoudre ce problème en renommant les définitions d’environnement pour que chaque définition d’environnement ait un nom unique dans le catalogue.

Résoudre les erreurs de définition d’environnement non valides

Une erreur de définition d’environnement non valide peut se produire pour diverses raisons :

• Erreurs de schéma de manifeste. Vérifiez que votre fichier d’environnement de définition d’environnement correspond au schéma exigé.

• Erreurs de validation. Vérifiez les éléments suivants pour résoudre les erreurs de validation :

  • Vérifiez que le type de moteur du fichier d’environnement est configuré correctement.
  • Vérifiez que le nom de la définition d’environnement comprend entre 3 et 63 caractères.
  • Vérifiez que le nom de la définition d’environnement comprend uniquement des caractères valides pour une URL, à savoir des caractères alphanumériques et les symboles suivants : ~ ! , . ' ; : = - _ + ( ) * & $ @

• Erreurs de référence. Vérifiez que le chemin du modèle référencé par le fichier d’environnement est un chemin relatif valide pointant vers un fichier du référentiel.

Contenu connexe

• Configurer les types d’environnements d’un centre de développement
• Créer et configurer un projet à l’aide d’Azure CLI
• Configurer les types d’environnements d’un projet