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

ansible/files/03-02-traefik-acme/traefik-acme.yaml

@@ -0,0 +1,41 @@
+# 03-02 Traefik ACME 配置（HelmChartConfig）
+# 含：ACME（Cloudflare DNS-01）、ping 健康检查（websecure）、PROXY protocol trustedIPs
+# 使用前：替换 <YOUR_REAL_EMAIL>，创建 cloudflare-api-token Secret，按实际修改 nodeSelector/trustedIPs
+# 部署：kubectl apply -f traefik-acme.yaml（或复制到 K3s manifests 目录）
+#
+# 推荐（Dashboard + ACME + local-path 一份清单）：见 ../traefik-dashboard-acme/traefik-dashboard-acme.yaml
+---
+apiVersion: helm.cattle.io/v1 # HelmChartConfig 所在的 API 版本
+kind: HelmChartConfig # HelmChartConfig：给 K3s 自带 Helm chart 注入 values 的资源
+metadata: # 该对象的标识信息
+  name: traefik # chart 对应的对象名称（通常与 Traefik chart name 一致）
+  namespace: kube-system # HelmChartConfig 的命名空间（Traefik 默认在 kube-system）
+spec: # chart 注入配置的具体内容
+  valuesContent: |- # 以“字符串形式的 YAML”注入到 Helm chart values（由 chart 解析）
+    additionalArguments: # 追加给 Traefik 的额外启动参数列表
+      - "--log.level=INFO" # 日志级别：INFO
+      - "--certificatesresolvers.cloudflare.acme.dnschallenge.resolvers=1.1.1.1:53,1.0.0.1:53" # DNS resolver 列表
+      - "--certificatesresolvers.cloudflare.acme.email=<YOUR_REAL_EMAIL>" # ACME 注册邮箱
+      - "--certificatesresolvers.cloudflare.acme.storage=/data/acme.json" # ACME 存储（容器内路径）
+      # - "--certificatesresolvers.cloudflare.acme.caserver=https://acme-staging-v02.api.letsencrypt.org/directory"  # 测试用，上线前删除
+      - "--certificatesresolvers.cloudflare.acme.dnschallenge.provider=cloudflare" # 使用 Cloudflare 作为 DNS-01 provider
+      - "--certificatesresolvers.cloudflare.acme.dnschallenge.propagation.delayBeforeChecks=600" # DNS propagation 等待时间（秒）
+
+      # 健康检查：GET /ping 在 443(HTTPS) 返回 200，供 HAProxy 对 443 做 option httpchk + ssl
+      - "--ping=true" # 开启 ping healthcheck
+      - "--ping.entryPoint=websecure" # ping 走 websecure(HTTPS) entrypoint
+
+      # PROXY protocol：trustedIPs 需包含 HAProxy 所在 IP/网段
+      - "--entrypoints.web.proxyProtocol.trustedIPs=192.168.2.0/24" # HTTP entrypoint 信任的代理网段
+      - "--entrypoints.websecure.proxyProtocol.trustedIPs=192.168.2.0/24" # HTTPS entrypoint 信任的代理网段
+
+    env: # 环境变量注入（给 Traefik chart）
+      - name: CF_DNS_API_TOKEN # Cloudflare API Token 环境变量名
+        valueFrom: # 从 Secret 中读取环境变量值
+          secretKeyRef: # Secret 引用方式：按 key 取值
+            name: cloudflare-api-token # Secret 名称（你创建的 Cloudflare Token Secret）
+            key: api-token # Secret 内对应的 key 名
+
+    nodeSelector: # 把 Traefik Pod 固定到指定节点（配合 RWO 本地存储更安全）
+      kubernetes.io/hostname: ylc61 # 固定节点主机名（按你的实际节点修改）
+