The Wayback Machine - https://web.archive.org/web/20221228223032/https://docs.github.com/fr/codespaces/developing-in-codespaces/using-source-control-in-your-codespace
Skip to main content

Utilisation du contrôle de code source dans votre espace de code

Après avoir apporté des modifications à un fichier dans votre espace de code, vous pouvez commiter rapidement les modifications et pousser (push) votre mise à jour vers le dépôt distant.

Remarque : L’utilisation de GitHub Codespaces avec des IDE JetBrains est actuellement en version bêta publique et peut faire l’objet de modification.

À propos du contrôle de code source dans GitHub Codespaces

Vous pouvez effectuer toutes les actions Git dont vous avez besoin directement dans votre espace de code. Par exemple, vous pouvez extraire des modifications à partir d’un dépôt distant, échanger des branches, créer une branche, commiter et pousser des modifications, et créer une demande de tirage. Vous pouvez utiliser le terminal intégré dans votre espace de code pour entrer des commandes Git, ou vous pouvez cliquer sur des icônes et des options de menu pour effectuer toutes les tâches Git les plus courantes. Ce guide explique comment utiliser l’interface utilisateur graphique pour le contrôle de code source.

Pour plus d’informations sur la prise en charge de Git dans Visual Studio Code, consultez « Utilisation de la gestion de versions dans VS Code » dans la documentation de Visual Studio Code.

Le contrôle de code source dans le client web Visual Studio Code utilise le même workflow que l’application de bureau Visual Studio Code. Pour plus d’informations, consultez « Utilisation de la gestion de versions dans VS Code » dans la documentation de Visual Studio Code.

Un workflow classique pour la mise à jour d’un fichier à l’aide de GitHub Codespaces serait :

  • À partir de la branche par défaut de votre dépôt sur GitHub, créez un espace de code. Consultez « Création d’un codespace pour un dépôt ».
  • Dans votre espace de code, créez une nouvelle branche sur laquelle travailler.
  • Apportez vos modifications, puis enregistrez-les.
  • Validez la modification.
  • Créez une demande de tirage (pull request).

Publication d’un codespace créé à partir d’un modèle

Lorsque vous créez un codespace à partir d’un dépôt de modèles ou d’un modèle de la page « Vos codespaces », le travail que vous effectuez n’est pas stocké dans un dépôt sur GitHub tant que vous n’avez pas publié votre codespace. Pour plus d’informations, consultez « Création d’un codespace à partir d’un modèle ».

Si vous travaillez dans un codespace, vous pouvez le publier à partir de l’application de bureau ou du client web VS Code.

  1. Dans la barre d’activité, cliquez sur la vue Contrôle de code source. Vue Contrôle de code source

  2. Pour indexer vos changements, cliquez sur + à côté du fichier que vous avez ajouté ou changé, ou à côté de Changements si vous avez changé plusieurs fichiers et que vous voulez les indexer tous.

    Barre latérale de contrôle de code source avec bouton de préproduction mis en exergue

    Remarque : Si vous commencez à partir du modèle vide de GitHub, vous ne verrez pas de liste de changements, sauf si vous avez déjà initialisé votre répertoire en tant que dépôt Git. Pour publier des codespaces créés à partir du modèle vide, cliquez sur Publier sur GitHub dans la vue Contrôle de code source, puis passez à l’étape 5.

  3. Pour commiter vos changements indexés, tapez un message de commit décrivant la modification que vous avez apportée, puis cliquez sur Commiter.

    Barre latérale du contrôle de code source avec un message de validation (commit)

  4. Cliquez sur Publier la branche.

    Capture d’écran du bouton « Publier la branche » dans VS Code

  5. Dans la liste déroulante « Nom du dépôt », tapez un nom pour votre nouveau dépôt, puis sélectionnez Publier sur le dépôt privé GitHub ou Publier sur le dépôt public GitHub .

    Capture d’écran de la liste déroulante « Nom du dépôt » dans VS Code

    Le propriétaire du nouveau dépôt est le compte GitHub avec lequel vous avez créé le codespace.

  6. Dans la fenêtre contextuelle qui s’affiche dans le coin inférieur droit de l’éditeur, cliquez éventuellement sur Ouvrir dans GitHub pour afficher le nouveau dépôt sur GitHub.com.

    Capture d’écran de la fenêtre contextuelle « Ouvrir dans GitHub » dans VS Code

Création ou changement de branches

  1. Si la branche actuelle n’est pas affichée dans la barre d’état, au bas de votre codespace, cliquez avec le bouton droit sur la barre d’état, puis sélectionnez Contrôle de code source.
  2. Cliquez sur le nom de la branche dans la barre d’état. Branche dans la barre d’état
  3. Dans la liste déroulante, cliquez sur la branche sur laquelle vous souhaitez basculer, ou entrez le nom d’une nouvelle branche, puis cliquez sur Créer une branche. Effectuer un choix à partir du menu Branche

Conseil : Si quelqu’un a récemment changé un fichier sur le dépôt distant, dans la branche vers laquelle vous avez basculé, il est possible que vous ne voyiez pas ces modifications tant que vous n’avez pas tiré les modifications dans votre codespace.

Validation (commit) de vos modifications

  1. Dans la barre d’activité, cliquez sur la vue Contrôle de code source. Vue Contrôle de code source
  2. Pour indexer vos modifications, cliquez sur + à côté du fichier que vous avez modifié, ou à côté des Modifications si vous avez modifié plusieurs fichiers et que vous souhaitez les indexer. Barre latérale de contrôle de code source avec le bouton de préproduction mis en évidence
  3. Tapez un message de validation (commit) décrivant la modification que vous avez apportée. Barre latérale du contrôle de code source avec un message de commit
  4. Pour commiter les changements indexés, cliquez sur la coche en haut de la barre latérale du contrôle de code source. Cliquez sur l’icône en forme de coche

Tirage de modifications à partir du dépôt distant

Vous pouvez tirer des modifications à partir du dépôt distant dans votre espace de code à tout moment.

  1. Dans la barre d’activité, cliquez sur la vue Contrôle de code source. Vue Contrôle de code source
  2. En haut de la barre latérale, cliquez sur les points de suspension ( ). Bouton Points de suspension pour Afficher et Autres actions
  3. Dans le menu déroulant, cliquez sur Tirer.

Si la configuration du conteneur de développement a été modifiée depuis que vous avez créé l’espace de code, vous pouvez appliquer les modifications en recréant le conteneur pour l’espace de code. Pour plus d’informations, consultez « Présentation des conteneurs de développement ».

Définition de votre espace de code pour extraire automatiquement les nouvelles modifications

Vous pouvez définir votre espace de code pour extraire automatiquement les détails des nouveaux commits qui ont été effectués dans le dépôt distant. Cela vous permet de voir si votre copie locale du dépôt est obsolète, auquel cas vous pouvez choisir d’extraire les nouvelles modifications.

Si l’opération d’extraction détecte de nouvelles modifications sur le dépôt distant, vous voyez le nombre de nouveaux commits dans la barre d’état. Vous pouvez ensuite tirer les modifications dans votre copie locale.

  1. Cliquez sur le bouton Gérer en bas de la barre d’activité. Bouton Gérer
  2. Dans le menu, cliquez sur Paramètres.
  3. Dans la page Paramètres, recherchez : autofetch. Rechercher l’auto-extraction
  4. Pour extraire les détails des mises à jour pour tous les dépôts distants inscrits pour le dépôt actuel, définissez Git : Auto-extraction sur all. Activer l’auto-extraction Git
  5. Si vous souhaitez modifier le nombre de secondes entre deux extractions automatiques, modifiez la valeur de Git : Période d’auto-extraction.

Création d’une demande de tirage

  1. Une fois que vous avez validé les changements apportés à votre copie locale du dépôt, cliquez sur l’icône Créer une demande de tirage. Barre latérale de contrôle de code source avec le bouton de préproduction mis en évidence
  2. Vérifiez que la branche locale, le dépôt à partir duquel vous effectuez la fusion, ainsi que la branche distante et le dépôt distant vers lesquels vous effectuez la fusion sont corrects. Donnez ensuite un titre et une description à la demande de tirage. Barre latérale de contrôle de code source avec le bouton de préproduction mis en évidence
  3. Cliquez sur Créer.

Poussée (push) de modifications vers votre dépôt distant

Vous pouvez pousser les modifications que vous avez enregistrées et commitées. Cette opération applique ces modifications à la branche en amont sur le référentiel distant. Vous souhaitez peut-être effectuer cette opération si vous n’êtes pas encore prêt à créer une demande de tirage (pull request) ou si vous préférez créer une demande de tirage (pull request) sur GitHub.

  1. En haut de la barre latérale, cliquez sur les points de suspension ( ). Bouton Points de suspension pour Afficher et Autres actions
  2. Dans le menu déroulant, cliquez sur Pousser.

Publication d’un codespace créé à partir d’un modèle

Lorsque vous créez un codespace à partir d’un dépôt de modèles ou d’un modèle de la page « Vos codespaces », le travail que vous effectuez n’est pas stocké dans un dépôt sur GitHub tant que vous n’avez pas publié votre codespace. Pour plus d’informations, consultez « Création d’un codespace à partir d’un modèle ».

Si vous travaillez dans un codespace, vous pouvez le publier à partir de l’application de bureau ou du client web VS Code.

  1. Dans la barre d’activité, cliquez sur la vue Contrôle de code source. Vue Contrôle de code source

  2. Pour indexer vos changements, cliquez sur + à côté du fichier que vous avez ajouté ou changé, ou à côté de Changements si vous avez changé plusieurs fichiers et que vous voulez les indexer tous.

    Barre latérale de contrôle de code source avec bouton de préproduction mis en exergue

    Remarque : Si vous commencez à partir du modèle vide de GitHub, vous ne verrez pas de liste de changements, sauf si vous avez déjà initialisé votre répertoire en tant que dépôt Git. Pour publier des codespaces créés à partir du modèle vide, cliquez sur Publier sur GitHub dans la vue Contrôle de code source, puis passez à l’étape 5.

  3. Pour commiter vos changements indexés, tapez un message de commit décrivant la modification que vous avez apportée, puis cliquez sur Commiter.

    Barre latérale du contrôle de code source avec un message de validation (commit)

  4. Cliquez sur Publier la branche.

    Capture d’écran du bouton « Publier la branche » dans VS Code

  5. Dans la liste déroulante « Nom du dépôt », tapez un nom pour votre nouveau dépôt, puis sélectionnez Publier sur le dépôt privé GitHub ou Publier sur le dépôt public GitHub .

    Capture d’écran de la liste déroulante « Nom du dépôt » dans VS Code

    Le propriétaire du nouveau dépôt est le compte GitHub avec lequel vous avez créé le codespace.

  6. Dans la fenêtre contextuelle qui s’affiche dans le coin inférieur droit de l’éditeur, cliquez éventuellement sur Ouvrir dans GitHub pour afficher le nouveau dépôt sur GitHub.com.

    Capture d’écran de la fenêtre contextuelle « Ouvrir dans GitHub » dans VS Code

Création ou changement de branches

  1. Si la branche actuelle n’est pas affichée dans la barre d’état, au bas de votre codespace, cliquez avec le bouton droit sur la barre d’état, puis sélectionnez Contrôle de code source.
  2. Cliquez sur le nom de la branche dans la barre d’état. Branche dans la barre d’état
  3. Dans la liste déroulante, cliquez sur la branche sur laquelle vous souhaitez basculer, ou entrez le nom d’une nouvelle branche, puis cliquez sur Créer une branche. Effectuer un choix à partir du menu Branche

Conseil : Si quelqu’un a récemment changé un fichier sur le dépôt distant, dans la branche vers laquelle vous avez basculé, il est possible que vous ne voyiez pas ces modifications tant que vous n’avez pas tiré les modifications dans votre codespace.

Validation (commit) de vos modifications

  1. Dans la barre d’activité, cliquez sur la vue Contrôle de code source. Vue Contrôle de code source
  2. Pour indexer vos modifications, cliquez sur + à côté du fichier que vous avez modifié, ou à côté des Modifications si vous avez modifié plusieurs fichiers et que vous souhaitez les indexer. Barre latérale de contrôle de code source avec le bouton de préproduction mis en évidence
  3. Tapez un message de validation (commit) décrivant la modification que vous avez apportée. Barre latérale du contrôle de code source avec un message de commit
  4. Pour commiter les changements indexés, cliquez sur la coche en haut de la barre latérale du contrôle de code source. Cliquez sur l’icône en forme de coche

Tirage de modifications à partir du dépôt distant

Vous pouvez tirer des modifications à partir du dépôt distant dans votre espace de code à tout moment.

  1. Dans la barre d’activité, cliquez sur la vue Contrôle de code source. Vue Contrôle de code source
  2. En haut de la barre latérale, cliquez sur les points de suspension ( ). Bouton Points de suspension pour Afficher et Autres actions
  3. Dans le menu déroulant, cliquez sur Tirer.

Si la configuration du conteneur de développement a été modifiée depuis que vous avez créé l’espace de code, vous pouvez appliquer les modifications en recréant le conteneur pour l’espace de code. Pour plus d’informations, consultez « Présentation des conteneurs de développement ».

Définition de votre espace de code pour extraire automatiquement les nouvelles modifications

Vous pouvez définir votre espace de code pour extraire automatiquement les détails des nouveaux commits qui ont été effectués dans le dépôt distant. Cela vous permet de voir si votre copie locale du dépôt est obsolète, auquel cas vous pouvez choisir d’extraire les nouvelles modifications.

Si l’opération d’extraction détecte de nouvelles modifications sur le dépôt distant, vous voyez le nombre de nouveaux commits dans la barre d’état. Vous pouvez ensuite tirer les modifications dans votre copie locale.

  1. Cliquez sur le bouton Gérer en bas de la barre d’activité. Bouton Gérer
  2. Dans le menu, cliquez sur Paramètres.
  3. Dans la page Paramètres, recherchez : autofetch. Rechercher l’auto-extraction
  4. Pour extraire les détails des mises à jour pour tous les dépôts distants inscrits pour le dépôt actuel, définissez Git : Auto-extraction sur all. Activer l’auto-extraction Git
  5. Si vous souhaitez modifier le nombre de secondes entre deux extractions automatiques, modifiez la valeur de Git : Période d’auto-extraction.

Création d’une demande de tirage

  1. Une fois que vous avez validé les changements apportés à votre copie locale du dépôt, cliquez sur l’icône Créer une demande de tirage. Barre latérale de contrôle de code source avec le bouton de préproduction mis en évidence
  2. Vérifiez que la branche locale, le dépôt à partir duquel vous effectuez la fusion, ainsi que la branche distante et le dépôt distant vers lesquels vous effectuez la fusion sont corrects. Donnez ensuite un titre et une description à la demande de tirage. Barre latérale de contrôle de code source avec le bouton de préproduction mis en évidence
  3. Cliquez sur Créer.

Poussée (push) de modifications vers votre dépôt distant

Vous pouvez pousser les modifications que vous avez enregistrées et commitées. Cette opération applique ces modifications à la branche en amont sur le référentiel distant. Vous souhaitez peut-être effectuer cette opération si vous n’êtes pas encore prêt à créer une demande de tirage (pull request) ou si vous préférez créer une demande de tirage (pull request) sur GitHub.

  1. En haut de la barre latérale, cliquez sur les points de suspension ( ). Bouton Points de suspension pour Afficher et Autres actions
  2. Dans le menu déroulant, cliquez sur Pousser.

Création ou changement de branches

  1. Cliquez sur le nom de la branche à droite de la barre d’état.

    Capture d’écran du nom de la branche dans la barre d’état

  2. Dans le menu contextuel, effectuez l’une des opérations suivantes :

    • Pour créer une branche basée sur la branche actuelle, cliquez sur le nom de la branche actuelle, puis choisissez New Branch (Nouvelle branche).

      Capture d’écran de l’option New Branch

      Entrez un nom pour la nouvelle branche, puis cliquez sur Create (Créer).

      Capture d’écran de la boîte de dialogue de création de branche

    • Pour extraire une branche existante, commencez à taper son nom. Cliquez sur la branche dans la liste, puis cliquez sur Checkout (Extraire).

      Capture d’écran de l’option Checkout

      Conseil : Si quelqu’un a récemment changé un fichier sur le dépôt distant, dans la branche vers laquelle vous avez basculé, il est possible que vous ne voyiez pas ces modifications tant que vous n’avez pas tiré les modifications dans votre codespace.

Validation (commit) de vos modifications

  1. Sur le côté droit de la barre de navigation, cliquez sur la coche.

    Capture d’écran de la coche de commit

  2. Dans la boîte de dialogue Commit Changes (Commiter les modifications), entrez un message de commit.

  3. Cliquez sur Valider.

    Vous pouvez également cliquer sur la flèche vers le bas en regard de Commit, puis sur Commit and Push (Commiter et pousser).

    Capture d’écran du bouton Commit and Push

Tirage de modifications à partir du dépôt distant

Vous pouvez extraire les modifications de la même branche sur le dépôt distant et appliquer ces modifications à la copie du dépôt sur lequel vous travaillez dans votre codespace.

  1. Sur le côté droit de la barre de navigation, cliquez sur la flèche pointant vers le bas.

    Capture d’écran du bouton flèche vers le bas de mise à jour du projet

  2. Dans la boîte de dialogue Update Project (Mettre à jour le projet), indiquez si vous souhaitez fusionner ou rebaser les modifications entrantes.

    Capture d’écran de la boîte de dialogue Update Project

  3. Cliquez sur OK.

Poussée (push) de modifications vers votre dépôt distant

Vous pouvez pousser les modifications que vous avez enregistrées et commitées. Cette opération applique ces modifications à la branche en amont sur le référentiel distant. Vous souhaitez peut-être effectuer cette opération si vous n’êtes pas encore prêt à créer une demande de tirage (pull request) ou si vous préférez créer une demande de tirage (pull request) sur GitHub.

  1. Sur le côté droit de la barre de navigation, cliquez sur la flèche pointant vers le haut.

    Capture d’écran de la flèche vers le haut de poussée des commits

  2. Dans la boîte de dialogue Pousser les commits, cliquez sur Push (Pousser).