跳至主要内容

启用或禁用组织的 GitHub Codespaces

您可以控制哪些用户可以在组织的私有代码库中使用 GitHub Codespaces。

谁可以使用此功能?

组织所有者可以控制哪些用户可以使用 GitHub Codespaces。

GitHub Team 和 GitHub Enterprise 计划的组织可以选择禁用私有代码库中的 GitHub Codespaces。有关更多信息,请参阅“GitHub 的计划”。

关于启用和禁用 GitHub Codespaces

GitHub Codespaces 始终在组织的公共代码库中可用,任何用户都可以从此类代码库创建 Codespace。如果您的组织使用的是 GitHub 免费计划,则 GitHub Codespaces 也始终在您的组织的私有代码库中可用,任何有权访问这些代码库的用户都可以自费创建 Codespace。

如果您是 GitHub Team 或 GitHub Enterprise Cloud 计划的组织所有者,您可以选择是否在组织的私有代码库中启用或禁用 GitHub Codespaces。如果您在这些代码库中启用 GitHub Codespaces,您可以选择是为所有用户启用还是为部分成员和协作者启用。

通过启用 GitHub Codespaces,您可以帮助您的成员和协作者快速开始项目,而无需在本地安装许多工具和依赖项即可开始贡献。但是,您可能希望通过一次为一组用户启用它来逐步在您的组织中推出 GitHub Codespaces。或者,如果您需要遵守需要加强控制组织中私有代码的安全法规,您可能希望为所有成员禁用 GitHub Codespaces。

如果您已为至少部分用户启用了私有代码库中的 GitHub Codespaces,您可以选择为这些用户在组织中的所有代码库中使用 GitHub Codespaces 付费。有关更多信息,请参阅“选择谁拥有并支付组织中的 Codespaces”。

如果您无法访问在组织中启用 GitHub Codespaces 的设置,这可能是因为企业所有者已为您的组织禁用了 GitHub Codespaces。有关更多信息,请参阅 GitHub Enterprise Cloud 文档中的“强制执行企业中的 GitHub Codespaces 策略”。

启用 GitHub Codespaces 的先决条件

只有能够向代码仓库推送更改或分叉代码仓库的人员才能为此代码仓库创建 codespace。要允许用户为您的组织拥有的代码仓库创建 codespace,您必须执行以下操作之一。

  • 确保用户具有对代码仓库的读取权限,并且代码仓库允许分叉,以便用户可以从代码仓库创建 codespace,将其更改推送到分叉仓库,并为他们想要进行的任何更改创建拉取请求。有关更多信息,请参阅“管理组织的分叉策略”。
  • 确保用户具有对代码仓库的写入权限,以便他们可以直接向代码仓库推送更改,无需分叉。

此外,要允许用户创建 codespace,您必须确保您的组织未启用 IP 地址允许列表。有关更多信息,请参阅 GitHub Enterprise Cloud 文档中的“管理组织的允许 IP 地址”。

注意

如果您是经过验证的教育工作者或教师,则必须从 GitHub Classroom 启用 GitHub Codespaces 才能使用您的 Codespaces 教育福利。有关更多信息,请参阅“将 GitHub Codespaces 与 GitHub Classroom 结合使用”。

关于更改设置

如果您删除用户的 GitHub Codespaces 访问权限,用户将立即无法打开他们从组织的私有代码仓库创建的现有 codespace。如果您之前为用户从组织的公共代码仓库创建的 codespace 付费,则这些 codespace 的所有权将转移给用户。

在删除用户的访问权限之前,您应该提醒受影响的用户。如果他们在 codespace 中有未发布的作品,他们可以确保在失去访问权限之前将作品推送到代码仓库的分支。

用户一旦失去对 codespace 的访问权限,codespace 将保留 7 天,然后永久删除。在此 7 天期间,要恢复 codespace 中未发布的作品,用户必须通过 GitHub 支持门户 联系我们。

启用或禁用 GitHub Codespaces

注意

如果您删除用户的 GitHub Codespaces 访问权限,用户将立即无法打开他们从组织的私有代码仓库创建的现有 codespace。有关更多信息,请参阅“关于更改设置”。

  1. 在 GitHub 的右上角,选择您的个人资料照片,然后单击 您的组织.

  2. 在组织旁边,单击设置

  3. 在左侧边栏中,单击 Codespaces

  4. 在左侧边栏中的 Codespaces 下,单击常规

  5. 在 Codespaces 设置页面上的“Codespaces 访问权限”下,选择您在组织的私有代码仓库中对 GitHub Codespaces 的首选设置。

    您可以禁用 Codespaces,为特定成员或团队启用,为所有成员启用,或为所有成员和协作者启用。