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.
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 suivre les étapes décrites dans ce guide de démarrage rapide, vous devez avoir un centre de développement configuré avec un projet de dev box.
Autorisations requises pour configurer des 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 |
|---|---|
| Activer les catalogues de niveau projet pour un centre de développement. | Ingénieur de plateforme disposant d’un accès en écriture sur l’abonnement. |
| Activer les paramètres de synchronisation de catalogue pour un projet. | Ingénieur de plateforme disposant d’un accès en écriture sur l’abonnement. |
| Attacher un catalogue à un projet. | Autorisations Administrateur de projet ou Contributeur sur le projet. |
| Créer un fichier de personnalisation. | Aucune spécification. Tout le monde peut créer un fichier de personnalisation. |
| Utiliser le portail des développeurs pour charger et appliquer un fichier YAML pendant la création d’une dev box. | Utilisateur Dev Box. |
| Ajouter des tâches à un catalogue. | Autorisation d’ajouter au référentiel qui héberge le catalogue. |
Créer une définition d’image
- Téléchargez l’exemple de fichier de personnalisation YAML.
- Ouvrez le fichier et examinez les tâches.
Le fichier de définition d’image spécifie un nom pour la définition d’image à l’aide d’un champ name. Utilisez ce nom pour identifier la définition d’image dans le pool de dev box.
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.
Dans le portail Azure, accédez à votre centre de développement.
Dans le menu du service, sous Paramètres, sélectionnez Configuration.
Dans le volet Catalogues au niveau du projet, sélectionnez Activer les catalogues par projet, puis Appliquer.
Ajouter un catalogue à votre projet
Les sections qui suivent vous guident dans ces tâches :
- Dupliquez l’exemple de dépôt de catalogue dans votre organisation GitHub.
- Installez et configurez l’application Centre de développement Microsoft.
- Attribuez des autorisations dans GitHub pour les référentiels.
- Ajouter votre dépôt en tant que catalogue
Dupliquer l’exemple de dépôt de catalogue
- Ouvrez l’exemple de dépôt de catalogue.
- Sélectionnez Dupliquer pour dupliquer le dépôt dans votre organisation GitHub.
Installer l’application Centre de développement Microsoft
Connectez-vous au portail Azure.
Accédez à votre projet ou centre de développement.
Dans le menu de service, sous Configuration de l’environnement, sélectionnez Catalogues, puis Ajouter.
Dans le volet Ajouter un catalogue, entrez ou sélectionnez les valeurs suivantes :
Champ Valeur Nom Entrez un nom pour le catalogue. Source du catalogue Sélectionnez GitHub. Type d’authentification Sélectionnez Application GitHub. Sélectionnez le lien Configurer vos référentiels.
Si vous êtes invité à vous authentifier auprès de GitHub, faites-le.
Sur la page Microsoft DevCenter, sélectionnez Configurer.
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.
Sur la page Installer Microsoft DevCenter, sélectionnez Référentiels sélectionnés uniquement, puis sélectionnez le référentiel que vous souhaitez ajouter en tant que catalogue, puis 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 la section suivante de ce guide de démarrage rapide.
Sur la page Microsoft DevCenter par 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
Revenez au portail Azure.
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 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. 
Dans le volet Catalogues, vérifiez que votre catalogue s’affiche. Une fois la connexion établie, la colonne État affiche Synchronisation réussie.
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 dev box associé à un projet :
Connectez-vous au portail Azure.
Dans la zone de recherche, entrez projets. Dans la liste des résultats, sélectionnez Projets.
Ouvrez le projet dans lequel vous souhaitez créer le pool de dev box.
Sélectionnez Pools de dev box, puis sélectionnez Créer.
Sur le volet Créer un pool de dev box, entrez les valeurs suivantes :
Paramètre Valeur Nom Attribuez un nom à votre pool. Le nom du pool est visible pour les développeurs, qui peuvent le sélectionner lorsqu’ils créent des dev box. Le nom doit être unique dans le projet. Definition Sélectionnez la définition, comme indiqué dans votre fichier de définition d’image. Connexion réseau 1. Sélectionnez Déployer sur un réseau hébergé par Microsoft.
2. Sélectionnez la région de déploiement souhaitée pour les dev box. Choisissez une région proche de vos utilisateurs de dev box pour une expérience utilisateur optimale.Privilèges de créateur de dev box Sélectionnez Administrateur local ou Utilisateur standard. Activer l’arrêt automatique La valeur par défaut est Oui. Sélectionnez Non pour désactiver une planification de l’arrêt automatique. Vous pouvez configurer une planification de l’arrêt automatique une fois que le pool a été créé. Heure d’arrêt Sélectionnez une heure pour arrêter toutes les dev box dans le pool. Toutes les dev box de ce pool s’arrêtent à cette heure, tous les jours. Fuseau horaire Sélectionnez le fuseau horaire pour l’heure d’arrêt. Gestion des 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. 
Sélectionnez Créer.
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 :
Connectez-vous au portail des développeurs Microsoft Dev Box.
Sélectionnez Nouvelle>Nouvelle dev box.
Dans Ajouter une dev box, saisissez les valeurs suivantes :
Paramètre Valeur Nom Entrez un nom pour votre dev box. Les noms de dev box doivent être uniques dans le projet. Projet Sélectionnez un projet dans la liste déroulante. Pool de dev box Sélectionnez un pool dans la liste déroulante, qui inclut tous les pools de dev box pour ce projet. Choisissez un pool de dev box près de vous pour une latence minimale. Une fois vos sélections effectuées, la page affiche les informations suivantes :
- Nombre de dev boxes que vous pouvez créer dans le projet que vous avez sélectionné, si le projet a des limites configurées.
- Prise en charge ou non de la mise en veille prolongée.
- Indique si les personnalisations sont activées ou non.
- Une heure d’arrêt si le pool dans lequel vous créez la dev box dispose d’une planification d’arrêt.
- Une notification indiquant que le processus de création de dev box peut prendre 25 minutes ou plus.
Sélectionnez Créer pour commencer à créer votre dev box.
Pour suivre la progression de la création, utilisez la vignette de la dev box dans le portail des développeurs.
Vérifier que la personnalisation est appliquée
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.
Attendez la confirmation par e-mail que la dev box est créée.
Sur le portail des développeurs, dans la vignette de la dev box, sélectionnez Actions>Personnalisations.
Sur le volet Détails des personnalisations, confirmez les personnalisations qui ont été appliquées à la dev box.
Nettoyer les ressources
Connectez-vous au portail des développeurs.
Pour la dev box que vous souhaitez supprimer, dans le menu Actions, sélectionnez Supprimer.
Sélectionnez Supprimer pour confirmer la suppression.
