Skip to main content

为组织启用或禁用 GitHub Codespaces

你可以控制哪些用户可以在组织的专用存储库中使用 GitHub Codespaces。

谁可以使用此功能

Organization owners can control which users can use GitHub Codespaces.

Organizations on GitHub Team and GitHub Enterprise plans can choose to disable GitHub Codespaces in private repositories. For more information, see "GitHub 的计划."

关于启用或禁用 GitHub Codespaces

GitHub Codespaces 始终在组织的公共存储库中可用,任何用户都可以从这些存储库创建 codespace。 如果你的组织使用 GitHub Free 计划,则 GitHub Codespaces 也始终在组织的专用存储库中可用,任何有权访问这些存储库的用户都可以自费创建 codespace。

如果你是使用 GitHub Team 或 GitHub Enterprise Cloud 计划的组织的所有者,可以选择在组织的专用存储库中启用或禁用 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,将其更改推送到分支,并为他们想要进行的任何更改创建拉取请求。 有关详细信息,请参阅“管理组织的复刻政策”。
  • 确保用户对存储库具有写入访问权限,以便他们可以直接将更改推送到存储库,而无需创建分支。

此外,若要允许用户创建 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.com 的右上角,选择个人资料照片,然后单击 “你的组织”****。

    @octocat 的个人资料图片下的下拉菜单的屏幕截图。 “你的组织”以深橙色标出。

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

  3. 单击左侧边栏中的 “Codespaces”。

  4. 在左侧栏的“ Codespaces”下单击“常规” 。

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

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