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.

Démarrage rapide pour GitHub Codespaces

Essayez GitHub Codespaces en 5 minutes.

Introduction

Dans ce guide, vous allez créer un codespace à partir d’un modèle de référentiel et explorer certaines des fonctionnalités essentielles disponibles dans le codespace. Vous allez travailler dans la version navigateur de Visual Studio Code, qui est initialement l’éditeur par défaut pour GitHub Codespaces. Après avoir essayé ce guide de démarrage rapide, vous pouvez utiliser Codespaces dans d’autres éditeurs et vous pouvez changer l’éditeur par défaut. Des liens sont fournis à la fin de ce guide.

À partir de ce guide de démarrage rapide, vous allez découvrir comment créer un codespace, vous connecter à un port transféré pour voir votre application s’exécuter, publier votre codespace dans un nouveau dépôt et personnaliser votre configuration avec des extensions.

Pour plus d’informations sur le fonctionnement exact de GitHub Codespaces, consultez le guide complémentaire « Présentation approfondie de GitHub Codespaces ».

Création de votre codespace

  1. Accédez au dépôt de modèles github/haikus-for-codespaces.

  2. Cliquez sur Utiliser ce modèle, puis sur Ouvrir dans un codespace.

    Capture d’écran du bouton « Utiliser ce modèle » et du menu déroulant

Exécution de l'application

Une fois le codespace créé, le dépôt de modèles est automatiquement cloné dans celui-ci. Vous pouvez maintenant exécuter l’application et la lancer dans un navigateur.

  1. Lorsque le terminal devient disponible, entrez la commande npm run dev. Cet exemple utilise un projet Node.js et cette commande exécute le script intitulé « dev » dans le fichier package.json, qui démarre l’application web définie dans l’exemple de dépôt.

    npm run dev dans le terminal

    S’il s’agit d’un autre type d’application, entrez la commande de démarrage correspondante pour ce projet.

  2. Quand votre application démarre, le codespace reconnaît le port sur lequel l’application s’exécute et affiche une invite pour vous informer du transfert.

    Notification « toast » de transfert de port

  3. Cliquez sur Ouvrir dans le navigateur pour afficher votre application en cours d’exécution dans un nouvel onglet.

Modifier l’application et afficher les modifications

  1. Revenez à votre codespace et ouvrez le fichier haikus.json en cliquant dessus dans l’Explorateur.

  2. Modifiez le champ text du premier haiku pour personnaliser l’application avec votre propre haiku.

  3. Revenez à l’onglet de l’application en cours d’exécution dans votre navigateur et actualisez pour afficher vos modifications.

    Si vous avez fermé l’onglet, ouvrez le panneau Ports et cliquez sur l’icône Ouvrir dans le navigateur pour le port en cours d’exécution.

    Panneau de transfert de port

Validation (commit) et envoi (push) de vos modifications

Maintenant que vous avez apporté quelques modifications, vous pouvez utiliser le terminal intégré ou la vue source pour publier votre travail dans un nouveau dépôt.

  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 haikus.json. Vous pouvez également cliquer à côté de Changements si vous avez changé plusieurs fichiers, et si vous souhaitez les indexer.

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

  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 sur Ouvrir sur GitHub pour afficher le nouveau dépôt sur GitHub.com. Dans le nouveau dépôt, affichez le fichier haikus.json et vérifiez que la modification que vous avez apportée dans votre codespace a bien été poussée dans le dépôt.

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

Personnalisation avec une extension

Quand vous vous connectez à un codespace avec le navigateur ou l’application de bureau Visual Studio Code, vous pouvez accéder à la Place de marché Visual Studio Code directement à partir de l’éditeur. Pour cet exemple, vous allez installer une extension VS Code qui modifie le thème, mais vous pouvez installer toute extension utile pour votre workflow.

  1. Dans la barre latérale gauche, cliquez sur l’icône Extensions.

  2. Dans la barre de recherche, tapez fairyfloss et cliquez sur Installer.

    Ajouter une extension

  3. Sélectionnez le thème fairyfloss en le sélectionnant dans la liste.

    Sélectionner le thème fairyfloss

À propos de la synchronisation des paramètres

Vous pouvez activer la synchronisation des paramètres pour synchroniser les extensions et autres paramètres sur les appareils et les instances de VS Code. Lorsque vous activez la synchronisation des paramètres dans une instance de VS Code, comme l’application de bureau VS Code sur votre ordinateur portable, les paramètres pour cette instance sont stockés dans le cloud. À partir du cloud, les paramètres sont tirés (pull) vers tous les nouveaux codespaces au point de création, et sont synchronisés en continu avec tous les codespaces existants où la synchronisation des paramètres est activée.

La synchronisation des paramètres peut être activée par défaut dans un codespace. Cela dépend de vos paramètres existants, et si vous avez ouvert le codespace dans le navigateur ou dans l’application de bureau VS Code. Pour plus d’informations, consultez « Personnalisation de GitHub Codespaces pour votre compte ».

Étapes suivantes

Vous avez créé, personnalisé et exécuté avec succès votre première application dans un codespace. Il vous reste encore beaucoup de choses à découvrir. Voici quelques ressources utiles pour effectuer vos étapes suivantes avec GitHub Codespaces.

Pour aller plus loin