# 05-09-openclaw-web 小游戏网页平台

> 在 K3s 中部署一个简单的 OpenClaw Web 前端（示例 Deployment/Service/Ingress），用于演示“静态站点/前端应用通过 Traefik 暴露”这一类场景。


## TL;DR

- **自动化验收**：`./scripts/verify.sh run 05-09`
- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
- **成功判据**：达到本文「预期」且 playbook 断言通过
- **排障**：见本文「排障」

## 前置条件

- 已完成基础集群安装：`01-01`、`01-02`
- Traefik 入口可用（参考 `03-01-k3s-traefik-dashboard.md`）
- 你已准备好可拉取的前端镜像（示例使用 `ghcr.io/your/openclaw-web:latest`，请按环境替换）

## 清单路径（唯一真源）

| 项 | 路径 |
|----|------|
| 本篇清单 | [`ansible/files/05-09/openclaw-web.yml`](../ansible/files/05-09/openclaw-web.yml) |
| 应用 | `kubectl apply -f ansible/files/05-09/openclaw-web.yml` |
| 删除 | `kubectl delete -f ansible/files/05-09/openclaw-web.yml` |

## 部署与验证

```bash
kubectl apply -f ansible/files/05-09/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 无 Endpoints（Pod 未 Ready 或 selector 不匹配）。
- **ImagePullBackOff**：镜像仓库不可达或未配置鉴权。

## 排障

- **先看 playbook 输出**：失败时先定位是 deploy/wait/http_check 哪一步。
- **集群侧总览**：`kubectl get nodes -o wide`、`kubectl -n kube-system get pods -o wide`。
- **事件与日志**：`kubectl -n <ns> describe ...`、`kubectl -n <ns> logs ... --tail=200`。