基本框架

docs/03-01-k3s-traefik-dashboard.md

@@ -0,0 +1,93 @@
+# 03-02-k3s Traefik Dashboard
+
+> 启用并访问 Traefik Dashboard，用于查看路由与服务状态。
+
+## 前置条件
+
+- Traefik 已正常运行
+- 已了解 Dashboard 仅用于运维，不建议公网裸露
+
+## 部署说明（几个 Pod？配置存哪？如何同步？）
+
+- **几个 Pod**：K3s 默认 Traefik 是 **Deployment、replicas=1**，即只有 **1 个 Traefik Pod**。该 Pod 可能跑在控制节点或你打了 Traefik 入口标签的任意节点上。
+- **为何每个节点都能访问**：流量不是“每个节点一个 Traefik”。每个节点上的 80 端口由 K3s 的 **ServiceLB（svclb-traefik）** 监听，请求被转发到 **同一个** Traefik Service，再转到上述那 1 个 Traefik Pod。所以多节点能访问是 LB 转发到同一后端，不是每节点一个 Traefik。
+- **配置存在哪里**：**HelmChartConfig** 与 **IngressRoute** 是 Kubernetes 资源，存在 **etcd**（控制节点）。Traefik 进程通过 **Kubernetes API** 监听 Ingress/IngressRoute 等，动态生成路由，**不需要在多个 Pod 之间同步配置**。若以后把 Traefik 扩成多副本，所有副本都从同一 API 读到的资源，行为一致。
+
+## 操作步骤
+
+1. 在控制节点创建 `traefik-dashboard.yaml`，放入 K3s manifests 目录（K3s 启动时自动加载，重启后无需手动 apply）：
+
+   - **默认路径**：`/var/lib/rancher/k3s/server/manifests/traefik-dashboard.yaml`
+   - **自定义 data-dir**（如 `--data-dir=/storage`）：`<data-dir>/server/manifests/traefik-dashboard.yaml`
+
+   **唯一真源（勿与文档内联重复）**：[HelmChartConfig + IngressRoute 完整 YAML](../../ansible/files/traefik-dashboard/traefik-dashboard.yaml)。复制到上述 manifests 路径，或在仓库根执行：
+
+   ```bash
+   kubectl apply -f ansible/files/traefik-dashboard/traefik-dashboard.yaml
+   ```
+
+2. 应用配置并等待 Traefik 重载（按实际路径选择其一复制执行）：
+
+```bash
+# 默认路径
+kubectl apply -f /var/lib/rancher/k3s/server/manifests/traefik-dashboard.yaml
+kubectl -n kube-system rollout status deploy/traefik
+```
+
+```bash
+# 自定义 data-dir（如 /storage）
+kubectl apply -f /storage/server/manifests/traefik-dashboard.yaml
+kubectl -n kube-system rollout status deploy/traefik
+```
+
+3. 验证：一键对全部节点 IP 做 curl 测试（按实际环境修改 IP 列表）：
+
+```bash
+# 已按 01-02 / 01-07 配置 K3s 默认 LB（Traefik 入口标签 + firewalld 基线），61~64 任一台 :80 均应返回 200/307
+for ip in 192.168.2.61 192.168.2.62 192.168.2.63 192.168.2.64; do
+  code=$(curl -s -o /dev/null -w "%{http_code}" --max-time 3 "http://${ip}/dashboard/" 2>/dev/null || echo "---")
+  echo "${ip}: ${code}"
+done
+```
+
+查看 Traefik 日志（确认无报错）：
+
+```bash
+kubectl -n kube-system logs deploy/traefik --tail=50
+```
+
+可选：只看响应头（单节点）  
+`curl -I --max-time 5 http://192.168.2.61/dashboard/`
+
+## 删除部署与文件
+
+因同一 chart 只能有一份 HelmChartConfig，后续做 03-03（ACME）、03-04（Dashboard+ACME 合并）等测试前，建议先删除本部署并删掉 manifest 文件，避免被覆盖或重复加载。
+
+1. **删除集群内资源**（HelmChartConfig + IngressRoute）：
+
+```bash
+kubectl delete -f /var/lib/rancher/k3s/server/manifests/traefik-dashboard.yaml
+kubectl -n kube-system rollout status deploy/traefik
+```
+
+```bash
+kubectl delete -f /storage/server/manifests/traefik-dashboard.yaml
+kubectl -n kube-system rollout status deploy/traefik
+```
+
+2. **删除宿主机上的 manifest 文件**（否则 K3s 重启会再次加载）：
+
+```bash
+# 默认路径
+sudo rm -f /var/lib/rancher/k3s/server/manifests/traefik-dashboard.yaml
+```
+
+```bash
+# 自定义 data-dir（如 /storage）
+sudo rm -f /storage/server/manifests/traefik-dashboard.yaml
+```
+
+## 下一步
+
+- `04-03-k3s-nginx-demo.md`
+- `04-01-k3s-nodejs-高级部署.md`