Configurer les paramètres personnalisés de l'utilisateur pour les boîtes de développement

Vous pouvez personnaliser votre Microsoft Dev Box en chargeant un fichier de personnalisation utilisateur. Les fichiers de personnalisation utilisateur vous permettent de configurer votre zone de développement avec vos paramètres personnels et applications préférés, ce qui vous permet de commencer à coder plus rapidement. Cet article explique comment créer, tester et charger un fichier de personnalisation utilisateur à partir de votre lecteur ou référentiel local à l’aide de Visual Studio (VS) Code. Vous allez également apprendre à valider votre fichier et à gérer les paramètres de personnalisation des projets.

Utilisez des personnalisations dans Microsoft Dev Box de deux façons : les personnalisations d’équipe créent une configuration partagée pour une équipe et les personnalisations utilisateur créent une configuration personnelle pour un développeur individuel. Le tableau suivant présente les différences entre les deux types de personnalisations.

Les personnalisations des utilisateurs permettent de s’assurer que les développeurs se conforment aux garde-fous de l’entreprise ; seules les tâches personnalisées préapprouvées via un catalogue sont disponibles pour les développeurs à utiliser dans leurs fichiers de personnalisation. Les utilisateurs de la zone de développement standard ne peuvent pas exécuter de tâches PowerShell et WinGet intégrées dans un contexte système, ce qui empêche l’escalade des privilèges.

Les personnalisations utilisateur peuvent être activées ou désactivées au niveau du projet. Lorsque vous créez un projet, les personnalisations utilisateur sont activées par défaut.

Conditions préalables

Pour accomplir les étapes décrites dans cet article :

• Configurez un centre de développement avec une définition de zone de développement, un pool de box de développement et un projet de zone de développement afin de pouvoir créer une zone de développement.
• Rejoignez le groupe de sécurité Dev Box Users pour au moins un projet.
• Joignez un catalogue au centre de développement avec les tâches que vous utilisez dans votre fichier de personnalisation. Si vous n’avez pas de catalogue, consultez Ajouter et configurer un catalogue à partir de GitHub ou d’Azure Repos.

Autorisations requises pour configurer des personnalisations

Pour créer et appliquer des personnalisations à une zone de développement, vous avez besoin des autorisations suivantes :

Créer un fichier de personnalisation utilisateur

Créez et gérez des fichiers de personnalisation dans VS Code. Utilisez l’extension Microsoft Dev Box dans VS Code pour découvrir les tâches dans le catalogue attaché et tester le fichier de personnalisation.

1. Créez une zone de développement pour les tests ou utilisez une zone de développement existante.

2. Dans la zone de développement de test, installez VS Code, puis installez l’extension Dev Box.

3. Téléchargez un exemple de fichier de personnalisation YAML à partir du référentiel d’exemples, puis ouvrez-le dans VS Code.

4. Découvrez les tâches disponibles dans le catalogue à l’aide de la palette de commandes. Sélectionnez Affichage>Palette de commandes>Boîte de développement : lister les tâches disponibles pour cette boîte de développement.

   

5. Testez la personnalisation dans VS Code à l’aide de la palette de commandes. Sélectionnez Afficher>Palette de Commandes>Dev Box : Appliquer les Tâches de Personnalisation.

   

6. Le fichier de personnalisation s’exécute et applique les tâches spécifiées à votre zone de développement de test. Inspectez les modifications et vérifiez le terminal VS Code pour connaître les erreurs ou avertissements lors de l’exécution de la tâche.

7. Une fois le fichier de personnalisation exécuté avec succès, chargez-le dans votre catalogue.

Facultatif : Personnaliser votre zone de développement à l’aide de fichiers de configuration WinGet existants

La configuration WinGet utilise une approche config-as-code pour définir les ensembles uniques de logiciels et de paramètres de configuration nécessaires pour préparer votre environnement Windows au code. Vous pouvez également utiliser ces fichiers de configuration pour configurer une zone de développement à l’aide d’une tâche WinGet incluse dans le catalogue de démarrage rapide fourni par Microsoft.

Cet exemple montre un fichier de personnalisation de zone de développement qui utilise un fichier DSC (Desired State Configuration) WinGet existant.

tasks:
    - name: winget
      parameters:
          configure: "projectConfiguration.dsc.yaml"

Pour plus d’informations, consultez la configuration WinGet.

Créer une zone de développement à l’aide d’un fichier de personnalisation utilisateur

Utilisez un fichier de personnalisation individuel en le chargeant à partir d’un lecteur local lorsque vous créez votre zone de développement ou en le téléchargeant à partir d’un référentiel. Les fichiers de personnalisation stockés dans un référentiel doivent être nommés workload.yaml. Les fichiers de personnalisation stockés localement pour le chargement doivent être nommés myfilename.yaml.

Charger un fichier

1. Dans le portail des développeurs, sélectionnez Nouvelle>zone de développement.

2. Dans le volet Ajouter une zone de développement , ajoutez des détails pour votre zone de développement.

3. Sélectionnez Appliquer des personnalisations, puis sélectionnez Continuer.

   

4. Sélectionnez Charger un ou plusieurs fichiers de personnalisation, sélectionnez Ajouter des personnalisations à partir d’un fichier, puis accédez à votre fichier myfilename.yaml .

   

5. Pour vérifier que les tâches de votre fichier de personnalisations sont appliquées correctement, validez-les avant de continuer. Sélectionnez Valider.

   

6. Passez en revue le résumé de création de la zone de développement, puis sélectionnez Créer.

   

Obtenir un fichier à partir d’un référentiel

1. Dans le portail des développeurs, sélectionnez Nouvelle>zone de développement.

2. Dans le volet Ajouter une zone de développement, ajoutez des détails pour votre zone de développement.

3. Sélectionnez Appliquer des personnalisations, puis sélectionnez Continuer.

   

4. Sélectionnez Charger un ou plusieurs fichiers de personnalisation, sélectionnez Choisir un fichier de personnalisation à partir d’un référentiel, puis entrez l’URL du référentiel qui stocke votre fichier workload.yaml .

   

5. Pour vérifier que les tâches de votre fichier de personnalisations sont appliquées correctement, validez-les avant de continuer. Sélectionnez Valider.

   

6. Passez en revue le résumé de création de la zone de développement, puis sélectionnez Créer.

   

Désactiver les personnalisations des utilisateurs

Les personnalisations utilisateur sont contrôlées au niveau du projet et sont activées par défaut. Vous pouvez les désactiver pendant ou après la création du projet. En cas de désactivation, les développeurs ne peuvent pas appliquer leurs propres fichiers de personnalisation aux nouvelles zones de développement. L’activation des personnalisations utilisateur ne contourne pas les garde-fous de projet existants ; Les développeurs peuvent uniquement utiliser des tâches fournies dans le catalogue attaché et ne peuvent pas exécuter de tâches avec des privilèges élevés, sauf si un administrateur a explicitement inclus une tâche d’administration dans le catalogue.

Désactiver les personnalisations des utilisateurs via le portail Azure

1. Connectez-vous au portail Azure.

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

3. Dans la page Projets , sélectionnez le projet dans lequel vous souhaitez désactiver les personnalisations utilisateur.

4. Accédez aux paramètres>Dev box.

   

5. Pour désactiver les personnalisations utilisateur, décochez la case Activer , puis sélectionnez Appliquer.

Expérience des développeurs dans le portail des développeurs

Lorsque vous désactivez les personnalisations utilisateur pour un projet, les développeurs peuvent toujours charger un fichier de personnalisation utilisateur lors de la création de la zone de développement, mais le processus de validation échoue et les personnalisations ne sont pas appliquées à la zone de développement.

Si vous créez une zone de développement avec des personnalisations utilisateur dans un projet où les personnalisations utilisateur sont désactivées, vous voyez ce qui suit dans le portail des développeurs :

1. Un message sur la nouvelle vignette de boîte de développement affiche des erreurs lors de l'application de personnalisations.

   

2. Les détails indiquent de contacter votre administrateur.

   

3. La zone de développement n’inclut pas de personnalisations utilisateur.

Contenu connexe

• Personnalisations de Microsoft Dev Box
• Configurer l’imagerie du centre de développement
• Ajouter et configurer un catalogue à partir de GitHub ou d’Azure Repos