Skip to main content

充分利用包含的使用量

了解个人帐户附带的 GitHub Codespaces 的免费使用量。

个人 GitHub 帐户包含 GitHub Codespaces 的每月免费使用配额。

注意:仅个人帐户包含 GitHub Codespaces 的免费使用量。 组织或企业帐户中不包含该使用量。

Codespaces 使用量有两种类型:计算和存储。 在每月计费周期中,在使用 Codespaces 时,将从个人 GitHub 帐户中包含的免费使用量配额中扣除计算和存储使用量,直到计算或存储被用完。 达到其中一个限制后,除非设置了支出限制和付款方式,否则将限制你对 GitHub Codespaces 的使用。 在配额续订之前,你将无法创建新的 codespace 或打开现有 codespace,你将为此付费。 如果有权访问付费使用 GitHub Codespaces 的组织所拥有的存储库,你仍然可以为这些存储库创建 codespace。

个人帐户上每月提供的免费使用量旨在让你免费做出开放源代码贡献或处理副项目。 它并不足以让你免费进行日常工作。

关于 Codespaces 计算

Codespaces 计算以核心小时数计算,即 codespace 处于活动状态的时间之和,乘以乘数 codespace 的计算机类型:例如,2 核计算机的乘数为 2,8 核计算机的乘数为 8。 创建或启动 codespace 时,该 codespace 将变为活动状态。 停止或删除 codespace 时,或者 codespace 自动停止或被删除时,该 codespace 将停止处于活动状态。

默认空闲超时(在一段处于非活动状态的时间后停止 codespace)为 30 分钟。 可以根据需要减少此值。 有关详细信息,请参阅“关于 GitHub Codespaces 的计费”的“关于计算使用量的计费”部分。

关于 Codespaces 存储

可以在 github.com/codespaces 的“你的 codespace”页上查看每个 codespace 的存储使用量。

https://github.com/codespaces 页面上的三个 codespace 列表的屏幕截图。”

注意:如果 codespace 的开发容器是从默认映像生成的,则此页上显示的 codespace 大小不包括基本开发容器的大小。 免费为基本开发容器提供存储。 有关详细信息,请参阅《基本开发容器的存储使用量》。

出于计费目的,Codespaces 存储以 GB/月计算。 这是每个 codespace 从创建到删除所消耗的总存储加上预生成的存储的累积度量值。 有关详细信息,请参阅“关于 GitHub Codespaces 的计费”的“存储使用量的计费”部分。

如何节省我的每月存储?

删除未使用的 codespace 将避免不必要地使用个人帐户中包含的免费存储。 但是,如果你设置了预生成配置,包含的存储可能会在每月计费周期内继续减少。

尽管预生成未在“你的 codespace”页上列出,但为存储库创建的预生成会占用存储,即使该存储库当前没有任何 codespace。 要避免这种情况,你可以删除设置的预生成配置。 有关详细信息,请参阅“关于 GitHub Codespaces 预生成”和“管理预生成”。

了解 Codespaces 使用量

可以在 GitHub 设置中检查当前月度计费周期的累积 GitHub Codespaces 使用量。 有关详细信息,请参阅“查看 GitHub Codespaces 使用情况”。

计费页的“Codespaces”部分的屏幕截图,其中显示了“使用小时数”和“存储”的数字。

可以展开“使用小时数”和“存储”部分了解详细信息,例如,查看预生成占用了多少存储。

有关更具体的信息(例如,如果想要了解哪些存储库具有消耗存储的预生成),可以生成使用量报表。 使用量报表是通过电子邮件发送给你的 CSV 文件。 有关如何生成使用情况报告的详细信息,请参阅“查看 GitHub Codespaces 使用情况”。

若要查看 Codespaces 使用量,请筛选报表以仅显示 Product 列中包含“Codespaces”的行。

采用 Microsoft Excel 形式的使用量报表的屏幕截图。 “Product”列中的所有条目都显示为“Codespaces - Linux”。

基本开发容器的存储使用量

如果未将开发容器配置添加到存储库,或者配置未指定要使用的映像,则 GitHub 将从默认 Linux 映像创建容器。 从默认 Linux 映像生成的基本开发容器的存储是免费的,并且不会消耗包含的存储。 存储使用量将仅基于存储库中的文件以及随后添加到 codespace 的任何文件,包括 VS Code 扩展。 如果使用备用基础映像,则生成的容器和 codespace 中的所有文件都将计为已用存储。 有关默认 Linux 映像中包含内容的信息,请参阅 devcontainers/images 存储库。

可以检查哪个映像用于创建 codespace 的开发容器。 在 codespace 的终端中,运行此命令。

Shell
devcontainer-info

如果当前 codespace 的开发容器是从默认映像生成的,则此命令的输出将包含以下信息。

- Definition ID: universal
- Source code repository: https://github.com/devcontainers/images

有关使允许的使用量用得更久的提示

  • Codespace 在运行时会消耗计算使用量。 如果不使用 codespace,停止 codespace 可防止使用不必要的计算。 有关详细信息,请参阅“停止和启动 codespace”。

  • 可以在个人设置中将 Codespaces 的空闲超时减少到小于默认的 30 分钟。 这将缩短 codespace 自动停止之前处于非活动状态的时间。 这可以节省计算使用量。 有关详细信息,请参阅“设置 GitHub Codespaces 超时期限”。

  • Codespace 在存在时会消耗存储。 使用完 codespace 并且知道不会再次使用时,应删除该 codespace。 有关详细信息,请参阅“删除代码空间”。

    注意:删除 codespace 不会减少当前计费月的已用存储量,因为这是一个累积数字。

  • 配置保留期以确保自动删除忘记删除的 codespace。 默认保留期为 30 天。 有关详细信息,请参阅“配置 codespace 的自动删除”。

  • Visual Studio Code 扩展会使用存储。 请确保仅安装所需的扩展。 通过在 codespace 中运行此命令,可以了解扩展正在使用的空间量。

    Shell
    du -h -s ~/.vscode-remote/extensions
    
  • 转到 GitHub.com 的计费页 https://github.com/settings/billing ,查看“Codespaces”部分中的数字,从而监视计算和存储使用量。

    注意:存储按小时计算,并添加到现有存储使用量。 因此,在一个月的计费周期内,消耗的存储是累积的。 这意味着,在计费周期内,你在计费页上看到的值只会增加或保持不变。 在新的计费周期开始时,使用量将重置为零。 删除 codespace 或预生成不会减少当前月份的使用量数字,但会降低存储使用量的累积速率。

  • 确保仅对所需的版本和区域使用预生成。 有关详细信息,请参阅“关于 GitHub Codespaces 预生成”和“关于 GitHub Codespaces 的计费”。

    注意:如果包含的存储使用量已用尽,则在设置支出限制或续订包含的使用配额之前,将禁用新的预生成。

  • 如果已在存储库的设置中配置预生成,但未对该存储库使用 GitHub Codespaces,请考虑删除预生成配置,以避免该存储库的预生成不必要地消耗包含的存储限额。 删除预生成配置时,会删除所有关联的预生成,从此时起存储消耗会减少。 有关详细信息,请参阅“管理预生成”。

    可以在存储库设置的“Codespaces”页中检查预生成配置。 有关详细信息,请参阅“配置预生成”。

    或者,可以通过查看使用量报表来检查哪些存储库具有预生成。 有关详细信息,请参阅上面的“了解 Codespaces 使用量”。

  • 从 codespace 的默认 Linux 映像生成的容器的存储是免费的,不会减少包含的存储。 因此,可以通过使用开发容器配置中的默认映像,而不是指定更专用的映像,来避免开发容器使用存储限额。 有关详细信息,请参阅上面的“开发容器简介”和“基本开发容器的存储使用量”。