Guide de démarrage rapide : Créer une dev box à l’aide de personnalisations d’équipe

Dans ce guide de démarrage rapide, vous créez une dev box à l’aide de personnalisations d’équipe Microsoft Dev Box. Cette fonctionnalité utilise un fichier de définition d’image pour vous permettre de créer des dev box personnalisées uniformes pour votre équipe de développement, et fournir ainsi un environnement personnalisé pour vos projets.

Prérequis

Créer une définition d’image

Pour créer une zone de développement avec des personnalisations, vous devez créer un fichier de définition d’image. Le fichier de définition d’image est un fichier YAML qui contient les personnalisations que vous souhaitez appliquer à la zone de développement. Vous pouvez utiliser l’exemple de fichier de définition d’image dans ce guide de démarrage rapide comme point de départ.

Activer les catalogues de niveau projet

Vous devez activer les catalogues de niveau projet au niveau du centre de développement avant de pouvoir ajouter un catalogue à un projet.

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

2. Dans le menu du service, sous Paramètres, sélectionnez Paramètres du Centre de développement.

3. Sous Catalogues au niveau du projet, sélectionnez Activer les catalogues par projet, puis sélectionnez Appliquer.

   

Ajouter un catalogue à votre projet

Les sections qui suivent vous guident dans ces tâches :

1. Dupliquez l’exemple de dépôt de catalogue dans votre organisation GitHub.
2. Configurez les paramètres de synchronisation pour synchroniser le catalogue avec votre projet.
3. Ajouter votre dépôt en tant que catalogue

Dupliquer l’exemple de dépôt de catalogue

1. Ouvrez l’exemple de dépôt de catalogue.

2. Sélectionnez ForkCreate a new fork> to fork to fork the repository to your GitHub organization.

   

Configurer les paramètres de synchronisation de catalogue

1. Revenez au portail Azure.

2. Dans la zone de recherche, entrez projets. Dans la liste des résultats, sélectionnez Projets.

3. Sélectionnez le projet auquel vous souhaitez ajouter le catalogue.

4. Dans le menu de gauche, sélectionnez Catalogues de paramètres>.

5. Sélectionnez Paramètres de synchronisation.

   

6. Dans le volet Paramètres de synchronisation :

   • Si les définitions d’image sont effacées, sélectionnez-la et sélectionnez Enregistrer.
   • Si les définitions d’image sont déjà sélectionnées, sélectionnez Annuler.

   

Ajouter votre dépôt en tant que catalogue

1. Dans la page Catalogues, sélectionnez Ajouter.

2. Dans le volet Ajouter un catalogue, entrez ou sélectionnez les valeurs suivantes :

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

3. Sélectionnez le lien Configurer vos référentiels.

   

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

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

   

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

   

7. Dans la page Installer Microsoft DevCenter , sélectionnez Sélectionner uniquement les référentiels, sélectionnez le référentiel que vous souhaitez ajouter en tant que catalogue, puis sélectionnez Enregistrer.

   

   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 la section suivante de ce guide de démarrage rapide.

8. Revenez au portail Azure.

9. Dans le volet Ajouter un catalogue , sélectionnez Se connecter avec GitHub.

10. Dans le volet Ajouter un catalogue, entrez les informations suivantes, puis sélectionnez Ajouter :

    Champ	Valeur
    Référentiel	Sélectionnez le référentiel qui contient votre définition d’image. Exemple : eShop
    Branche	Sélectionnez la branche. Exemple : main
    Chemin d’accès du dossier	Sélectionnez le dossier qui contient des sous-dossiers qui contiennent vos définitions d’image. Exemple : .devcenter/catalog/image-definitions

11. Dans le volet Catalogues , vérifiez que votre catalogue s’affiche. Une fois la connexion établie, la colonne État affiche Synchronisation réussie.

    

12. Vérifiez que les définitions d’image sont correctement synchronisées. Dans le menu de gauche, sélectionnez Gérer les>définitions d’image. Dans cet exemple, vous voyez deux définitions d’image :

    • backend-dev : cette image est une image Microsoft Visual Studio + Tools sur Windows 11, adaptée à l’environnement d’ingénierie back-end eShop.
    • frontend-dev : cette image est une image Microsoft Visual Studio + Tools sur Windows 11, adaptée à l’environnement d’ingénierie frontend eShop.

    

Créer un pool de dev box pour la définition d’image

Pour rendre accessible le fichier de personnalisation imagedefintion.yaml lors de la création de dev box, vous le spécifiez comme définition d’image pour un pool.

Pour créer un pool de box de développement associé à un projet :

1. Dans le portail Azure.

2. Dans la zone de recherche, entrez projets. Dans la liste des résultats, sélectionnez Projets.

3. Ouvrez le projet dans lequel vous souhaitez créer le pool de dev box.

4. Dans le menu de gauche, sélectionnez Gérer les>pools de zone de développement

5. Dans la page Pools de zone de développement , sélectionnez Créer.

6. Sur le volet Créer un pool de dev box, entrez les valeurs suivantes :

   Paramètre	Valeur
   Nom	Entrez un nom descriptif pour le pool. Le nom du pool est visible pour les développeurs à sélectionner lorsqu’ils créent des zones de développement. Par conséquent, incluez l’objectif et la région du pool. Le nom doit être unique dans le projet. Exemple : contoso-frontend-westUS
   Définition	Dans la section définition d’image de la liste, sélectionnez une définition d’image. Exemple : contoso-catalog/frontend-dev
   Calculer	Sélectionnez les ressources de calcul pour les zones de développement du pool. Exemple : 8 processeurs virtuels, 32 Go de RAM
   Stockage	Sélectionnez les options de stockage des zones de développement dans le pool. Exemple : SSD de 256 Go
   Hibernation	La mise en veille prolongée est prise en charge lorsque l’image source et la taille de calcul sont toutes deux compatibles avec la mise en veille prolongée.
   Connexion réseau	1. Sélectionnez Déployer sur un réseauhébergé par Microsoft. 2. Sélectionnez une région de déploiement pour les zones de développement. Choisissez une région proche de vos utilisateurs de dev box pour une expérience utilisateur optimale. Exemple : USA Ouest
   Licences	Cochez cette case pour confirmer que votre organisation dispose de licences Azure Hybrid Benefit que vous voulez appliquer aux dev Box de ce pool.

   

7. Sélectionnez Create (Créer).

8. Vérifiez que le nouveau pool de dev box s’affiche dans la liste. Il se peut que vous deviez rafraîchir l’écran.

Le portail Azure déploie le pool de dev box et effectue des contrôles d’intégrité pour s’assurer que l’image et le réseau répondent aux critères de validation des dev box.

Créer une dev box à partir du pool de dev box

Lorsque vous créez une dev box à partir d’un pool de dev box, la définition d’image est appliquée à la dev box. La dev box est créée avec les personnalisations spécifiées dans le fichier de définition d’image.

Pour créer une dev box dans le portail des développeurs Microsoft Dev Box :

1. Connectez-vous au portail des développeurs Microsoft Dev Box.

2. Sélectionnez Nouvelle>Nouvelle dev box.

3. Dans Ajouter une dev box, saisissez les valeurs suivantes :

   Paramètre	Valeur
   Nom	Entrez un nom pour votre dev box. Les noms de zone de développement doivent être uniques au sein d’un projet. Exemple : contoso-frontend-dev-box
   Projet	Le portail des développeurs répertorie les projets auquel vous avez accès. Sélectionnez le projet dont vous avez besoin dans la liste.
   Pool de dev box	Le portail des développeurs répertorie tous les pools de boîtes de développement pour le projet que vous avez sélectionné. Sélectionnez le pool approprié pour votre travail. Choisissez un pool de dev box près de vous pour une latence minimale.
   Appliquer des personnalisations	Laissez cette case à cocher désactivée. Il est utilisé pour appliquer des personnalisations utilisateur. Dans cet article, vous avez configuré des personnalisations d’équipe.

   Une fois vos sélections effectuées, la page affiche les informations suivantes :

   • Indique si la mise en veille prolongée est prise en charge ou non.
   • Une notification indiquant que le processus de création de dev box peut prendre 25 minutes ou plus.

4. Sélectionnez Créer pour commencer à créer votre zone de développement.

5. Pour suivre la progression de la création, utilisez la vignette de la dev box dans le portail des développeurs.

Vérifier que les personnalisations sont appliquées

Dev Box applique les personnalisations dans la dernière étape du processus de création. Dev Box vous envoie un e-mail lorsque la dev box est prête. Vous pouvez ensuite vérifier que vos personnalisations sont appliquées.

1. Attendez que la zone de développement soit créée.

2. Sur le portail des développeurs, dans la vignette de la dev box, sélectionnez Actions>Personnalisations.

   

3. Sur le volet Détails des personnalisations, confirmez les personnalisations qui ont été appliquées à la dev box.

   

Nettoyer les ressources

1. Connectez-vous au portail des développeurs.

2. Pour la dev box que vous souhaitez supprimer, dans le menu Actions, sélectionnez Supprimer.

   

3. Sélectionnez Supprimer pour confirmer la suppression.

   

Contenu connexe

• Personnalisations de Microsoft Dev Box
• Écrire un fichier de personnalisation pour une dev box