Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

为组织启用 GitHub Codespaces

你可以控制组织中的哪些用户可以使用 GitHub Codespaces(费用由组织承担)。

谁可以使用此功能

To alter an organization's billing settings, you must be an organization owner.

Organizations on GitHub Team and GitHub Enterprise plans can enable use of GitHub Codespaces, billable to the organization. These organizations can then access settings that apply to codespaces paid for by the organization. For more information, see "GitHub 的产品."

关于为组织启用 GitHub Codespaces

GitHub Team 和 GitHub Enterprise 计划的组织所有者可以允许某些用户创建和使用 codespace,费用由组织承担。 这适用于通过组织拥有的存储库创建的 codespaces。 有关详细信息,请参阅“GitHub 的产品”和“关于 GitHub Codespaces 的计费”。

如果用户可以访问组织的其中一个存储库,但不允许其创建由组织承担费用的 codespace,则该用户仍然可从存储库创建 codespace。 这些 codespace 将在用户的个人帐户上产生使用量。

无论是谁负责 codespace 费用,都只有可以将更改推送到存储库或创建存储库分支的人才能为该存储库创建 codespace。 若要允许用户为组织拥有的存储库创建 codespace,必须执行以下操作之一。

  • 确保用户具有对存储库的读取访问权限,并且存储库允许创建分支,以便用户可以从存储库创建 codespace,将其更改推送到分支,并为他们想要进行的任何更改创建拉取请求。 有关详细信息,请参阅“管理组织的复刻政策”。
  • 确保用户对存储库具有写入访问权限,以便他们可以直接将更改推送到存储库,而无需创建分支。

还必须确保你的组织未启用 IP 地址允许列表。 有关详细信息,请参阅 GitHub Enterprise Cloud 文档中的“管理组织允许的 IP 地址”。

若要允许人们创建会对组织进行计费的 codespace,必须:

设置支出限制后,可以在组织设置和组织拥有的存储库中访问 GitHub Codespaces 的设置。 例如,可以为存储库设置预生成,或者可以设置策略来限制可在组织的 codespace 中使用的基本映像或计算机类型。 这些策略适用于组织付费的 codespace,但不适用于从存储库创建并向用户的个人帐户计费的 codespace。

还可以使用 REST API 来管理组织拥有的 codespace,例如停止或删除 codespace。 有关详细信息,请参阅 REST API 文档中的“Codespaces 组织”。

注意:如果你是经过验证的教师或老师,则必须从 GitHub Classroom 启用 GitHub Codespaces 来使用 Codespaces 教育权益。 有关详细信息,请参阅“将 GitHub Codespaces 与 GitHub Classroom 配合使用”。

默认情况下,代码空间只能访问从中创建它的存储库。 如果希望组织中的 codespace 能够访问 codespace 创建者可以访问的其他组织存储库,请参阅“管理组织代码空间的存储库访问”。

选择可以创建会对组织进行计费的 codespace 的人员

  1. 在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的组织”。

    @octocat 的个人资料图片下的下拉菜单的屏幕截图。 “你的组织”以深橙色标出。 2. 在组织旁边,单击“设置”。

    “octo-org”组织的屏幕截图,其中用深橙色边框突出显示了“设置”按钮。 1. 单击左侧边栏中的 “Codespaces”。 1. 在左侧栏的“ Codespaces”下单击“常规” 。

  2. 在 Codespaces 设置页上的“计费”下,选择以下选项之一:

    • 已禁用 - 不会因使用 codespace 对组织进行计费。 为组织存储库创建的 Codespaces 会向创建它们的个人用户进行计费。
    • 所选成员 - 由所选成员为组织存储库创建的 Codespaces 会对组织进行计费。
    • 所有成员 - 由组织成员为组织存储库创建的 Codespaces 会对组织进行计费。
    • 所有成员和外部协作者 - 由组织成员和外部协作者为组织存储库创建的 Codespaces 会对组织进行计费。

    注意:选择“所有成员和外部协作者”时,所有已添加到特定存储库的外部协作者都可以对这些存储库创建和使用 Codespaces,这种使用会对组织进行计费。 有关管理外部协作者的详细信息,请参阅“添加外部协作者到组织的仓库”。

  3. 单击“ 保存”。

  4. 如果选择了“所选成员”,则会显示一个输入框,以供你输入要选择的用户的名称。

    “保存”按钮下方的输入框的屏幕截图,用于输入用户名。 用户“octocat”已被添加为选定成员。

为组织禁用 Codespaces

可以阻止创建和使用可对组织进行计费的 codespace。

注意:如果为某些组织成员和协作者或整个组织禁用 GitHub Codespaces 的计费,则任何可以将更改推送到组织中的存储库或创建分支的人仍然可以使用其个人帐户为该存储库创建 codespace。 但是,这不会对组织产生任何费用。 有关限制对存储库的访问的信息,请参阅“管理有权访问存储库的团队和人员”。

  1. 在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的组织”。

    @octocat 的个人资料图片下的下拉菜单的屏幕截图。 “你的组织”以深橙色标出。 2. 在组织旁边,单击“设置”。

    “octo-org”组织的屏幕截图,其中用深橙色边框突出显示了“设置”按钮。 1. 单击左侧边栏中的 “Codespaces”。 1. 在左侧栏的“ Codespaces”下单击“常规” 。

  2. 在 Codespaces 设置页上的“计费”下,选择“已禁用”。

设置支出限制

注意:必须为个人、组织或企业帐户设置非零支出限制,然后才能向帐户对 GitHub Codespaces 的使用进行计费。

默认情况下,所有帐户的 GitHub Codespaces 支出限制为 0 美元。 这可以防止创建新的 codespace 或打开现有 codespace,如果执行这些操作,将对个人、组织或企业帐户产生可计费成本。 对于个人帐户,如果帐户尚未达到其每月包含的使用量限制,则始终可以创建和使用 codespace。 对于组织和企业,默认支出限制意味着,要允许用户创建向组织或其父企业计费的 codespace,必须将限制更改为高于 0 美元的值。

有关管理和更改帐户支出限制的信息,请参阅“管理 GitHub Codespaces 的支出限制”。