Présentation
Un codespace est un environnement de développement hébergé dans le cloud. Vous pouvez personnaliser votre projet en GitHub Codespaces commitant des fichiers de configuration dans votre référentiel (souvent appelé Configuration-as-Code), ce qui crée une configuration d’espace de code reproductible pour tous les utilisateurs de votre projet. Consultez « Présentation des conteneurs de développement ».
Chaque espace de code que vous créez est hébergé dans GitHub un conteneur Docker, en cours d’exécution 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, 128 Go de RAM et 128 Go de stockage.
Par défaut, l'environnement de développement de codespace est créé à 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 pris en charge pour le conteneur de développement distant.
Vous pouvez vous connecter à vos espaces de code à partir de votre navigateur, depuis ou à l’aide Visual Studio CodeGitHub CLIde . Lorsque vous vous connectez, vous êtes placé dans le conteneur Docker. Vous avez un accès limité à l’hôte de machine virtuelle Linux externe.
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 personnels GitHub disposent d’un quota mensuel d’utilisation gratuite inclus GitHub Codespaces dans le plan Gratuit ou Pro. Vous pouvez commencer à utiliser GitHub Codespaces votre compte personnel sans modifier les paramètres ou fournir des 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 stockage inclus mensuel et de l’utilisation du calcul en fournissant des détails de paiement et en définissant une limite de dépense. Consultez facturation des Codespaces GitHub.
Utilisation de codespaces appartenant à l’organisation
Les propriétaires d’organisations sur GitHub Team et GitHub Enterprise de plans peuvent payer pour l’utilisation de GitHub Codespacesleurs 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 votre compte d’entreprise ou d’organisation. 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 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 configurations de conteneur de développement, GitHub Codespaces clonez votre dépôt 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 La synchronisation des paramètres pour donner à votre éditeur d’espace de code 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 pour Codespaces
Pour plus d’informations sur la tarification, le stockage et l’utilisation pour GitHub Codespaces, consultez facturation des Codespaces GitHub.
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.
Si vous disposez d’un mode de paiement valide, les dépenses peuvent être limitées par un ou plusieurs budgets. Vérifiez les budgets définis pour votre compte afin de vous assurer qu'ils correspondent à vos besoins d'utilisation. 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 et les responsables de facturation des organisations peuvent gérer la limite de dépense d’une GitHub Codespaces organisation, consultez Configurer des budgets pour contrôler les dépenses liées aux produits facturés à l’usage.