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.

Utilisation de GitHub Codespaces dans Visual Studio Code

Vous pouvez développer dans votre espace de code directement dans Visual Studio Code en connectant l’extension GitHub Codespaces avec votre compte sur GitHub Enterprise Cloud.

À propos de GitHub Codespaces dans Visual Studio Code

Vous pouvez utiliser votre installation locale de Visual Studio Code pour créer, gérer, utiliser et supprimer des codespaces. Pour utiliser GitHub Codespaces dans VS Code, vous devez installer l’extension Codespaces. Pour plus d’informations sur la configuration de GitHub Codespaces dans VS Code, consultez « Prérequis ».

Par défaut, si vous créez un codespace sur GitHub.com, il s’ouvre dans le navigateur. Si vous préférez que les nouveaux codespaces s’ouvrent automatiquement dans VS Code, vous pouvez définir VS Code comme éditeur par défaut. Pour plus d’informations, consultez « Définition de votre éditeur par défaut pour GitHub Codespaces ».

Si vous préférez travailler dans le navigateur, mais que vous souhaitez continuer à utiliser vos extensions, thèmes et raccourcis VS Code existants, vous pouvez activer la fonctionnalité Synchronisation des paramètres. Pour plus d’informations, consultez « Personnalisation de GitHub Codespaces pour votre compte ».

Prérequis

Pour développer à partir d’un codespace directement dans VS Code, vous devez installer et vous connecter à l’extension GitHub Codespaces avec vos informations d’identification GitHub Enterprise Cloud. L’extension GitHub Codespaces requiert la version 1.51 d’octobre 2020 de VS Code (ou version ultérieure).

Utilisez Visual Studio Code Marketplace pour installer l’extension GitHub Codespaces. Pour plus d’informations, consultez Place de marché des extensions dans la documentation VS Code.

  1. Dans VS Code, dans la barre latérale gauche, cliquez sur l’icône de l’Explorateur distant.

    Icône de l’Explorateur distant dans Visual Studio Code

    Remarque : Si l’Explorateur distant n’est pas affiché dans la barre d’activité :

    1. Accédez à la palette de commandes. Par exemple, en appuyant sur Maj+Commande+P (Mac)/Ctrl+Maj+P (Windows/Linux).
    2. Entrez : codespaces.
    3. Cliquez sur Codespaces : Détails.
  2. Cliquez sur Se connecter à GitHub... .

    Connexion à GitHub Codespaces

  3. Pour autoriser VS Code à accéder à votre compte sur GitHub Enterprise Cloud, cliquez sur Autoriser.

  4. Connectez-vous à GitHub Enterprise Cloud pour approuver l’extension.

  1. Dans VS Code, dans la barre latérale gauche, cliquez sur l’icône de l’Explorateur distant.

    Icône de l’Explorateur distant dans Visual Studio Code

    Remarque : Si l’Explorateur distant n’est pas affiché dans la barre d’activité :

    1. Accédez à la palette de commandes. Par exemple, en appuyant sur Maj+Commande+P (Mac)/Ctrl+Maj+P (Windows/Linux).
    2. Entrez : codespaces.
    3. Cliquez sur Codespaces : Détails.
  2. Utilisez le menu déroulant « EXPLORATEUR DISTANT », puis cliquez sur GitHub Codespaces .

    L’en-tête GitHub Codespaces

  3. Cliquez sur Se connecter pour afficher Codespaces .

    Connexion pour afficher GitHub Codespaces

  4. Pour autoriser VS Code à accéder à votre compte sur GitHub Enterprise Cloud, cliquez sur Autoriser.

  5. Connectez-vous à GitHub Enterprise Cloud pour approuver l’extension.

Création d’un codespace dans VS Code

Après avoir connecté votre compte sur GitHub.com à l’extension GitHub Codespaces, vous pouvez créer un codespace. Pour plus d’informations sur l’extension GitHub Codespaces, consultez la VS Code Marketplace.

  1. Dans VS Code, dans la barre latérale gauche, cliquez sur l’icône de l’Explorateur distant.

    Icône de l’Explorateur distant dans Visual Studio Code

    Remarque : Si l’Explorateur distant n’est pas affiché dans la barre d’activité :

    1. Accédez à la palette de commandes. Par exemple, en appuyant sur Maj+Commande+P (Mac)/Ctrl+Maj+P (Windows/Linux).
    2. Entrez : codespaces.
    3. Cliquez sur Codespaces : Détails.
  2. Cliquez sur l’icône Ajouter : .

    Option Créer un codespace dans GitHub Codespaces

  3. Entrez le nom du référentiel dans lequel vous souhaitez développer, puis sélectionnez-le.

    Recherche de dépôt pour créer un codespace

    Si le dépôt que vous choisissez appartient à une organisation et que l’organisation a configuré des codespaces pour que ce dépôt soit facturable à l’organisation, ou à son entreprise parente, un message s’affiche dans les invites successives vous indiquant qui paie le codespace.

  4. Cliquez sur la branche sur laquelle vous souhaitez développer.

    Recherche d’une branche pour créer un codespace

  5. Si vous êtes invité à choisir un fichier de configuration de conteneur de développement, choisissez un fichier dans la liste.

    Choix d’un fichier de configuration de conteneur de développement pour GitHub Codespaces

  6. Choisissez le type de machine que vous souhaitez utiliser.

    Types d’instance pour un nouveau codespace

    Remarque : Votre choix de types d’ordinateurs disponibles peut être limité par un certain nombre de facteurs. Il peut s’agir par exemple d’une stratégie configurée pour votre organisation, ou une spécification de type d’ordinateur minimal pour votre dépôt. Pour plus d’informations, consultez « Restriction de l’accès aux types de machine » et « Définition d’une spécification minimale pour les machines de codespaces ».

Ouverture d’un codespace dans VS Code

  1. Dans VS Code, dans la barre latérale gauche, cliquez sur l’icône de l’Explorateur distant.

    Icône de l’Explorateur distant dans Visual Studio Code

    Remarque : Si l’Explorateur distant n’est pas affiché dans la barre d’activité :

    1. Accédez à la palette de commandes. Par exemple, en appuyant sur Maj+Commande+P (Mac)/Ctrl+Maj+P (Windows/Linux).
    2. Entrez : codespaces.
    3. Cliquez sur Codespaces : Détails.
  2. Sous « Codespaces », cliquez sur le codespace dans lequel vous souhaitez développer.

  3. Cliquez sur l’icône de connexion au codespace.

    Icône de connexion au codespace dans VS Code

Modification du type de machine dans VS Code

En règle générale, vous pouvez exécuter votre codespace sur une sélection de types d’ordinateurs distants. Ces types d’ordinateur offrent un choix de spécifications matérielles allant de 2 cœurs à 32 cœurs, même si la gamme complète de types d’ordinateur n’est pas toujours disponible. Chaque type d’ordinateur correspond à un niveau de ressources différent et à un niveau de facturation différent. Pour plus d’informations, consultez « À propos de la facturation de GitHub Codespaces ».

Par défaut, le type de machine doté des ressources valides les plus faibles est utilisé quand vous créez un codespace. Vous pouvez à tout moment modifier le type de machine de votre codespace.

Remarque : Votre choix de types d’ordinateurs disponibles peut être limité par un certain nombre de facteurs. Il peut s’agir par exemple d’une stratégie configurée pour votre organisation, ou une spécification de type d’ordinateur minimal pour votre dépôt. Pour plus d’informations, consultez « Restriction de l’accès aux types de machine » et « Définition d’une spécification minimale pour les machines de codespaces ».

  1. Dans VS Code, ouvrez la palette de commandes avec Commande+Maj+P (Mac) ou Ctrl+Maj+P (Windows/Linux).

  2. Recherchez et sélectionnez « Codespaces : Modifier le type de machine ».

    Recherche d’une branche pour créer un nouveau Codespaces

  3. Si vous ne suivez pas ces instructions dans un codespace, cliquez sur le codespace à changer.

    Recherche d’une branche pour créer un Codespaces

    Si vous suivez ces instructions dans un codespace, le changement s’applique au codespace dans lequel vous travaillez.

  4. Sélectionnez le type de machine à utiliser.

  5. Si vous passez à un type de machine ayant une autre capacité de stockage, une invite s’affiche pour vous demander si vous souhaitez continuer. Lisez l’invite, puis cliquez sur Oui pour accepter.

Si vous êtes passé à une machine virtuelle ayant une autre capacité de stockage (par exemple d’une machine de 64 Go à une machine de 32 Go), votre codespace ne sera pas disponible pendant une courte période, le temps que le type de machine soit changé. Si le codespace est actif, il est automatiquement arrêté. Une fois le changement effectué, vous pourrez redémarrer le codespace qui s’exécute sur le nouveau type de machine.

Si vous êtes passé à une machine virtuelle ayant la même capacité de stockage, le changement sera appliqué au prochain redémarrage du codespace. Un codespace actif n’est pas arrêté automatiquement. Pour plus d’informations sur le redémarrage d’un codespace, consultez « Arrêt et démarrage d’un codespace ».

Suppression d’un codespace dans VS Code

Vous pouvez supprimer des codespaces depuis VS Code à condition de ne pas travailler dans un codespace.

  1. Dans VS Code, dans la barre latérale gauche, cliquez sur l’icône de l’Explorateur distant.

    Icône de l’Explorateur distant dans Visual Studio Code

    Remarque : Si l’Explorateur distant n’est pas affiché dans la barre d’activité :

    1. Accédez à la palette de commandes. Par exemple, en appuyant sur Maj+Commande+P (Mac)/Ctrl+Maj+P (Windows/Linux).
    2. Entrez : codespaces.
    3. Cliquez sur Codespaces : Détails.
  2. Sous « CODESPACES GITHUB », cliquez avec le bouton droit sur le codespace que vous souhaitez supprimer.

  3. Cliquez sur Supprimer le codespace.

    Suppression d’un codespace dans GitHub

Passage à la build Insiders de VS Code

Vous pouvez utiliser la build Insiders de VS Code dans GitHub Codespaces.

  1. En bas à gauche de la fenêtre GitHub Codespaces, sélectionnez Paramètres.

  2. Dans la liste, sélectionnez « Passer à la version Insiders ».

    Cliquer sur « Build Insiders » dans GitHub Codespaces

  3. Une fois cette option sélectionnée, GitHub Codespaces continuera à s’ouvrir dans la version Insiders.

Pour aller plus loin