| name | ArgocdImageUpdater |
| description | Manage ArgoCD Image Updater configuration, drift resolution, and ImageUpdater CRDs. USE WHEN argocd image updater, image update drift, ImageUpdater CRD, extraObjects helm, environment-scoped image updates, argocd-image-updater troubleshooting. |
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-updater v1.1.1 (app v1.1.0) from argo-helm
- CRD API:
argocd-image-updater.argoproj.io/v1alpha1 kind ImageUpdater
- Custom resources via Helm: Use
extraObjects values 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
ImageUpdater CRs with namePattern (e.g., dev-*, hlg-*, prd-*)
- Drift resolution: Bring manually-applied resources under GitOps via
extraObjects in Helm values
- ServerSideApply: Enables ArgoCD to adopt existing resources without conflicts
- Registry auth:
pullsecret:namespace/secret-name format for ACR credentials
Full documentation: See context files in this skill directory.
