默认情况下,Codespaces 在停止后会自动删除,并保持非活动状态 30 天。
但是,由于 Codespaces 会产生存储费用,因此您可能希望通过在个人设置中更改 GitHub Codespaces 的默认保留期来缩短保留期。 有关存储费用的详细信息,请参阅关于 GitHub Codespaces 的计费”。
注意:无论您是否设置了个人代码空间保留期,最好养成删除不再需要的代码空间的习惯。 更多信息请参阅“删除代码空间”。
无论代码空间是否包含未推送的更改,都会发生自动删除。 要防止自动删除代码空间,只需再次打开代码空间即可。 每次连接到代码空间时都会重置保留期,并在代码空间停止时重新启动保留倒计时。
如果存储库属于某个组织,则组织管理员可能已为整个组织设置了保留期。 如果此保留期小于个人设置中的默认保留期,则组织保留期将应用于您为此存储库创建的代码空间。 更多信息请参阅“限制代码空间的保留期”。
每个代码空间都有自己的保留期。 因此,您可能具有不同租用期的代码空间。 例如,如果:
- 您创建了一个代码空间,更改了默认保留期,然后创建了另一个代码空间。
- 您使用 GitHub CLI 创建了代码空间,并指定了不同的保留期。
- 您从组织拥有的存储库创建了代码空间,该存储库具有为组织配置的保留期。
注:保留期以天为单位指定。 一天表示一个 24 小时的时间段,从一天中停止代码空间的时间开始。
为代码空间设置默认保留期
-
在任何页面的右上角,单击您的个人资料照片,然后单击 Settings(设置)。
-
在边栏的“Code, planning, and automation(代码、规划和自动化)”部分中,点击 Codespaces。
-
在“Default retention period(默认保留期)”下,输入代码空间停止后默认希望保留的天数。
您可以将默认保留期设置为介于
0
和30
天之间。警告:将期限设置为
0
将导致在停止代码空间时立即删除代码空间,或者由于不活动超时而删除。 有关详细信息,请参阅“设置 GitHub Codespaces 的超时期”。 -
单击 Save(保存)。
使用 GitHub CLI 创建代码空间时,可以覆盖此默认值。 如果在组织中创建了指定较短保留期的代码空间,则组织级值将覆盖您的个人设置。
如果您将保留期设置为一天以上,则会在删除前一天收到电子邮件通知。
检查自动删除之前的剩余时间
您可以检查代码空间是否即将被自动删除。
当非活动代码空间接近其保留期结束时,这将在 https://github.com/codespaces 上 GitHub 的代码空间列表中指示。
设置代码空间的保留期
若要在创建代码空间时设置代码空间保留期,请将 --retention-period
标志与 codespace create
子命令一起使用。 以天为单位指定期限。 期限必须介于 0 到 30 天之间。
gh codespace create --retention-period DAYS
如果在创建代码空间时未指定保留期,则将使用默认保留期或组织保留期,具体取决于哪个保留期更短。 有关设置默认保留期的信息,请单击此页面上的“Web browser(Web 浏览器)”选项卡。
要了解有关 GitHub CLI 的更多信息,请参阅“关于 GitHub CLI”。
设置保留期
您可以在 Web 浏览器的 GitHub.com 上设置默认保留期。 或者,如果使用 GitHub CLI 创建代码空间,则可以为该特定代码空间设置保留期。 有关详细信息,请单击上面的相应选项卡。
检查代码空间是否很快将自动删除
您可以在 Visual Studio Code 桌面应用程序中检查代码空间是否即将被自动删除。
-
在 VS 代码 中,从左侧边栏单击 Remote Explorer 图标。
-
如果尚未选择远程资源管理器,请从远程资源管理器右上角的下拉菜单中选择 GitHub Codespaces 。
-
在“GITHUB CODESPACES”下,将鼠标指针放在您感兴趣的代码空间上。 将显示一个弹出框,其中显示有关代码空间的信息。
如果代码空间即将结束其保留期,则会包含一行,告诉您何时删除代码空间。