Ajout de fonctionnalités à un fichier devcontainer.json

Avec des fonctionnalités, vous pouvez rapidement ajouter des outils, des runtimes ou des bibliothèques à votre configuration de conteneur de développement.

Les composants sont des unités autonomes de code d’installation et de configuration de conteneur de développement, conçus pour fonctionner sur un large éventail d’images conteneur de base. Vous pouvez utiliser des composants pour ajouter rapidement des outils, des runtimes ou des bibliothèques à votre image codespace. Pour plus d’informations, consultez les composants disponibles et la spécification des composants sur le site web Development Containers.

Vous pouvez ajouter des composants à un fichier devcontainer.json à partir de VS Code ou de votre dépôt sur GitHub. Utilisez les onglets de cet article afin d’afficher des instructions pour chaque méthode d’ajout de fonctionnalités.

Ajout de fonctionnalités à un fichier devcontainer.json

  1. Accédez à votre référentiel sur GitHub, recherchez votre fichier devcontainer.json et cliquez sur pour modifier le fichier.

    Si vous n’avez pas encore de fichier devcontainer.json, vous pouvez en créer un maintenant. Pour plus d’informations, consultez « Présentation des conteneurs de développement ».

  2. À droite de l’éditeur de fichier, sous l’onglet Place de marché, parcourez les fonctionnalités ou recherchez celle que vous souhaitez ajouter, puis cliquez sur son nom.

    Capture d’écran de l’onglet Place de marché avec « Terra » dans la zone de recherche et la fonctionnalité Terraform listée dans les résultats de la recherche.

  3. Sous « Installation », cliquez sur l’extrait de code pour le copier dans le Presse-papiers, puis collez l’extrait dans l’objet features de votre fichier devcontainer.json.

    Capture d’écran de l’onglet Place de marché montrant l’extrait de code d’installation pour Terraform.

    "features": {
     // ...
     "ghcr.io/devcontainers/features/terraform:1": {},
     // ...
 }

  4. Par défaut, la dernière version de la fonctionnalité est utilisée. Pour choisir une autre version ou configurer d’autres options pour la fonctionnalité, développez les propriétés listées sous « Options » pour afficher les valeurs disponibles, puis ajoutez les options en modifiant manuellement l’objet dans votre fichier devcontainer.json.

    Capture d’écran de la section « Options » de l’onglet Place de marché, avec les propriétés « version » et « tflint » développées.

    "features": {
     // ...
     "ghcr.io/devcontainers/features/terraform:1": {
         "version": "1.1",
         "tflint": "latest"
     },
     // ...
 }

  5. Commitez les modifications dans votre fichier devcontainer.json.

Les modifications de configuration prendront effet dans les nouveaux codespaces créés à partir du dépôt. Pour que les modifications prennent effet dans les codespaces existants, vous devez tirer (pull) les mises à jour du fichier devcontainer.json dans votre codespace, puis regénérer le conteneur pour le codespace. Pour plus d’informations, consultez « Présentation des conteneurs de développement ».

Note

Pour ajouter des fonctionnalités dans VS Code lorsque vous travaillez localement et que vous n’êtes pas connecté à un codespace, l’extension « Conteneurs de développement » doit être installée et activée. Pour plus d’informations sur cette extension, consultez la VS Code Marketplace.

  1. Accédez à VS Code Command Palette en appuyant sur Maj+Commande+P (Mac) ou Ctrl+Maj+P (Windows/Linux).

  2. Commencez à taper « ajouter » et cliquez sur Codespaces : ajouter des fichiers config de conteneur de développement.

    Capture d’écran de la palette de commandes, avec « ajouter » entré et « Codespaces : ajouter des fichiers config de conteneur de développement » listé.

  3. Cliquez sur Modifier votre configuration active.

  4. Mettez à jour vos sélections de fonctionnalités, puis cliquez sur OK.

  5. Si vous travaillez dans un codespace, une invite apparaît dans le coin inférieur droit. Pour regénérer le conteneur et appliquer les modifications au codespace dans lequel vous travaillez, cliquez sur Regénérer maintenant.

    Capture d’écran du message : « Nous avons remarqué un changement dans la configuration du conteneur de développement ». En dessous se trouve le bouton « Regénérer maintenant ».