{"meta":{"title":"Création d’un codespace pour un dépôt","intro":"Vous pouvez créer un espace de code pour une branche dans un dépôt à développer en ligne.","product":"Codespaces","breadcrumbs":[{"href":"/fr/codespaces","title":"Codespaces"},{"href":"/fr/codespaces/developing-in-a-codespace","title":"Développement dans un espace de code"},{"href":"/fr/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository","title":"Créer un codespace pour un dépôt"}],"documentType":"article"},"body":"# Création d’un codespace pour un dépôt\n\nVous pouvez créer un espace de code pour une branche dans un dépôt à développer en ligne.\n\n## À propos de la création d’un codespace pour un dépôt\n\nVous pouvez créer un codespace sur GitHub, dans Visual Studio Code ou à l’aide de GitHub CLI. Utilisez les onglets de cet article afin d’afficher des instructions pour chacune de ces méthodes de création d’un codespace.\n\nVous pouvez utiliser GitHub Codespaces sur votre compte personnel GitHub, avec le quota d’utilisation gratuite inclus chaque mois pour les comptes associés aux plans Gratuit et Pro. 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 des Codespaces GitHub](/fr/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces).\n\nLes organisations peuvent, à leurs frais, permettre aux membres et aux collaborateurs externes de créer et d’utiliser des codespaces. Pour plus d’informations, consultez « [Choisir qui possède et achète les codespaces dans votre organisation](/fr/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization) ».\n\nVotre 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](/fr/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces#no-access-to-create-a-codespace) ».\n\nSi vous démarrez un nouveau projet, vous voudrez probablement créer un codespace à partir d’un modèle et le publier dans un référentiel sur GitHub ultérieurement. Pour plus d’informations, consultez [Création d’un codespace à partir d’un modèle](/fr/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template).\n\nSi vous créez un codespace à partir d’un dépôt, le codespace est associé à une branche spécifique, qui ne peut pas être vide. Vous pouvez créer plusieurs codespaces par dépôt, voire par branche.\n\nVous pouvez voir tous les codespaces disponibles que vous avez créés sur la page « Vos codespaces ». Pour afficher cette page, dans le coin supérieur gauche de GitHub, sélectionnez , puis cliquez sur ** Codespaces**. Cela vous redirige vers [github.com/codespaces](https://github.com/codespaces).\n\n### Processus de création d’un codespace\n\nLorsque vous créez un codespace, un certain nombre d’étapes sont nécessaires pour créer votre environnement de développement et vous y connecter :\n\n* Étape 1 : la machine virtuelle et le stockage sont affectés à votre codespace.\n* Étape 2 : le conteneur est créé et votre dépôt est cloné.\n* Étape 3 : vous pouvez vous connecter au codespace.\n* Étape 4 : le codespace continue avec la configuration après création.\n\nPour plus d’informations sur ce qui se passe lorsque vous créez un codespace, consultez [Présentation approfondie de GitHub Codespaces](/fr/codespaces/about-codespaces/deep-dive).\n\nPour plus d’informations sur le cycle de vie d’un codespace, consultez [Présentation du cycle de vie des codespaces](/fr/codespaces/about-codespaces/understanding-the-codespace-lifecycle).\n\nSi vous souhaitez utiliser des crochets Git pour votre codespace, vous devez configurer les crochets en utilisant les scripts de cycle de vie `devcontainer.json`, comme `postCreateCommand`. Ils sont exécutés à l’étape 4, ci-dessus. Pour plus d’informations sur les scripts de cycle de vie, consultez la [spécification des conteneurs de développement](https://containers.dev/implementors/json_reference/#lifecycle-scripts) sur le site web Conteneurs de développement. Étant donné que votre conteneur de développement est créé une fois le dépôt cloné, aucun [répertoire de modèles Git](https://git-scm.com/docs/git-init#_template_directory) configuré dans l’image conteneur de développement ne s’applique pas à votre codespace. Les crochets doivent plutôt être installés après la création du codespace.\n\nVous pouvez modifier du code, faire du débogage et utiliser des commandes Git tout en développant dans un codespace avec VS Code. Pour plus d’informations, consultez la [documentation de VS Code](https://code.visualstudio.com/docs).\n\nPour accélérer la création des codespaces, les administrateurs de dépôt peuvent activer les prébuilds de GitHub Codespaces pour un dépôt. Pour plus d’informations, consultez « [À propos des pré-constructions de Codespaces sur GitHub](/fr/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds) ».\n\n## Création d’un codespace pour un dépôt\n\n
\n\n1. Sur GitHub, accédez à la page principale du référentiel.\n\n2. Sous le nom du dépôt, sélectionnez le menu déroulant de la branche, qui porte le nom de la branche active, puis cliquez sur la branche pour laquelle vous souhaitez créer un codespace.\n\n ![Capture d’écran du menu déroulant de la branche développée, avec la liste des différentes branches. Le menu déroulant « jonction », représenté par une icône de branche, est mis en évidence en orange.](/assets/images/help/codespaces/branch-drop-down.png)\n\n3. Cliquez sur le bouton ** Code**, puis sur l’onglet **Codespaces**.\n\n Un message s’affiche en bas de la boîte de dialogue pour vous indiquer qui paiera pour le codespace.\n\n ![Capture d’écran de la boîte de dialogue Codespaces. Le message indiquant qui paiera pour le codespace est mis en évidence avec un contour orange foncé.](/assets/images/help/codespaces/who-will-pay.png)\n\n4. Créez votre codespace en utilisant les options par défaut, ou après configuration d’options avancées :\n\n * ```\n **Utiliser les options par défaut**\n ```\n\n Pour créer un codespace en utilisant les options par défaut, cliquez sur .

\n\n * ```\n **Configurer les options avancées**\n ```\n\n Pour configurer des options avancées pour votre codespace, telles qu’un autre type de machine ou un fichier `devcontainer.json` particulier :\n\n 1. En haut à droite de l’onglet **Codespaces**, sélectionnez et cliquez sur **Nouveau avec des options**.\n\n ![Capture d’écran de la liste déroulante des options sous l’onglet « Codespaces », avec l’option « Nouveau avec des options » mise en évidence.](/assets/images/help/codespaces/default-machine-type.png)\n\n 2. Dans la page d’options pour votre codespace, choisissez vos options préférées dans les menus déroulants.\n\n ![Capture d’écran de la page des options avancées avec les boutons « Branche », « Configuration du conteneur de développement », « Région » et « Type de machine ».](/assets/images/help/codespaces/advanced-options.png)\n\n La page d’options peut également afficher les noms d’un ou plusieurs secrets qu’il vous est recommandé de créer dans vos paramètres Codespaces. Pour plus d’informations, consultez [Secrets recommandés](#recommended-secrets).\n\n > \\[!NOTE]\n >\n > * Vous pouvez marquer d’un signet la page d’options afin de disposer d’un moyen rapide de créer un codespace pour ce dépôt et cette branche.\n > * La page offre un moyen rapide de créer un codespace pour tout dépôt et toute branche. Vous pouvez accéder rapidement à cette page en tapant `codespace.new` dans la barre d’adresse de votre navigateur.\n > * Pour plus d’informations sur les fichiers de configuration de conteneur de développement, consultez [Présentation des conteneurs de développement](/fr/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers).\n > * Pour plus d’informations sur les types de machines, consultez [Modification du type de machine pour votre espace de code](/fr/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types).\n > * 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 machines](/fr/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types) » et « [Définition d’une spécification minimale pour les machines de codespaces](/fr/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines) ».\n\n 3. Cliquez sur **Créer codespace**.\n\n## Secrets recommandés\n\nLes noms des secrets définis par l’utilisateur peuvent s’afficher dans la page des options avancées lorsque vous créez un codespace. Cela se produit si des secrets recommandés ont été spécifiés dans la configuration de conteneur de développement que vous avez sélectionnée. Pour plus d’informations, consultez « [Spécification de secrets recommandés pour un dépôt](/fr/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/specifying-recommended-secrets-for-a-repository) ».\n\nScreenshot of the \"Create codespace\" page with four recommended secrets highlighted with a dark orange outline.\n\nL’entrée de valeurs pour ces secrets d’environnement de développement, lorsque vous êtes invité à le faire, est recommandée, car il est probable que votre projet aura besoin de valeurs pour ces secrets. Toutefois, il n’est pas nécessaire de fournir des valeurs pour créer un codespace. Vous pouvez définir ces secrets dans le codespace si vous préférez.\n\nSi vous saisissez une valeur pour un secret recommandé, le secret sera disponible dans le nouveau codespace. Lorsque vous cliquez sur **Créer un codespace**, le secret est également ajouté à vos paramètres personnels pour Codespaces. Vous n’aurez donc plus besoin d’entrer une valeur pour le secret lorsque vous créerez un codespace pour ce dépôt.\n\nSi le nom d’un secret est affiché avec une case à cocher que vous ne pouvez pas sélectionner et aucune zone d’entrée, c’est parce que vous avez déjà un secret de ce nom configuré dans vos paramètres personnels pour Codespaces et que vous l’avez associé à ce dépôt. Si vous avez créé un secret de ce nom, mais que vous ne l’avez pas associé à ce dépôt, la case à cocher peut être sélectionnée et, ce faisant, vous pouvez mettre à jour vos paramètres pour ajouter l’association.\n\nSi vous souhaitez changer la valeur d’un secret présélectionné, vous pouvez le faire à partir de vos paramètres personnels pour Codespaces sur [github.com/settings/codespaces](https://github.com/settings/codespaces). Pour plus d’informations, consultez « [Gestion des secrets spécifiques à votre compte pour GitHub Codespaces](/fr/codespaces/managing-your-codespaces/managing-your-account-specific-secrets-for-github-codespaces) ».\n\n
\n\n
\n\nAprès avoir connecté votre compte sur GitHub à l’extension GitHub Codespaces, vous pouvez créer un codespace. Pour plus d’informations sur l’extension GitHub Codespaces, consultez la [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces).\n\n1. Dans VS Code, dans la barre Activité, cliquez sur l’icône de l’Explorateur distant.\n\n ![Capture d’écran de la barre d’activités. L’icône de la barre latérale « Explorateur distant » (rectangle avec un cercle par-dessus) est mise en évidence avec un encadré orange.](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png)\n\n > \\[!NOTE]\n > Si l'explorateur à distance n'est pas affiché dans la barre d'activité :\n >\n > 1. Accédez à la palette de commandes. Par exemple, en appuyant sur Maj+Commande+P (Mac)/Ctrl+Maj+P (Windows/Linux).\n > 2. Entrez : `details`.\n > 3. Cliquez sur **Codespaces : Détails**.\n\n2. Pointez sur la barre latérale « Explorateur distant », puis cliquez sur .\n\n ![Capture d’écran de la barre latérale « Explorateur distant » pour GitHub Codespaces. L’info-bulle « Créer un codespace » s’affiche à côté du bouton signe plus.](/assets/images/help/codespaces/create-codespace-vscode.png)\n\n3. Dans la zone de texte, entrez le nom du référentiel dans lequel vous souhaitez développer, puis sélectionnez-le.\n\n ![Capture d’écran de « octo-org/he » entré dans la zone de texte et une liste de quatre dépôts qui commencent par cette chaîne.](/assets/images/help/codespaces/choose-repository-vscode.png)\n\n Un message s’affiche à droite des invites suivantes vous indiquant qui paiera pour le codespace.\n\n ![Capture d’écran d’une invite pour une branche, avec le message « Utilisation payée par hubwriter ».](/assets/images/help/codespaces/who-will-pay-vscode.png)\n\n4. Cliquez sur la branche sur laquelle vous souhaitez développer.\n\n5. Si vous êtes invité à choisir un fichier de configuration de conteneur de développement, choisissez un fichier dans la liste.\n\n6. Choisissez le type de machine que vous souhaitez utiliser.\n\n > \\[!NOTE]\n > 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 machines](/fr/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types) » et « [Définition d’une spécification minimale pour les machines de codespaces](/fr/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines) ».\n\n
\n\n
\n\n> \\[!NOTE]\n> Pour plus d’informations sur GitHub CLI, consultez [À propos de l’interface CLI GitHub](/fr/github-cli/github-cli/about-github-cli).\n\nPour créer un codespace, utilisez la sous-commande `gh codespace create`.\n\n```shell\ngh codespace create\n```\n\nVous êtes invité à choisir un dépôt. Un message s’affiche vous indiquant qui doit payer pour le codespace. Vous êtes invité à choisir une branche, un fichier de configuration de conteneur de développement (si plusieurs sont disponibles) et un type de machine (si plusieurs sont disponibles).\n\nVous pouvez également utiliser des indicateurs pour spécifier tout ou partie des options :\n\n```shell\ngh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE\n```\n\nDans cet exemple, remplacez `owner/repo` par l’identificateur du dépôt. Remplacez `branch` par le nom de la branche, ou le hachage SHA complet de la validation, dont vous souhaitez l’extraction initiale dans le codespace. Si vous utilisez l’indicateur `-r` sans l’indicateur `b`, le codespace est créé à partir de la branche par défaut.\n\nRemplacez `path` par le chemin du fichier de configuration de conteneur de développement que vous souhaitez utiliser pour le nouveau codespace. Si vous omettez cet indicateur et que plusieurs fichiers de conteneur de développement sont disponibles, vous êtes invité à en choisir un dans une liste. Pour plus d’informations sur le fichier de configuration de conteneur de développement, consultez [Présentation des conteneurs de développement](/fr/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers).\n\nRemplacez `machine-type` par un identificateur valide pour un type de machine disponible. Les identificateurs sont des chaînes telles que : `basicLinux32gb` et `standardLinux32gb`. Les types de machines disponibles dépendent du dépôt, de votre compte personnel et de votre emplacement. Si vous entrez un type de machine non valide ou indisponible, les types disponibles sont affichés dans le message d’erreur. Si vous omettez cet indicateur et que plusieurs types de machines sont disponibles, vous êtes invité à en choisir un dans une liste.\n\nPour obtenir des détails complets sur les options de cette commande, consultez [le manuel de GitHub CLI](https://cli.github.com/manual/gh_codespace_create).\n\n
\n\n## Pour aller plus loin\n\n* [Ouverture d’un codespace existant](/fr/codespaces/developing-in-a-codespace/opening-an-existing-codespace)\n* [Faciliter la création et la reprise rapides de codespaces](/fr/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/facilitating-quick-creation-and-resumption-of-codespaces)\n* [Points de terminaison d’API REST pour les organisations Codespaces](/fr/rest/codespaces/organizations)"}