feat: 按 doc_id 重组 ansible/files 与验证框架

- ansible/files 改为与文档 XX-YY 对齐的目录结构,更新相关 playbook 路径
- 新增 scripts/verify.sh 与 ansible/playbooks/verify/*.yml,移除单体 verify-matrix.yml
- 补充 docs/00-02 矩阵状态、00-05 验证框架与流程、00-04 环境与 ylc65 工作机说明
- 增加 k3s 存储准备、Longhorn、local-path 等 playbook 与辅助脚本

Made-with: Cursor
This commit is contained in:
2026-03-26 07:01:14 +08:00
parent a67788de56
commit 8c43761962
192 changed files with 4006 additions and 320 deletions

View File

@@ -0,0 +1,37 @@
# 05-09-openclaw-web 小游戏网页平台
> 在 K3s 中部署一个简单的 OpenClaw Web 前端(示例 Deployment/Service/Ingress用于演示“静态站点/前端应用通过 Traefik 暴露”这一类场景。
## 前置条件
- 已完成基础集群安装:`01-01``01-02`
- Traefik 入口可用(参考 `03-01-k3s-traefik-dashboard.md`
- 你已准备好可拉取的前端镜像(示例使用 `ghcr.io/your/openclaw-web:latest`,请按环境替换)
## 清单路径(唯一真源)
| 项 | 路径 |
|----|------|
| 本篇清单 | [`ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml`](../ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml) |
| 应用 | `kubectl apply -f ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml` |
| 删除 | `kubectl delete -f ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml` |
## 部署与验证
```bash
kubectl apply -f ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml
kubectl get deploy,svc,ing -n default | grep -i openclaw-web
curl -I --max-time 5 http://openclaw.example.com/
```
预期:
- `openclaw-web` Deployment 处于 `Available`
- Ingress 生效后,通过域名可访问到前端(`200` 或静态站点常见的重定向均可接受)
## 失败排查
- **404**:域名/Host 未解析到集群入口 IP或 Ingress `host` 不一致。
- **502**Service 无 EndpointsPod 未 Ready 或 selector 不匹配)。
- **ImagePullBackOff**:镜像仓库不可达或未配置鉴权。