Skip to main content

Vue d’ensemble de GitHub Codespaces

Ce guide présente GitHub Codespaces, et fournit des détails sur son fonctionnement ainsi que sur son utilisation.

Qu’est-ce qu’un codespace ?

Un codespace est un environnement de développement hébergé dans le cloud. Vous pouvez personnaliser votre projet pour GitHub Codespaces en commitant des fichiers de configuration dans votre dépôt (souvent appelé configuration sous forme de code), ce qui crée une configuration de codespace reproductible pour tous les utilisateurs de votre projet.

Chaque codespace que vous créez est hébergé par GitHub dans un conteneur Docker, exécuté sur une machine virtuelle. Vous pouvez choisir parmi une sélection de types de machines virtuelles, qui vont de 2 cœurs, 8 Go de RAM et 32 Go de stockage à 32 cœurs, 64 Go de RAM et 128 Go de stockage.

Par défaut, les codespaces sont créés à partir d’une image Ubuntu Linux qui inclut une sélection de langages et d’outils connus, mais vous pouvez utiliser une image basée sur une distribution Linux de votre choix et la configurer pour vos besoins particuliers. Quel que soit votre système d’exploitation local, votre codespace s’exécute dans un environnement Linux. Windows et MacOS ne sont pas des systèmes d’exploitation pris en charge pour le conteneur distant.

Vous pouvez vous connecter à vos codespaces à partir de votre navigateur, de Visual Studio Code, de l’application JetBrains Gateway ou en utilisant l’GitHub CLI. Lorsque vous vous connectez, vous êtes placé dans le conteneur Docker. Vous n’avez pas accès à l’hôte de machine virtuelle Linux externe.

Diagramme montrant le fonctionnement des GitHub Codespaces

Utilisation de GitHub Codespaces

Pour commencer à développer en utilisant des ressources de calcul cloud, vous pouvez créer un codespace à partir d’un modèle, ou d’une branche ou d’un commit de votre dépôt. Lorsque vous créez un codespace à partir d’un modèle, vous pouvez commencer à partir d’un modèle vide ou choisir un modèle adapté au travail que vous faites.

Pour bien démarrer avec GitHub Codespaces, consultez « Démarrage rapide pour GitHub Codespaces ». Pour plus d’informations sur la création d’un codespace, consultez « Création d’un codespace pour un référentiel » ou « Création d’un codespace à partir d’un modèle ». Si vous souhaitez revenir à un codespace que vous avez déjà créé, consultez « Ouverture d’un codespace existant ». Pour en savoir plus sur le fonctionnement de GitHub Codespaces, consultez « Présentation approfondie de GitHub Codespaces ».

Utilisation de codespaces appartenant à votre compte personnel

Tous les comptes GitHub.com personnels ont un quota mensuel d’utilisation gratuite de GitHub Codespaces inclus dans le plan Gratuit ou Pro. Vous pouvez commencer à utiliser GitHub Codespaces sur votre compte personnel sans modifier de paramètres ni fournir de détails de paiement.

Vous pouvez créer et utiliser un codespace pour n’importe quel dépôt que vous pouvez cloner. Vous pouvez également utiliser un modèle pour créer des codespaces qui ne sont pas initialement associés à un dépôt. Si vous créez un codespace à partir d’un dépôt appartenant à l’organisation, l’utilisation du codespace est facturée à l’organisation (si l’organisation est configurée pour cela) ou à votre compte personnel. Les codespaces créés à partir de modèles sont toujours facturés sur votre compte personnel.

Vous pouvez continuer à utiliser GitHub Codespaces au-delà de votre utilisation mensuelle de stockage et de calcul comprise, en fournissant des détails de paiement et en définissant une limite de dépense. Pour plus d’informations, consultez « À propos de la facturation de GitHub Codespaces ».

Utilisation de codespaces appartenant à l’organisation

Les propriétaires d’organisation peuvent activer l’utilisation de GitHub Codespaces, facturables au compte d’organisation ou d’entreprise. Cela s’applique aux codespaces créés à partir de dépôts appartenant à l’organisation. Pour plus d'informations, consultez « Activation de GitHub Codespaces pour votre organisation ». Vous pouvez définir une limite de dépense pour l’utilisation de GitHub Codespaces sur votre compte d’organisation ou d’entreprise. Pour plus d’informations, consultez « Gestion des limites de dépense pour GitHub Codespaces ».

Si l’utilisation d’un codespace est facturée à une organisation ou à une entreprise, vous le verrez lors de la création du codespace. Pour plus d’informations, consultez « Création d’un codespace pour un dépôt ». Les codespaces facturés à une organisation, ou à son entreprise parente, appartiennent à l’organisation et peuvent être supprimés par un propriétaire d’organisation. Pour plus d’informations, consultez « Suppression d’un codespace ».

Personnalisation de GitHub Codespaces

Pour personnaliser les runtimes et outils dans votre codespace, vous pouvez créer une ou plusieurs configurations de conteneur de développement pour votre dépôt. L’ajout de configurations de conteneur de développement à votre dépôt vous permet de définir un choix de différents environnements de développement adapté au travail que vont effectuer les utilisateurs dans votre dépôt.

Si vous créez un codespace à partir d’un dépôt sans configuration de conteneur de développement, GitHub Codespaces clone votre dépôt dans un environnement avec l’image du codespace par défaut qui inclut de nombreux outils, langages et environnements d’exécution. Si vous créez un codespace à partir d’un modèle, vous pouvez commencer par une première configuration en plus de l’image par défaut. Pour plus d’informations, consultez « Présentation des conteneurs de développement ».

Vous pouvez personnaliser les aspects de votre environnement de codespace à l’aide d’un dépôt dotfiles public. Vous pouvez utiliser des dotfiles pour définir des alias et des préférences d’interpréteur de commandes, ou pour installer vos préférences personnelles concernant les outils que vous souhaitez utiliser. Si vous utilisez GitHub Codespaces dans le navigateur ou dans Visual Studio Code, vous pouvez utiliser Synchronisation des paramètres pour donner à votre éditeur de codespace les mêmes paramètres, raccourcis clavier, extraits de code et extensions que vous avez configurés dans votre installation locale de Visual Studio Code.

Pour plus d’informations, consultez « Personnalisation de votre codespace ».

Facturation de Codespaces

Pour plus d’informations sur les prix, le stockage et l’utilisation de GitHub Codespaces, consultez « À propos de la facturation pour GitHub Codespaces ».

Remarque : Vous devez définir une limite de dépense non égale à zéro sur votre compte personnel, d’organisation ou d’entreprise pour que le compte puisse être facturé pour l’utilisation de GitHub Codespaces.

Par défaut, tous les comptes ont une limite de dépense GitHub Codespaces de 0 USD. Cette limite empêche de créer de nouveaux codespaces et d’ouvrir des codespaces existants, sous peine d’entraîner un coût facturable à votre compte personnel, d’organisation ou d’entreprise. Pour les comptes personnels, des codespaces peuvent toujours être créés et utilisés si le compte n’a pas atteint la limite de son utilisation mensuelle comprise. Pour les organisations et les entreprises, la limite de dépense par défaut signifie que, pour permettre aux utilisateurs de créer des codespaces facturés à l’organisation ou à son entreprise parente, la limite doit être remplacée par une valeur supérieure à 0 USD.

Les coûts de GitHub Codespaces sont toujours facturés mensuellement, même si votre compte est par ailleurs facturé annuellement. Pour plus d’informations sur la façon dont les propriétaires de l’organisation et les gestionnaires de facturation peuvent gérer la limite de dépense pour GitHub Codespaces dans une organisation, consultez « Gestion des limites de dépense pour GitHub Codespaces ».