Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

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.

Vous pouvez personnaliser GitHub Codespaces en utilisant un dépôt dotfiles sur GitHub Enterprise Cloud 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.

    L’option « Installer automatiquement les dotfiles »

  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.

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

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

Par défaut, lorsque vous désactivez la synchronisation des paramètres, les nouveaux codespaces continuent d’utiliser les paramètres mis en cache la dernière fois que vos paramètres ont été poussés vers le cloud. Si vos codespaces continuent d’être créés avec les paramètres mis en cache, mais que vous souhaitez réutiliser à la place les paramètres VS Code par défaut dans vos codespaces, vous pouvez effacer le cache dans le cloud quand 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, 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 de l’option de désactivation de la synchronisation des paramètres dans VS Code

  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 de désactivation de la synchronisation des paramètres

  5. Cliquez sur Désactiver.