Week 11 作业记录：Docker 进阶与 GitHub Pages 网页部署

1. 学习目标

• 进一步理解 Docker 镜像、容器、端口映射和环境保存。
• 将课程作业整理成 GitHub Pages 网页。
• 检查网页中的图片路径和目录链接，保证评分系统可以正常访问。

2. Docker 进阶理解

Docker 的核心对象：

• Image：镜像，是环境模板。
• Container：容器，是镜像运行后的实例。
• Port mapping：端口映射，让宿主机访问容器服务。
• Commit：把当前容器状态保存成新的镜像。

常用命令：

docker ps
docker images
docker stop <container_id>
docker commit <container_id> ai-robot-ros2:week11

3. GitHub Pages 部署流程

3.1 整理首页

首页 README.md 中加入每周目录，确保链接可以跳转到对应 week*/README.md。

3.2 检查图片路径

每周 README 中使用相对路径，例如：

![Docker 运行截图](../img/week11/docker_image.png)

这样 GitHub 和 GitHub Pages 都可以正确显示图片。

3.3 Pages 发布

在 GitHub 仓库设置中开启 Pages，选择主分支作为发布来源。发布成功后，可以通过网页访问作业。

4. 实验结果

Docker 与 GitHub Pages 相关截图如下：

5. 核心理解

• Docker 解决“环境能不能复现”的问题。
• GitHub Pages 解决“作业能不能被稳定访问”的问题。
• 自动评分系统会检查仓库可访问性、页面内容、图片加载和每周作业完整度，所以目录和路径非常重要。

6. 问题与解决

• 图片不显示：优先检查文件是否已提交、大小写是否一致、路径是否正确。
• Pages 更新慢：等待 GitHub Pages 重新构建，或检查 _config.yml。
• 容器环境丢失：使用 docker commit 或 Dockerfile 记录环境。

7. 本周总结

本周把 Docker 环境管理和 GitHub Pages 展示连接起来，完成了课程作业从本地实验到在线展示的闭环。