Créer des tâches pour les personnalisations d’équipe Dev Box
Lorsque vous créez des tâches pour les personnalisations de l’équipe Microsoft Dev Box, vous pouvez définir des actions spécifiques pour vos zones de développement afin de garantir un environnement de développement cohérent et efficace. La création de tâches dans un catalogue vous permet de définir des composants réutilisables adaptés à vos équipes de développement et d’ajouter des garde-fous autour des configurations possibles. Cet article vous guide tout au long de la création d’un catalogue pour les tâches de personnalisation, l’ajout de tâches et l’attachement du catalogue à un centre de développement ou à un projet.
Important
La fonctionnalité de personnalisations d’équipe Dev Box est actuellement en préversion. Pour plus d’informations sur l’état de préversion, consultez Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure. Le document définit les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou qui ne sont pas encore en disponibilité générale.
Prérequis
Pour accomplir les étapes décrites dans cet article, vous devez les éléments suivants :
- Un centre de développement configuré avec un projet dev box.
- Un catalogue existant dans GitHub ou Azure Repos.
Autorisations requises pour configurer les personnalisations
Pour effectuer les actions requises pour créer et appliquer des personnalisations à une dev box, vous avez besoin des autorisations suivantes :
| Action | Autorisation/rôle |
|---|---|
| Activez des catalogues de niveau projet pour un centre de développement. | Ingénieur de plateforme disposant d’un accès en écriture sur l’abonnement. |
| Activez les paramètres de synchronisation de catalogue pour un projet. | Ingénieur de plateforme disposant d’un accès en écriture sur l’abonnement. |
| Attachez un catalogue à un projet. | Autorisations Administrateur de projet ou Contributeur sur le projet. |
| Créez un fichier de personnalisation. | Aucune spécification. Tout le monde peut créer un fichier de personnalisation. |
| Utilisez le portail des développeurs pour charger et appliquer un fichier YAML lors de la création d’une dev box. | Utilisateur Dev Box. |
| Ajoutez des tâches à un catalogue. | Autorisation d’ajouter au référentiel qui héberge le catalogue. |
Que sont les tâches ?
Une tâche effectue une action spécifique, comme l’installation de logiciels. Chaque tâche se compose d’un ou plusieurs scripts PowerShell, ainsi que d’un fichier task.yaml qui fournit des paramètres et définit le mode d’exécution des scripts. Vous pouvez également inclure une commande PowerShell dans le fichier task.yaml.
Vous pouvez stocker une collection de tâches organisées dans un catalogue qui est attaché à votre centre de développement, avec chaque tâche dans un dossier séparé. Dev Box prend en charge l’utilisation d’un référentiel GitHub ou d’un référentiel Azure Repos en tant que catalogue. Dev Box analyse un dossier spécifié du catalogue de manière récursive pour rechercher les définitions de tâches.
WinGet et PowerShell sont disponibles à partir de n’importe quel centre de développement sans avoir besoin d’un catalogue. Si vos personnalisations utilisent uniquement WinGet ou PowerShell, vous pouvez créer des tâches qui les utilisent dans un fichier de personnalisation. Si vous devez utiliser d’autres outils ou scripts, vous pouvez créer des tâches dans un catalogue.
Microsoft fournit un catalogue de démarrage rapide pour vous aider à commencer à utiliser les personnalisations. Il contient un ensemble de tâches par défaut qui définissent des actions courantes :
- Installez des logiciels à l’aide du gestionnaire de package WinGet.
- Déploiement de la configuration DSC (Desired State Configuration) à l’aide de la configuration WinGet.
- Clonez un référentiel à l’aide de
git-clone. - Configurer des applications telles que l’installation d’extensions Visual Studio.
- Exécuter des scripts PowerShell.
Créer des tâches dans un catalogue
Les tâches, telles que l’installation de logiciels ou l’exécution de scripts, sont organisées dans un catalogue. Vous créez et gérez des tâches dans un catalogue, définissez de nouvelles tâches et attachez votre catalogue à un centre de développement. Avec le catalogue de démarrage rapide de Microsoft, vous pouvez commencer à utiliser des tâches courantes telles que l’installation de logiciel, le déploiement de DSC, le clonage de référentiels et la configuration d’applications.
Définir de nouvelles tâches
Pour créer et gérer des tâches pour les personnalisations d’équipe Dev Box, procédez comme suit :
Créez un référentiel pour stocker vos tâches. Si vous le souhaitez, vous pouvez faire une copie du catalogue de démarrage rapide dans votre propre référentiel à utiliser comme point de départ.
Créez des tâches dans votre référentiel en modifiant des scripts PowerShell existants ou en créant de nouveaux scripts. Pour commencer à créer des tâches, vous pouvez utiliser les exemples dans le référentiel GitHub pour obtenir des exemples de centre de développement et dans la documentation PowerShell.
Attachez votre référentiel à votre centre de développement en tant que catalogue.
Créez un fichier de configuration pour ces tâches en suivant les étapes décrites dans Écrire un fichier de personnalisation.
Utiliser des secrets à partir d’un coffre de clés Azure key vault
Vous pouvez utiliser des secrets à partir de votre coffre de clés Azure key vault dans vos configurations YAML pour cloner des dépôts privés ou avec toute tâche personnalisée que vous créez qui nécessite un jeton d’accès.
Votre centre de développement a besoin d’accéder à votre coffre de clés. DevCenter ne prend pas en charge les étiquettes de service : si votre coffre de clés est privé, vous devez donc autoriser les services Microsoft approuvés à contourner le pare-feu.
Pour configurer vos secrets key vault à utiliser dans vos configurations YAML :
Assurez-vous que l’identité managée de votre projet de centre de développement a le rôle Lecteur Key Vault et le rôle Utilisateur des secrets Key Vault sur votre Key Vault.
Accordez le rôle Utilisateur de secrets Key Vault pour le secret de coffre de clés à chaque utilisateur ou groupe d’utilisateurs qui doit pouvoir utiliser le secret lors de la personnalisation d’une dev box. L’utilisateur ou le groupe auquel le rôle est accordé doit inclure l’identité managée du centre de développement, votre propre compte d’utilisateur et tout utilisateur ou groupe qui a besoin du secret pendant la personnalisation d’une dev box.
Pour plus d’informations sur l’utilisation des secrets de coffre de clés dans un fichier de personnalisation, consultez Cloner un dépôt privé en utilisant un fichier de personnalisation.
Attacher un catalogue
Vous pouvez attacher un catalogue à un projet pour rendre les tâches accessibles à l’équipe de développeurs. Pour attacher un catalogue à un projet, suivez les étapes décrites dans Ajouter et configurer un catalogue à partir de GitHub ou d’Azure Repos.