配置预生成

可以为存储库的特定分支与特定开发容器配置文件的组合设置预生成配置。

从启用预生成的父分支创建的所有分支通常也会获得同一开发容器配置的预生成。这是因为使用父分支所用开发容器配置的子分支的预生成在大多数情况下是相同的，因此可以帮助开发人员从这些分支更快地创建 codespace。有关详细信息，请参阅“开发容器简介”。

通常，如果为分支配置预生成，预生成可用于多种计算机类型。但是，如果存储库大于 32 GB，预生成就不适用于 2 核和 4 核计算机类型，因为这些计算机类型提供的存储限制为 32 GB。

先决条件

预生成是使用 GitHub Actions 创建的。因此，必须在要为其配置预生成的存储库中启用 GitHub Actions。有关详细信息，请参阅“管理存储库的 GitHub Actions 设置”。

在 GitHub.com 上，导航到存储库的主页。 1. 在存储库名称下，单击 “设置”。
在边栏的“代码和自动化”部分中，单击“ Codespaces”。
在页面的“预生成配置”部分，单击“设置预生成”。
选择要为其设置预生成的分支。

注意：从启用预生成的基础映像分支创建的所有分支通常也会获得同一开发容器配置的预生成。例如，如果在存储库的默认分支上为开发容器配置文件启用预生成，则大多数情况下，基于默认分支的分支也会获得同一开发容器配置的预生成。
根据需要，可以在显示的“配置文件”下拉菜单中选择要用于预生成的 devcontainer.json 配置文件。有关详细信息，请参阅“开发容器简介”。
选择要如何自动触发预生成更新。
- 每次推送（默认设置）- 通过此设置，预生成将在每次对给定分支进行推送时更新。这可确保从预生成生成的 codespace 始终包含最新的 codespace 配置，包括任何最近添加或更新的依赖项。
- 配置更改时 - 使用此设置时，每次更新给定存储库和分支的相关配置文件时，都会更新预生成。这可确保在从预生成生成 codespace 时使用对存储库的开发容器配置文件进行的更改。更新预生成的 GitHub Actions 工作流的运行频率较低，因此此选项使用的 GitHub Actions 分钟数较少。但是，此选项不保证 codespace 始终包含最近添加或更新的依赖项，因此在创建 codespace 后可能需要手动添加或更新这些依赖项。
- 计划 - 使用此设置，可以根据你定义的自定义计划更新预生成。这可以减少 GitHub Actions 分钟数消耗，但是，使用此选项，可以创建 codespace，而不使用最新的开发容器配置更改。
根据需要，可以选择“减少仅对特定区域可用的预生成”，以便仅在指定区域中创建预生成。选择要在其中提供预生成的区域。

默认情况下，预生成在所有可用区域中创建，每个预生成都会产生存储费用。
注释：
- 每个区域的预生成会产生单独的存储费用。因此，应只为已知将使用的区域启用预生成。有关详细信息，请参阅“关于 GitHub Codespaces 的计费”。
- 开发人员可以为 GitHub Codespaces 设置其默认区域，这样就可以减少要启用预生成的区域。有关详细信息，请参阅“为 GitHub Codespaces 设置默认区域”。
根据需要，可以在“模板历史记录”下设置要保留的预生成模板版本数。可以输入介于 1 和 5 之间的任意数字。默认保存的版本数为 2，这意味着只保存最新版本的和上一个版本的预生成。

根据预生成触发器设置，预生成可能会随每个推送或每个开发容器配置的更改而更改。保留较旧版本的预生成使你能够使用与当前预生成不同的开发容器配置从较旧的提交创建预生成。通过此设置可将保留的版本数设置为所需的级别。

如果将保存的预生成版本数设置为 1，GitHub Codespaces 将仅保存最新版本的预生成，并在每次模板更新时删除旧版本。这意味着，如果返回到较旧的开发容器配置，则不会获取预生成的 codespace。

保留的每个预生成版本都需支付存储费用。例如，如果要在 4 个区域中生成预生成并保留 2 个版本，则最多需要支付 8 个预生成的存储费用。有关计费的详细信息，请参阅“关于 GitHub Codespaces 的计费”。
根据需要，可以添加用户或团队，以便在此配置的预生成工作流运行失败时发出通知。可以开始键入用户名、团队名称或全名，然后在显示名称后单击该名称以将其添加到列表中。发生预生成失败时，添加的用户或团队将收到电子邮件，其中包含工作流运行日志链接，以帮助进一步调查。
根据需要，单击页面底部的“显示高级选项”。

在“高级选项”部分中，如果选择“禁用预生成优化”，则当最新的预生成工作流失败或当前正在运行时，将在没有预生成的情况下创建 codespace。有关详细信息，请参阅“预生成故障排除”。
单击“创建”。

如果存储库的开发容器配置指定了访问其他存储库的权限，你将看到一个授权页面。有关如何在 devcontainer.json 文件中指定此权限的详细信息，请参阅“管理对 codespace 中其他存储库的访问”。

单击查看请求权限的详细信息。

单击“授权并继续”，授予这些权限来创建预生成。另外，可以单击“在未经授权的情况下继续”，但如果这样做，从生成的预生成创建的 codespace 可能无法正常工作。

注意：使用此预生成创建 codespace 的用户也需要授予这些权限。

创建预生成配置后，它会列在存储库设置的 GitHub Codespaces 页面中。 GitHub Actions 工作流已排队，然后会运行，从而根据所选分支和开发容器配置文件在指定的区域中创建预生成。

预生成配置列表的屏幕截图

有关编辑和删除预生成配置的信息，请参阅“管理预生成”。

配置环境变量

若要让预生成过程能够访问创建开发环境所需的环境变量，可将这些变量设置为 Codespaces 存储库机密或为 Codespaces 组织机密。有关详细信息，请参阅“为存储库添加机密”和“为组织添加机密”。

以这种方式创建的机密将由从该存储库创建 codespace 的任何人访问。如果不希望这样，也可以设置 CODESPACES_PREBUILD_TOKEN 机密。 CODESPACES_PREBUILD_TOKEN 机密仅用于预生成，并且无法在用户的 codespace 中访问其值。

预生成在生成环境时不会使用任何用户级机密，因为这些机密在创建 codespace 后才会可用。