充分利用包含的使用量

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

在本文中

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

注意

GitHub Codespaces 的免费使用仅包含在个人帐户中。 组织或企业账户中不包括它。

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

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

关于 Codespaces 计算

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

默认空闲超时（在一段处于非活动状态的时间后停止 codespace）为 30 分钟。 可以根据需要减少此值。 请参阅“限制空闲超时期限”

关于 Codespaces 的存储

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

https://github.com/codespaces 页面上三个代码空间列表的屏幕截图。

注意

如果 codespace 的开发容器是从默认映像生成的，则此页上显示的 codespace 大小不包括基本开发容器的大小。 免费为基本开发容器提供存储。 请参阅基本开发容器的存储使用量。

出于计费目的，Codespaces 存储以 GB-小时计算。 请参阅“GitHub Codespaces 计费”。

我的每月存储空间去哪里了？

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

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

了解 Codespaces 使用量

您可以在 GitHub 设置中查看本月的计费周期中 GitHub Codespaces 的累计使用情况。 请参阅“查看按流量计费的产品和许可证的使用情况”。

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

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

有关更具体的信息（例如，如果想要了解哪些存储库具有消耗存储的预生成），可以生成使用量报表。 使用量报表是通过电子邮件发送给你的 CSV 文件。 有关如何生成使用情况报告的详细信息，请参阅 查看按流量计费的产品和许可证的使用情况。

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

Microsoft Excel中的使用情况报告的屏幕截图。 “Product”列中的所有条目都显示为“Codespaces - Linux”。

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

如果未将开发容器配置添加到仓库，或者配置未指定要使用的开发容器映像，则 GitHub 将从默认 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 不会减少当前计费月的已用存储量，因为这是一个累积数字。

  • 配置保留期限，以确保您忘记删除的 codespaces 会被自动删除。 默认保留期为 30 天。 请参阅“配置 codespace 的自动删除”。

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

    Shell
    du -h -s ~/.vscode-remote/extensions

  • 转到 GitHub 的计费页 https://github.com/settings/billing　，查看“Codespaces”部分中的数字，从而监视计算和存储使用量。

    注意

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

  • 确保仅对所需的版本和区域使用预生成。 请参阅“关于 GitHub Codespaces 预构建”。

    注意

    如果包含的存储使用量已用尽，则在设置预算或续订包含的使用配额之前，将禁用新的预生成。

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

    可以在存储库设置的“Codespaces”页中检查预生成配置。 请参阅“配置预生成”。

    或者，可以通过查看使用量报表来检查哪些存储库具有预生成。 请参阅上面的关于 Codespaces 使用情况的说明。

  • 从 codespace 的默认开发容器映像生成的容器的存储是免费的，不会占用包含的存储。 因此，可以通过使用开发容器配置中的默认映像，而不是指定更专用的映像，来避免开发容器使用存储限额。 请参阅上面的 开发容器简介 和基本开发容器的存储使用量。