ArgoCD Image Updater
Operational skill for configuring and troubleshooting ArgoCD Image Updater in multi-cluster GitOps environments. Covers Helm chart configuration, ImageUpdater CRD management, drift resolution, and environment-scoped update patterns.
Workflow Routing
| Workflow | Trigger | File |
|----------|---------|------|
| ResolveDrift | "fix drift", "resolve drift", "orphaned resources" | Workflows/ResolveDrift.md |
| ConfigureImageUpdater | "configure image updater", "setup image updates" | Workflows/ConfigureImageUpdater.md |
| CreateImageUpdaterCrds | "create ImageUpdater CRD", "scope image updates" | Workflows/CreateImageUpdaterCrds.md |
Quick Reference
- Chart:
argocd-image-updaterv1.1.1 (app v1.1.0) fromargo-helm - CRD API:
argocd-image-updater.argoproj.io/v1alpha1kindImageUpdater - Custom resources via Helm: Use
extraObjectsvalues key - Config format: Flat dotted keys (e.g.,
config.log.level), NOT nested maps - Metrics: Use
--metrics-secure=false+ port 8080 for HTTP Prometheus scraping
Key Patterns
- Environment scoping: Create per-environment
ImageUpdaterCRs withnamePattern(e.g.,dev-*,hlg-*,prd-*) - Drift resolution: Bring manually-applied resources under GitOps via
extraObjectsin Helm values - ServerSideApply: Enables ArgoCD to adopt existing resources without conflicts
- Registry auth:
pullsecret:namespace/secret-nameformat for ACR credentials
Full documentation: See context files in this skill directory.