Argocd

Helm 是什么 Helm 是 Kubernetes 的包管理器，地位类似 Linux 上的 pacman / apt。apt 安装的单位是 deb 包，Helm 安装的单位是 chart。 # archlinux pacman -S helm # macOS brew install helm # curl curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 chmod 700 get_helm.sh ./get_helm.sh Chart 解决什么问题 在 K8s 里部署一个应用，需要的远不止一个镜像。以 Kong（API 网关 + Ingress Controller）为例，一次部署要创建这些资源： Deployment：跑 Kong 网关和 Ingress Controller 两个容器 Service：proxy、admin、webhook 等多个 ServiceAccount、ClusterRole、ClusterRoleBinding：Controller 要读集群里的 Ingress ValidatingWebhookConfiguration：校验用户提交的 Kong 资源 Secret：webhook 用的 TLS 证书 CRD：KongPlugin、KongConsumer 等自定义资源 手写这些 YAML 有几个问题： ...

这篇文档讲什么 Homelab 里跑 enx-api 时，从本机一条 Taskfile 命令到 Pod 滚动更新，中间经过 Tekton 构建镜像、Nexus 存镜像、GitOps 改 manifest、Argo CD 同步集群。本文按实际配置把这条链路拆开说明。 Tekton、Kaniko、Argo CD 各自的概念见 Tekton 与 Kaniko 和 Argo CD 与 GitOps 持续部署；这里只写 enx-api 这条线的落地细节。 涉及的两个仓库 仓库 作用 enx 应用源码、enx-api/Containerfile、根目录 Taskfile w10n-config（私有仓库） K8s manifest、Tekton Pipeline/PipelineRun、Argo CD Application CI 在集群里 clone 的是 GitHub 上的 enx，不是本机工作区；CD 改的是 GitHub 上的 w10n-config（私有仓库，不对外公开），再由 Argo CD 拉到集群。文中出现的 manifest、Pipeline 路径均指该仓库内的 infra/homelab/k8s/ 目录。 整体流程 flowchart LR A[本机 task tekton:build:api] --> B[创建 PipelineRun] B --> C[git-clone-ssh拉 enx 源码] C --> D[kaniko-build构建并推送镜像] D --> E[update-gitops-repo改 deployment.yaml] E --> F[Argo CD 自动 sync] F --> G[enx namespace Pod 更新] 一次完整发布可以概括成四步： ...

什么是 Argo CD Argo CD 是 CNCF 毕业项目，专为 Kubernetes 设计的 GitOps 持续部署（CD） 控制器。它以 Git 仓库中的 manifest（YAML、Kustomize、Helm 等）为唯一期望状态，持续对比集群里的实际资源，并在偏差时执行同步。 与 Tekton、GitHub Actions 等 CI 工具的分工常见如下： 阶段 典型工具 做什么 构建 Tekton、CI 编译代码、打镜像、推 registry 部署 Argo CD 根据 Git 里的镜像 tag / manifest 更新集群 在 homelab 里，配置仓库是 w10n-config：改 homelab/k8s/ 下的 YAML 并 push，由 Argo CD 把变更落到集群；镜像版本往往由 Tekton Pipeline 改 Git 里的 deployment 镜像字段，再交给 Argo 滚动发布。 GitOps 在说什么 传统做法常是 kubectl apply 或 Helm 从本机直接改集群，容易出现「集群里到底是什么版本」与 Git 不一致的问题。 ...

背景 在 homelab 里用 Argo CD 管理 QuantDinger（application-quantdinger.yaml，automated + selfHeal）。把 MiniMax 相关配置 push 到 w10n-config 后，集群里的 ConfigMap 一度还是旧内容：Argo 显示 Synced，但 revision 仍停在旧 commit。 当时本机没有安装 argocd CLI，于是先用 kubectl annotate 触发 hard refresh，又用 kubectl apply -k 把 manifest 直接打进集群。事后整理一下两种「触发 Argo」方式的区别，避免下次混淆。 两种方式分别做什么 argocd CLI Argo CD 官方命令行，通过 Argo API Server 操作 Application，语义最完整。 常见用途： argocd app get quantdinger：查看同步状态、health、当前 revision argocd app sync quantdinger：主动执行一次 Sync，把 Git 目标 revision 应用到集群 argocd app diff quantdinger：对比 Git 与集群 live 状态 argocd app rollback quantdinger：回滚到历史 revision sync 会走 Argo 的完整同步流水线（diff、apply、health 等待、hook 等），并在 Argo UI / Application 状态里留下明确的 operation 记录。 ...