Skip to main content

将 GitHub Codespaces 与 GitHub Classroom 配合使用

可以在 GitHub Codespaces 作业中用作首选编辑器,以便学生通过一键式设置访问基于 Visual Studio Code 浏览器的环境。

谁可以使用此功能?

Organization owners who are admins for a classroom can enable GitHub Codespaces for their organization and integrate GitHub Codespaces as the supported editor for an assignment. 有关课堂管理员的详细信息,请参阅“管理教室”。

对于使用 GitHub Codespaces 的组织,GitHub Classroom 可与 GitHub Team 配合使用。 要了解您是否符合免费升级到GitHub Team的条件,请参阅以教师身份申请 GitHub Education

关于 GitHub Codespaces

GitHub Codespaces 是一个即时的基于云的开发环境,它使用容器为你提供用于开发的公共语言、工具和实用工具。 GitHub Codespaces 还可以进行配置,使你可以为项目的所有用户创建一个相同的自定义开发环境。 请参阅“GitHub Codespaces 快速入门”。

在组织或企业中启用后 GitHub Codespaces ,用户可以从组织或企业存储库中的任何分支或提交创建代码空间,并开始使用基于云的计算资源进行开发。 可以通过浏览器或在本地使用 Visual Studio Code 连接到 codespace。

若要开始使用 GitHub Codespaces,请参阅“GitHub Codespaces 快速入门”。 有关创建 codespace 的详细信息,请参阅“为代码库创建代码空间”或“通过模板创建 codespace”。 如果要返回到已创建的 codespace,请参阅“打开现有 codespace”。 若要详细了解 GitHub Codespaces 的工作原理,请参阅“深入了解 GitHub Codespaces”。

将 GitHub Codespaces 设为 GitHub Classroom 作业中某项作业的首选编辑器,这对学生和教师都有益。 GitHub Codespaces 对于使用贷款设备或无法访问本地 IDE 设置的学生来说,这是一个不错的选择,因为每个代码空间都是基于云的,不需要本地设置。 学生可以直接在 Visual Studio Code 浏览器中启动作业存储库的代码空间,并立即开始开发,而无需任何进一步的配置。

对于具有复杂设置环境的作业,教师可以自定义存储库 codespace 的开发容器配置。 这可以确保学生在创建 codespace 时,它会自动打开由教师配置的开发环境。 有关开发容器的详细信息,请参阅“开发容器简介”。

注意

各个 codespace 会在停止且长时间未使用的情况下自动删除。 请参阅“配置 codespace 的自动删除”。

已通过验证的学生可在其个人账户中免费使用 GitHub Codespaces,每月最多可使用 180 个核心小时。 学生每月可用的存储空间和核心小时数,与 GitHub Pro 账户包含的配额相同。 有关详细信息,请参阅“GitHub Codespaces 计费”。

注意

如果学生在其 GitHub Codespaces 的作业存储库中使用 GitHub Classroom,则使用费用由教室所属组织承担,不影响学生个人账户的使用。

Codespaces关于已验证教师的教育权益

Codespaces教育权益为已验证的教师提供每月可在GitHub Codespaces中免费使用GitHub Classroom小时的额度。 免费额度预计能够满足一个由 50 人组成的班级,每月有 5 次作业的需求,使用一台双核机器,每位学生存储一个代码空间。

注意

Codespaces 教育权益目前为 公开预览,可能随时更改。 在 公开预览 版本中,如果超出免费额度,则不会向你的组织收费。

若要成为经过验证的教师,需要获得教师权益的批准。 请参阅“以教师身份申请 GitHub Education”。

在确认你已通过教师验证后,请访问GitHub Education教师页面,将组织升级到 GitHub Team 方案。 请参阅 GitHub 的产品

如果你符合Codespaces教育优惠条件,当你为组织在GitHub Codespaces中启用GitHub Classroom时,GitHub 会自动添加一项 Codespaces 策略,将组织中所有 Codespace 的机器类型限制为 2 核机器。 这有助于您充分利用免费的 GitHub Codespaces 使用额度。 但是,可以在组织设置中更改或移除这些策略。 请参阅“限制对计算机类型的访问”。

当Codespaces教育权益不再包含在公开预览中时,如果你的组织的GitHub Codespaces使用量超出免费额度,系统将按超出部分向你的组织收费。 请参阅“GitHub Codespaces 计费”。

为您的组织启用Codespaces

对于使用 GitHub Codespaces 的组织,GitHub Classroom 可与 GitHub Team 配合使用。 如果你符合 Codespaces 教育福利的资格,则必须通过 GitHub Codespaces 启用 GitHub Classroom,而不能直接在组织设置中启用。 否则,您的组织将被直接收取 GitHub Codespaces 的所有使用费用。

创建新课堂时为组织启用 Codespaces

  1. 登录 GitHub Classroom
  2. 在页面右侧,单击“新建课堂”。
  3. 在组织列表中,单击您希望用于教室的组织。 有资格使用GitHub Codespaces的组织会显示一条说明,表明其符合条件。 (可选)您可以创建一个新组织。 请参阅“从头开始创建新组织”。
  4. 在“为课堂命名”页面上,在“课堂中的 Codespaces”下方,单击“启用”。 请注意,这将为组织中的所有存储库和用户启用 GitHub Codespaces 此功能。
  5. 准备好创建新课堂时,单击“创建课堂”。

通过现有课堂为组织启用 Codespaces

  1. 登录 GitHub Classroom

  2. 在课堂列表中,单击要查看的课堂。

  3. 在课堂名称下,单击“ Settings”****。

    课堂中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  4. 在“”GitHub Codespaces下,单击“ 启用”。 这将为组织中的所有存储库和用户启用 GitHub Codespaces 此功能。 还添加了新的 Codespace 策略,用于将组织中所有 codespace 的计算机类型限制为双核计算机。

还可以使用与上述方法相同的方法来为组织禁用 GitHub Codespaces 。 请注意,这将为组织中的所有用户和存储库禁用 GitHub Codespaces 此功能。

将分配配置为使用 Codespaces

若要将 GitHub Codespaces 提供给学生用于某项作业,可以选择 GitHub Codespaces 作为该作业支持的编辑器。 创建新分配时,在“添加初学者代码并选择可选的联机 IDE”页面的“添加受支持的编辑器”下,从下拉菜单中进行选择 GitHub Codespaces

如果使用模板存储库完成作业,则可以在存储库中定义开发容器,以便在学生启动 codespace 处理作业时自定义可供学生使用的工具和运行时。 如果未定义开发容器, GitHub Codespaces 将使用默认配置,其中包含学生可能需要开发的许多常用工具。 有关定义开发容器的详细信息,请参阅“将开发容器配置添加到存储库”。

使用 GitHub Codespaces 启动作业

当学生打开作业时,存储库的自述文件包括其教师建议的 IDE,他们应该使用该 IDE 来完成工作。

学生可以通过单击自述文件中的“GitHub Codespace”按钮或作业存储库主页上的“代码”按钮,然后选择 “Codespaces”选项卡来启动新的或现有的代码空间。从 “Codespaces”选项卡中,可以选择现有代码空间或创建新的代码空间。 请参阅“为代码库创建代码空间”。

分配存储库的屏幕截图。 用于启动新代码空间的“代码”下拉菜单已展开。

教师可以在作业概述页中查看每个学生的作业 codespace。 可以单击每个学生行右侧的 Codespaces 图标以启动 codespace。

任务概述的屏幕截图。 Codespaces 图标以深橙色框出。

通过浏览器连接到 codespace 时,会自动启用自动保存。 如果要将更改保存到存储库,则需要提交更改并将其推送到远程分支。 如果默认情况下允许 codespace 在没有互动的情况下运行 30 分钟,codespace 将超时并停止运行。 将保留上次更改以来的数据。 有关 codespace 生命周期的详细信息,请参阅“了解代码空间的生命周期”。