Résolution des problèmes liés aux options de personnalisation pour GitHub Codespaces

Étapes de résolution des problèmes courants liés aux dotfiles et à la synchronisation des paramètres.

Dans cet article

Vous pouvez personnaliser GitHub Codespaces en utilisant un dépôt dotfiles sur GitHub ou en utilisant la fonctionnalité Synchronisation des paramètres. Pour plus d’informations, consultez « Personnalisation de GitHub Codespaces pour votre compte ».

Résolution des problèmes liés aux dotfiles

Si votre codespace ne parvient pas à récupérer des paramètres de configuration à partir de fichiers dotfile, vous devriez suivre les étapes de résolution des problèmes suivantes.

  1. Activez les dotfiles en sélectionnant Installer automatiquement les dotfiles dans vos paramètres GitHub Codespaces personnels.

    Capture d’écran de la section « Dotfiles » des paramètres de codespace, avec l’option « Installer automatiquement des dotfiles » désactivée.

  2. Vérifiez dans /workspaces/.codespaces/.persistedshare/dotfiles si vos fichiers dotfile ont été clonés.

    • Si vos fichiers dotfile ont été clonés, essayez de réexécuter manuellement votre script d’installation pour vérifier qu’il est exécutable.
    • Si vos fichiers dotfile n’ont pas été clonés, vérifiez dans /workspaces/.codespaces/.persistedshare/EnvironmentLog.txt si le clonage a rencontré un problème.

  3. Vérifiez dans /workspaces/.codespaces/.persistedshare/creation.log des problèmes possibles. Pour plus d’informations, consultez Journaux de création.

Si la configuration est correctement récupérée à partir de vos fichiers dotfile, mais qu’une partie de la configuration n’est pas compatible avec les codespaces, utilisez la variable d’environnement $CODESPACES afin d’ajouter une logique conditionnelle pour les paramètres de configuration spécifiques de codespace. Pour plus d’informations sur une configuration qui pourrait être incompatible avec les codespaces, consultez :

Résolution des problèmes de synchronisation des paramètres

Vous pouvez désactiver la synchronisation des paramètres pour l’arrêter vers et depuis une instance de VS Code.

Lorsque vous désactivez la synchronisation des paramètres dans un codespaces, les nouveaux codespaces continuent d’utiliser les paramètres mis en cache la dernière fois que vos paramètres ont été envoyés vers le cloud. Si vous utilisez le client web VS Code pour des codespaces et que vous souhaitez qu’ils utilisent les paramètres par défaut au lieu de vos paramètres mis en cache, vous pouvez désactiver la synchronisation des paramètres. Pour plus d’informations, consultez Gestion de vos préférences pour la synchronisation des paramètres.

Si vous souhaitez revenir à l’utilisation des paramètres VS Code par défaut dans toutes les instances de VS Code, y compris l’application de bureau, vous pouvez effacer le cache dans le cloud lorsque vous désactivez la synchronisation des paramètres.

  1. Si la synchronisation des paramètres est actuellement désactivée dans votre instance de VS Code, et que vous souhaitez effacer vos paramètres mis en cache, vous devez d’abord l’activer. Pour les instructions, consultez Personnalisation de GitHub Codespaces pour votre compte.

  2. En bas de la barre d’activité, sélectionnez et cliquez sur La synchronisation des paramètres est activée.

  3. Dans la liste déroulante, cliquez sur Synchronisation des paramètres : Désactiver.

    Capture d’écran du menu déroulant avec l’option « Synchronisation des paramètres : Désactiver » mise en évidence avec un encadré orange foncé.

  4. Pour effacer les paramètres mis en cache, dans la boîte de dialogue, sélectionnez Désactiver la synchronisation sur tous les appareils et effacer les données dans le cloud.

    Capture d’écran de la boîte de dialogue « Voulez-vous désactiver la synchronisation ? » avec l’option permettant d’effacer les données du cloud sélectionnée.

  5. Cliquez sur Désactiver.