Deploy-Laboratory/docs/05-04-k3s-配置gitlab-cicd.md

05-04-k3s 配置 GitLab CI/CD

把 manifests 与 values 纳入 GitLab 仓库，通过流水线自动部署到 K3s。

---

建议仓库结构

homelab-config/
  apps/
  charts/
  manifests/
  .gitlab-ci.yml

---

准备集群凭据

常见做法二选一：

1. KUBE_CONFIG 变量（适合快速落地）
2. ServiceAccount + RBAC（适合长期最小权限）

---

基础流水线步骤

• lint：检查 YAML/Helm 语法
• deploy：kubectl apply -f ... 或 helm upgrade --install
• verify：部署后基本健康检查

唯一真源（示例流水线）：

• 最小：ansible/files/gitlab/gitlab-ci-minimal.example.yml
• 多架构 deploy：ansible/files/gitlab/gitlab-ci-multi-arch-deploy.example.yml

复制到仓库根为 .gitlab-ci.yml（或 include 引用），并配好 Runner 与 KUBE_CONFIG_CONTENT 等变量。

---

验证

1. 提交一次最小变更（如 ConfigMap）
2. 确认 Pipeline 成功
3. 确认集群资源已更新

---

下一步

• 05-05-prometheus与grafana.md
• 06-02-运维小结.md