跳至主要内容

为您的组织启用或禁用 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,您可以选择为这些用户在您组织中的所有仓库中使用 GitHub Codespaces 付费。有关更多信息,请参阅“选择谁拥有和支付您组织中的 codespace”。

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

启用 GitHub Codespaces 的先决条件

只有可以将更改推送到存储库或分叉存储库的人员才能为该存储库创建 codespace。要允许用户为您的组织拥有的存储库创建 codespace,您必须执行以下操作之一。

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

此外,要允许用户创建 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 的访问权限,该用户将立即无法打开他们从您的组织的私有存储库中创建的现有 Codespaces。有关更多信息,请参阅“关于更改您的设置”。

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

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

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

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

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

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