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/05-04-gitlab-cicd/README.md

@@ -0,0 +1,10 @@
+# GitLab CI 示例（与 docs 对照）
+
+| 文件 | 文档 |
+|------|------|
+| `gitlab-ci-minimal.example.yml` | `docs/05-04-k3s-配置gitlab-cicd.md` |
+| `gitlab-ci-multi-arch-deploy.example.yml` | `docs/05-04-k3s-配置gitlab-cicd.md` |
+| `../05-03-gitlab-runner/gitlab-ci-runner-tags.example.yml` | `docs/05-03-k3s-安装gitlab-含runner.md` |
+
+复制为 `.gitlab-ci.yml` 或 `include` 引用；变量与 Runner 以文档为准。
+

ansible/files/05-04-gitlab-cicd/gitlab-ci-minimal.example.yml

@@ -0,0 +1,21 @@
+# docs/05-04-k3s-配置gitlab-cicd.md — 最小 .gitlab-ci.yml 示例
+stages: # CI 阶段定义（按顺序执行）
+  - lint # 代码/清单检查阶段
+  - deploy # 部署阶段
+
+variables: # 全局变量
+  KUBECONFIG: "/builds/${CI_PROJECT_PATH}/kubeconfig" # Runner 内 kubeconfig 输出路径
+
+lint: # 任务名：lint
+  stage: lint # 归属 lint 阶段
+  script: # 执行脚本
+    - yamllint manifests || true # 允许 lint 失败不中断（示例用途）
+
+deploy: # 任务名：deploy
+  stage: deploy # 归属 deploy 阶段
+  script: # 执行脚本
+    - echo "$KUBE_CONFIG_CONTENT" > "$KUBECONFIG" # 将 CI 变量写入 kubeconfig 文件
+    - kubectl --kubeconfig="$KUBECONFIG" apply -f manifests/ # 应用 manifests
+  only: # 触发条件（旧语法）
+    - main # 仅 main 分支触发
+

ansible/files/05-04-gitlab-cicd/gitlab-ci-multi-arch-deploy.example.yml

@@ -0,0 +1,15 @@
+# docs/05-04-k3s-配置gitlab-cicd.md — 多架构 Runner tags 示例
+deploy_x86: # 任务名：x86 架构部署
+  stage: deploy # 所属阶段
+  tags: [x86] # 仅匹配带 x86 tag 的 Runner
+  script: # 执行脚本
+    - echo "$KUBE_CONFIG_CONTENT" > "$KUBECONFIG" # 写入 kubeconfig
+    - kubectl --kubeconfig="$KUBECONFIG" apply -f manifests/x86/ # 部署 x86 清单
+
+deploy_arm64: # 任务名：arm64 架构部署
+  stage: deploy # 所属阶段
+  tags: [arm64] # 仅匹配带 arm64 tag 的 Runner
+  script: # 执行脚本
+    - echo "$KUBE_CONFIG_CONTENT" > "$KUBECONFIG" # 写入 kubeconfig
+    - kubectl --kubeconfig="$KUBECONFIG" apply -f manifests/arm64/ # 部署 arm64 清单
+