fenago/git

fenago/git Docker镜像文档

镜像概述

fenago/git是一个专为Git课程设计的Docker镜像，基于JupyterLab构建，提供了完整的Git学习环境。该镜像包含一系列预设的实践实验室，学习者可通过浏览器访问JupyterLab界面，直接进行Git命令操作和场景练习，无需本地配置开发环境。

核心功能与特性

• 集成JupyterLab：提供交互式Web界面，支持代码编辑、终端操作和文件管理
• 13个实践实验室：覆盖Git核心操作场景，包括提交文件、远程协作、撤销更改、分支合并等
• sudo权限支持：通过环境变量配置可获取管理员权限，满足特殊操作需求
• 多实例运行：支持同时启动多个容器实例，通过修改端口和容器名实现隔离

使用场景

• Git初学者学习和实践Git基本命令
• 开发人员巩固Git高级操作（如分支管理、历史修改、错误恢复等）
• 培训环境中提供统一的Git实践平台，确保所有学员环境一致性

使用方法

基本运行命令

通过以下命令启动Git课程环境容器：

bash
docker run -d --user root -p 8888:8888 --name git -e GRANT_SUDO=yes -e JUPYTER_ENABLE_LAB=yes docker.xuanyuan.run/fenago/git start-notebook.sh

参数说明：

• -d：后台运行容器
• --user root：以root用户运行
• -p 8888:8888：端口映射（主机端口:容器端口）
• --name git：容器名称
• -e GRANT_SUDO=yes：允许sudo权限
• -e JUPYTER_ENABLE_LAB=yes：启用JupyterLab界面
• start-notebook.sh：启动JupyterLab的脚本

多实例运行

如需同时运行多个实例，修改容器名称和主机端口即可：

bash
docker run -d --user root -p 8889:8888 --name git-lab2 -e GRANT_SUDO=yes -e JUPYTER_ENABLE_LAB=yes docker.xuanyuan.run/fenago/git start-notebook.sh

提交与推送更改

若对镜像内容进行了修改，可通过以下命令保存并推送更改：

bash
# 提交容器更改到镜像
docker commit git fenago/git

# 推送镜像到仓库
docker push fenago/git

实验室访问

容器启动后，通过浏览器访问以下地址即可进入对应实验室（将<host-ip>替换为运行容器的主机IP，<port>替换为映射的主机端口）：

1. 提交文件
   <host-ip>:<port>/lab/workspaces/lab1

2. 提交更改
   <host-ip>:<port>/lab/workspaces/lab2

3. 远程工作
   <host-ip>:<port>/lab/workspaces/lab3

4. 撤销更改
   <host-ip>:<port>/lab/workspaces/lab4

5. 查找错误
   <host-ip>:<port>/lab/workspaces/lab5

6. 重写历史
   <host-ip>:<port>/lab/workspaces/lab6

7. 分支、合并及选项
   <host-ip>:<port>/lab/workspaces/lab7

8. 在仓库中存储附加信息
   <host-ip>:<port>/lab/workspaces/lab8

9. 从仓库提取数据
   <host-ip>:<port>/lab/workspaces/lab9

10. 从错误中恢复
    <host-ip>:<port>/lab/workspaces/lab10

11. 补丁与离线共享（第一部分）
    <host-ip>:<port>/lab/workspaces/lab11

12. 补丁与离线共享（第二部分）
    <host-ip>:<port>/lab/workspaces/lab12

13. GitHub入门
    <host-ip>:<port>/lab/workspaces/lab13