Configuration de la suppression automatique de vos espaces de code

Les codespaces inactifs sont automatiquement supprimés. Vous pouvez choisir la durée pendant laquelle vos espaces de code arrêtés sont conservés, jusqu’à un maximum de 30 jours.

Dans cet article

Par défaut, les GitHub Codespaces sont automatiquement supprimés après avoir été arrêtés et être restés inactifs pendant 30 jours.

Toutefois, étant donné que GitHub Codespaces entraîne des frais de stockage, vous pouvez préférer réduire la durée de conservation en changeant la durée par défaut dans vos paramètres personnels pour GitHub Codespaces. Pour plus d’informations sur les frais de stockage, consultez À propos de la facturation pour GitHub Codespaces.

Note

Que vous ayez défini ou non une durée de conservation des espaces de code personnels, il est judicieux de prendre l’habitude de supprimer les espaces de code dont vous n’avez plus besoin. Consultez Suppression d’un codespace.

La suppression automatique se produit indépendamment du fait qu’un espace de code contient des modifications non poussées. Pour empêcher la suppression automatique d’un espace de code, ouvrez à nouveau l’espace de code. La durée de conservation est réinitialisée chaque fois que vous vous connectez à un espace de code, et le compte à rebours de conservation redémarre lorsque l’espace de code est arrêté.

Si un référentiel appartient à une organisation, le propriétaire de l’organisation peut avoir défini une durée de rétention pour l’ensemble l’organisation. Si cette durée est inférieure à la durée de conservation par défaut dans vos paramètres personnels, la durée de conservation de l’organisation s’applique aux espaces de code que vous créez pour ce dépôt. Consultez Restriction de la période de conservation pour les codespaces.

Chaque espace de code a sa propre durée de conservation. Vous pouvez donc avoir des espaces de code avec des durées de conservation différentes. Par exemple, si :

  • Vous avez créé un espace de code, modifié votre durée de conservation par défaut, puis créé un autre espace de code.
  • Vous avez créé un espace de code à l’aide de GitHub CLI et spécifié une durée de conservation différente.
  • Vous avez créé un codespace pour un dépôt appartenant à l’organisation, avec une période de conservation configurée dans les paramètres d’organisation. La propriété des codespaces que vous créez s’affiche dans la page Vos codespaces.

Note

La période de rétention est spécifiée en jours. Un jour représente une période de 24 heures, en commençant à l’heure de la journée à laquelle vous arrêtez un espace de code.

Définition d’une durée de conservation par défaut pour vos espaces de code

  1. Dans le coin supérieur droit de n’importe quelle page sur GitHub, cliquez sur votre photo de profil, puis sur Paramètres .

  2. Dans la section « Planification du code et automatisation » de la barre latérale, cliquez sur Codespaces.

  3. Sous « Durée de conservation par défaut », entrez le nombre de jours pendant lesquels vous souhaitez que vos espaces de code soient conservés, par défaut, après leur arrêt.

    Capture d’écran du paramètre « Période de rétention par défaut », actuellement défini sur 1 jour. En regard du nombre de jours se trouve le bouton « Enregistrer ».

    Vous pouvez définir votre durée de conservation par défaut entre 0 et 30 jours.

    Warning

    La définition de la durée sur 0 entraîne la suppression immédiate de vos espaces de code lorsque vous les arrêtez ou lorsqu’ils expirent en raison d’une absence d’activité. Consultez Définition de votre délai d'expiration pour GitHub Codespaces.

  4. Cliquez sur Enregistrer.

Lorsque vous créez un espace de code à l’aide de GitHub CLI, vous pouvez remplacer cette valeur par défaut. Si vous créez un espace de code dans une organisation qui spécifie une durée de conservation plus courte, la valeur au niveau de l’organisation remplace votre paramètre personnel.

Si vous définissez une durée de conservation de plus d’un jour, vous recevrez une notification par e-mail un jour avant sa suppression.

Vérification du temps restant jusqu’à la suppression automatique

Vous pouvez vérifier si un espace de code doit être supprimé automatiquement bientôt.

Lorsqu’un espace de code inactif approche de la fin de sa durée de conservation, cela est indiqué dans votre liste d’espaces de code sur GitHub à l’adresse https://github.com/codespaces.

Capture d’écran d’une liste de trois codespaces. Le troisième d’entre eux est intitulé « Expiration dans 4 jours » ; il est mis en évidence avec un contour orange foncé.

Éviter la suppression automatique des codespaces

Vous pouvez vouloir conserver un codespace plus longtemps que la période de conservation définie dans vos paramètres personnels. Pour cela, utilisez l’option « Garder le codespace ». Quand vous sélectionnez cette option, votre codespace est conservé indéfiniment, jusqu’à ce que vous le supprimiez manuellement.

Note

L’option « Garder le codespace » n’est pas disponible pour les codespaces appartenant à une organisation et affectés par une stratégie de conservation de l’organisation.

Les codespaces entraînent des coûts de stockage ou consomment votre allocation de stockage inclus si le codespace appartient à votre compte GitHub personnel. Vous devez donc être conscient des implications que peuvent avoir les codespaces stockés indéfiniment sur vos coûts. Consultez À propos de la facturation pour GitHub Codespaces.

  1. Dans le coin supérieur gauche de GitHub, sélectionnez , puis cliquez sur Codespaces pour accéder à la page « Vos codespaces » sur github.com/codespaces.

  2. À droite du codespace que vous voulez exempter de suppression automatique, cliquez sur , puis sur Garder le codespace.

    Capture d’écran du menu déroulant d’un codespace actif. L’option « Conserver le codespace » a une info-bulle indiquant « Expire 10 jours après l’arrêt ».

Les codespaces que vous avez exemptés de suppression automatique sont indiqués dans votre liste de codespaces avec l’icône de signet ().

Capture d’écran d’une section de la liste codespaces, montrant un codespace étiqueté avec l’icône de signet.

Définition d’une durée de conservation pour un espace de code

Si vous avez installé l’GitHub CLI, vous pouvez l’utiliser avec GitHub Codespaces. Pour obtenir des instructions d’installation pour GitHub CLI, consultez le dépôt GitHub CLI.

Pour définir la durée de conservation de l’espace de code lorsque vous en créez un, utilisez l’indicateur --retention-period avec la sous-commande codespace create. Spécifiez la durée en jours. La durée doit être comprise entre 0 et 30 jours.

gh codespace create --retention-period DAYS

Si vous ne spécifiez pas de durée de conservation lorsque vous créez un espace de code, votre durée de conservation par défaut ou la durée de conservation d’une organisation sera utilisée, selon celle qui est la plus faible. Pour plus d’informations sur la définition de votre durée de conservation par défaut, cliquez sur l’onglet « Navigateur web » dans cette page.

Note

Pour plus d’informations sur GitHub CLI, consultez « À propos de GitHub CLI ».

Définition de la durée de conservation

Vous pouvez définir votre période de rétention par défaut dans votre navigateur web, sur GitHub. Sinon, si vous utilisez GitHub CLI pour créer un espace de code, vous pouvez définir une durée de conservation pour cet espace de code particulier. Pour plus d’informations, cliquez sur l’onglet approprié ci-dessus.

Vérification pour déterminer si les espaces de code seront bientôt supprimés automatiquement

Vous pouvez vérifier, dans l’application de bureau Visual Studio Code, si un espace de code doit être supprimé automatiquement bientôt.

  1. Dans VS Code, dans la barre Activité, cliquez sur l’icône de l’Explorateur distant.

    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.

    Note

    Si l'explorateur à distance n'est pas affiché dans la barre d'activité :

    1. Accédez à la palette de commandes. Par exemple, en appuyant sur Maj+Commande+P (Mac)/Ctrl+Maj+P (Windows/Linux).
    2. Entrez : details.
    3. Cliquez sur Codespaces : Détails.

  2. Choisissez GitHub Codespaces dans le menu déroulant en haut à droite de l’Explorateur distant, s’il n’est pas déjà sélectionné.

  3. Sous « GITHUB CODESPACES », positionnez le pointeur de la souris sur l’espace de code qui vous intéresse. Une zone contextuelle s’affiche pour vous montrer des informations sur l’espace de code.

    Si le codespace approche de la fin de sa période de rétention, une ligne est incluse indiquant à quel moment cette période va expirer.

    Capture d’écran de la barre latérale « Explorateur distant ». Dans le menu contextuel d’un codespace, « Expiration dans 19 jours » est mis en évidence avec un contour orange.

Pour aller plus loin