Qu’est-ce que GitHub Codespaces ?

Introduction

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. Consultez Présentation des conteneurs de développement.

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 environements de développement codespace 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 de développement à distance.

Vous pouvez vous connecter à vos codespaces à partir de votre navigateur, depuis Visual Studio Code, ou en utilisant GitHub CLI. Lorsque vous vous connectez, vous êtes placé dans le conteneur Docker. Vous disposez d'un accès limité à l'hôte externe de I'ordinateur virtuel Linux.

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 commencer 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 dépôt 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 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.

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.

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. Consultez Facturation GitHub Codespaces.

Utilisation de codespaces appartenant à l’organisation

Les propriétaires d’organisations sur les plans GitHub Team et GitHub Enterprise peuvent payer l’utilisation de GitHub Codespaces par les membres et collaborateurs. Cela s’applique aux codespaces créés à partir de dépôts appartenant à l’organisation. Consultez Choisir qui possède et achète les codespaces dans 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. Consultez Configurer des budgets pour contrôler les dépenses liées aux produits facturés à l’usage.

Si l’utilisation d’un codespace est facturée à une organisation ou à une entreprise, vous le verrez lors de la création du codespace. 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. Consultez Suppression d’un codespace.

Votre capacité à créer des codespaces à partir de dépôts appartenant à l’organisation dépend de plusieurs facteurs, notamment la visibilité du dépôt et les paramètres de l’organisation ou de son entreprise parente. Pour plus d’informations, consultez « Résolution des problèmes de création et de suppression de codespaces ».

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 espace de code à partir d'un référentiel sans aucune configuration de conteneur de développement, GitHub Codespaces clonera votre référentiel dans un environnement avec l'image de conteneur de développement 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. 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.

Consultez Personnalisation de votre codespace.

Facturation de Codespaces

Pour plus d’informations sur les prix, le stockage et l’utilisation de GitHub Codespaces, consultez Facturation GitHub Codespaces.

Si votre compte ne dispose pas d’un mode de paiement valide, l’utilisation sera bloquée dès que vous aurez épuisé votre quota.

Par défaut, si vous disposez d’un mode de paiement valide, les dépenses sont limitées à 0 USD jusqu’à ce que vous définissiez un budget. Vous pouvez définir et gérer un budget afin de limiter les dépenses pour un produit ou une référence SKU. Consultez Configurer des budgets pour contrôler les dépenses liées aux produits facturés à l’usage.

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 Configurer des budgets pour contrôler les dépenses liées aux produits facturés à l’usage.