实训 18 配套文件

包含本课的起始文件、Word 报告模板和验收脚本。解压后请保留原目录结构。

下载 ZIP

1. 任务情境

你要交付一个由 Web 和 API 组成的课程项目。项目必须只绑定 ECS 回环端口，通过 SSH 隧道供浏览器访问；部署后要运行自动验收。随后生成带 SHA-256 的站点备份，分别处理页面内容漂移和 API 中断，完成同路回归，最后只清理本课资源。

2. 环境和安全边界

项目	课堂要求
控制端	Windows 11 + WSL；教师演示可使用本地控制端
运行端	本人 ECS 或教师授权的云主机 B
远端目录	/opt/xpk-course-demos/lesson-18
Compose 项目	cloud-course-lab-18
课程端口	127.0.0.1:18018
服务	api、web
数据范围	data/site/ 与 backup/
禁止范围	业务容器、8000/18443、全局 Docker 清理、防火墙、安全组和公网开放

本实训只允许注入项目自带的两种可恢复故障。不要停止未知服务，不要删除其他目录，不要创建付费资源。

3. 准备个人目录

[WSL] mkdir -p "$HOME/cloud-course/lab-18"

创建本课个人目录。

[WSL] cp -R starter/. "$HOME/cloud-course/lab-18/"

复制教师提供的起始文件。

[WSL] cd "$HOME/cloud-course/lab-18"

进入工作目录。后续本地命令都从这里执行。

[WSL] find . -maxdepth 3 -type f -print | sort

核对 Compose、页面、API 数据、Nginx 配置和七个脚本是否齐全。

[WSL] bash -n ./*.sh

检查脚本语法。没有输出且退出码为 0 表示语法可解析。

4. 远端只读预检

[WSL] ssh B 'nproc; free -h; df -h /'

读取 CPU、内存和根文件系统。将 B 换成教师分配的 SSH 别名；不要在报告中写完整公网地址。

[WSL] ssh B 'docker ps --format "{{.Names}} {{.Ports}}"'

记录已有容器与端口。只观察，不停止。

[WSL] ssh B "ss -lnt 'sport = :18018'"

确认 18018 尚未监听。若被占用，停止实训并向教师报告，不自行更换到未知业务端口。

[WSL] ssh B 'test ! -e /opt/xpk-course-demos/lesson-18'

确认课程目录不存在。若目录已存在，先判断是否为本人上次未清理的实验，不覆盖未知文件。

5. 上传课程包

[WSL] ssh B 'mkdir -p /opt/xpk-course-demos/lesson-18'

只创建本课远端目录。

[WSL] rsync -a ./ B:/opt/xpk-course-demos/lesson-18/

上传当前目录内容。不要使用指向 /opt 或其他上级目录的 --delete。

[WSL] ssh B 'cd /opt/xpk-course-demos/lesson-18 && cp .env.example .env'

从示例生成远端 .env。实际 .env 不上传智慧职教。

[WSL] ssh B 'cd /opt/xpk-course-demos/lesson-18 && chmod 0755 ./*.sh'

只为本课脚本增加执行权限。

6. 检查最终 Compose 模型

[ECS] cd /opt/xpk-course-demos/lesson-18

进入项目目录，后续 [ECS] 命令都在这里执行。

[ECS] docker compose --env-file .env config --services

预期只列出 api 和 web。

[ECS] docker compose --env-file .env config --images

预期两个服务都使用课程固定的 nginx:1.27-alpine。

[ECS] docker compose --env-file .env config |
  sed -n '/web:/,/healthcheck:/p'

检查 Web 的 depends_on、只读挂载和 127.0.0.1:18018。截图时不要包含与课程无关的环境变量。

7. 部署和自动验收

[ECS] bash deploy.sh

脚本检查配置，后台启动服务并等待 healthy，然后调用 verify.sh。预期全部 [PASS]。

[ECS] docker compose --env-file .env ps

预期 API 与 Web 均为 healthy，只有 Web 发布回环端口。

[ECS] ss -lnt 'sport = :18018'

预期监听为 127.0.0.1:18018。

[ECS] curl -fsS http://127.0.0.1:18018/api/status.json

预期包含 status=ok、service=lesson18-api 和 release=lesson18-v1。

截图 1 应同时包含 compose ps、回环监听和 verify.sh 关键结果。

8. 通过 SSH 隧道访问主页

在 WSL 另开一个终端：

[WSL] ssh -N -L 11818:127.0.0.1:18018 B

保持终端运行，把 Windows 浏览器访问 127.0.0.1:11818 的流量转发到 ECS 回环入口。

在 Windows 浏览器打开：

http://127.0.0.1:11818/

预期看到“综合项目运行概况”、API ready、lesson18-v1 和 lesson18-project-ok。截图 2 保存完整可见页面，不显示公网地址或 SSH 配置。

9. 建立带校验和的备份

[ECS] bash backup.sh

生成时间戳归档和 .sha256 文件。记录脚本输出的实际文件名。

[ECS] ls -lh backup/

检查归档和校验文件都存在，记录大小。

[ECS] tar -tzf backup/lesson18-site-实际时间戳.tar.gz

检查归档内部只含 site/ 和页面文件。

[ECS] cd backup
[ECS] sha256sum -c lesson18-site-实际时间戳.tar.gz.sha256
[ECS] cd ..

校验文件保存的是归档的相对文件名，所以要在 backup/ 中执行。预期返回 OK。截图 3 包含归档名、内容清单和校验结果。

10. 页面内容漂移与恢复

[ECS] bash inject-fault.sh

只替换课程页面；容器继续运行。

[ECS] bash verify.sh

预期退出码非 0，主页内容检查失败，API 和容器检查仍可能通过。保留原始失败，不修改验收脚本绕过门禁。

[ECS] bash restore.sh \
  backup/lesson18-site-实际时间戳.tar.gz

恢复脚本验证校验和、归档路径和健康标记后安装页面，并自动重跑验收。预期全部通过。

截图 4 要把“故障时失败”和“恢复后通过”放在一起。

若恢复失败：

• No such file：先用 ls backup/ 核对实际文件名；
• 校验失败：停止恢复，保留归档，不重新生成校验和掩盖问题；
• 越界路径：归档不符合课程边界，不继续解包；
• 缺少健康契约：归档不是已验证基线，选择正确备份；
• 页面恢复但 API 失败：按下一节检查独立依赖。

11. API 中断与日志定位

[ECS] docker compose --env-file .env stop api

只停止本课 API。

[ECS] curl --max-time 8 -sS -o /dev/null \
  -w 'http=%{http_code}\n' \
  http://127.0.0.1:18018/api/status.json

预期状态码为 504。若结果不同，保留实际输出再看日志，不为了匹配答案改配置。

[ECS] docker compose --env-file .env \
  logs --since 30s --tail 10 web

预期看到连接上游超时和 /api/status.json 请求。

[ECS] bash verify.sh

预期 API 容器和 API 内容检查失败，退出码非 0。

[ECS] docker compose --env-file .env start api

只启动 API。

[ECS] docker compose --env-file .env ps

等待 API 状态变为 healthy。若仍 starting，数秒后再观察；若 unhealthy，使用 docker inspect 和 API 日志定位。

[ECS] bash verify.sh

沿相同用户路径完成回归。预期全部通过。

截图 5 包含 504、上游日志、恢复后的 healthy 和验收通过。

12. 最终项目验收

[ECS] bash verify.sh

最终自动检查必须通过。

人工检查表：

检查	预期
项目文件	部署、验证、备份、恢复、清理齐全
配置	只含 api/web，Web 等待 API healthy
容器	api/web healthy
入口	只绑定 127.0.0.1:18018
主页	标题与 lesson18-project-ok
API	status=ok、lesson18-v1
备份	归档、SHA-256、内容清单
故障	页面漂移与 API 中断都有原始证据
恢复	使用同一 verify.sh 通过

13. 清理

先关闭 WSL 中的 SSH 隧道，按 Ctrl+C 结束。

[ECS] bash cleanup.sh

删除本课 Compose 容器与默认网络，检查 18018 释放。

[ECS] docker ps -a \
  --filter label=com.docker.compose.project=cloud-course-lab-18

预期没有输出。

[ECS] ss -lnt 'sport = :18018'

预期没有监听。

[ECS] ss -lnt | grep -E ':(8000|18443) '

只读复核教师指定的既有业务端口保持原状态。学生自己的服务器若没有这些端口，应按本人基线核对，不照抄教师结果。

[ECS] cd /opt/xpk-course-demos

离开课程目录，避免删除当前工作目录。

[ECS] rm -rf -- /opt/xpk-course-demos/lesson-18

只有在确认路径完全一致、报告证据已保存、容器已清理后，才删除本课远端目录。不要用变量、通配符或上级目录替代这个精确路径。

14. 自动脚本的限制

verify.sh 能检查：

• .env 和 Compose 配置；
• api/web 服务声明；
• 回环端口绑定；
• 两个容器健康；
• 主页标题和健康契约；
• API 状态和发布版本。

它不能证明：

• SSH 隧道与 Windows 浏览器长期可用；
• 备份覆盖数据库或整机；
• 所有故障都能自动恢复；
• 公网、安全组、费用和长期监控正确；
• 截图与报告真实、完整且不泄密；
• 最终清理没有影响任何未登记业务。

15. 报告与提交

填写：

班级_学号_姓名_第18次课_综合运维项目报告.docx

只上传一个 Word 到智慧职教“第18次课”。每张截图旁边填写环境、命令、关键结果、证明范围和限制。

不要提交：

• .env、SSH 配置、私钥、密码、验证码；
• 公网地址、云账号、资源 ID、订单、余额；
• 原始未脱敏截图、完整容器 ID、完整日志；
• 实际备份归档、其他业务文件、远端课程目录；
• 项目 node_modules、镜像或虚拟环境。

16. 评分证据

维度	分值	达标证据
边界与预检	10	目录、项目、端口、已有业务基线
配置理解	15	依赖、健康、回环、只读挂载
部署与访问	15	healthy、verify、真实主页
备份与校验	15	归档、内容、SHA-256
页面恢复	15	漂移失败、受控恢复、同路回归
API 故障	15	504、日志、最小恢复
清理与业务保护	10	本课资源为 0、端口释放、业务保留
报告质量	5	图文相邻、证明范围准确、无敏感信息

贡献者: Gabrlie

上一页实训 17：Ansible 幂等部署与健康检查

下一页实验安全与费用策略