ArgoCD 不应集成进 Go 微服务，而应通过 GitOps 模式协同：Go 服务只运行，ArgoCD 同步集群状态；YAML 清单须存于 Git 明确路径（如 manifests/prod），镜像更新必须提交 Git，syncPolicy.automated 需显式启用，并确保 readinessProbe 适配健康检查。
ArgoCD 不集成进 Go 微服务里——它根本不需要、也不应该被“集成”。
Go 服务本身只负责运行，ArgoCD 负责同步集群状态。二者物理隔离、职责分明。你写的 main.go 里不用 import 任何 argocd 包，也不调它的 API。
真正要做的，是让 Go 服务的交付流程适配 ArgoCD 的 GitOps 模型：镜像构建由 CI 完成，YAML 更新必须落库，同步行为由 Application 资源定义驱动。
spec.source.path 必须精确到 YAML 目录
常见错误：Application 的 spec.source.path 写成 . 或留空，或指向 cmd/、internal/ 这类 Go 源码目录。
- 实际 Kubernetes 清单（
deployment.yaml、service.yaml）必须放在 Git 仓库中一个明确子路径下，比如manifests/prod或infra/k8s/staging -
spec.source.path值必须严格匹配该路径，且该路径下不能只有go.mod或main.go——ArgoCD会直接报Unable to get app details: failed to load manifests - 如果用
Kustomize，确保kustomization.yaml在该路径根目录，且语法合法（例如resources:下每一项都以-开头）
镜像更新必须提交到 Git，不能靠 CI 动态替换
CI 构建完镜像后，如果只是改内存里的 YAML 再 kubectl apply，就和 ArgoCD 冲突了。
- 必须把新镜像 tag 写入 Git 中的 YAML 文件，例如修改
manifests/prod/deployment.yaml里的image: ghcr.io/me/api:v1.2.3 - 推荐用 commit SHA 作 tag（如
ghcr.io/me/api:abc123），避免latest导致不可追溯 - CI 脚本需完成：修改 YAML →
git add→git commit -m "deploy: abc123"→git push；否则ArgoCD看不到变更 - 若用
fluxcd/image-automation-controller或自写 Go 工具生成并提交 YAML，也必须走完整 Git 流程
syncPolicy.automated 必须显式启用
默认情况下，ArgoCD 不自动同步——Git 推了新 commit，UI 只显示 OutOfSync，不触发部署。
- 要在
ApplicationCR 中设置syncPolicy.automated，否则每次上线都要手动点 Sync - 建议同时启用
autoPrune: true和selfHeal: true，防止资源被误删或配置被手动篡改后长期漂移 - 私有仓库需提前用
argocd repo add注册，并验证 SSH key 或 PAT 可访问；否则同步失败日志只显示模糊的Failed to fetch repo -
spec.source.targetRevision推荐写死为 tag（如v1.2.0），而非HEAD，避免非预期变更流入生产
Go 服务健康检查要适配 ArgoCD 的探测逻辑
ArgoCD 默认用 Deployment 的 status.replicas 和 status.readyReplicas 判断健康，但前提是你的 Go 服务得通过 readinessProbe 正确上报就绪状态。
立即学习“go语言免费学习笔记（深入）”；
- 如果 Go 服务启动慢（比如连 DB、加载配置耗时长），可能触发
readinessProbe超时，导致ArgoCD一直卡在Progressing状态 - 不要依赖自定义
health.lua脚本，除非你清楚每行含义；优先用内置健康检测逻辑 -
readinessProbe的initialDelaySeconds和timeoutSeconds必须大于服务冷启动时间，否则滚动更新会失败 - 可通过
kubectl get app -n argocd <app-name> -o yaml查看status.health.status字段确认当前健康评估结果
ArgoCD 同步的是声明，不是代码；它拉的是 Git，不是 Go 编译器。最容易被忽略的一点是：**所有变更必须可 git revert**——包括镜像 tag、副本数、环境变量。一旦跳过 Git 提交直接操作集群，GitOps 就失效了。 
