# ArgocdImageUpdater

> 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.

- Skill: `levalencia/argocdimageupdater` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add levalencia/argocdimageupdater`
- Raw SKILL.md: https://api.skillmd.com/api/skills/levalencia/argocdimageupdater/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: levalencia (https://skillmd.com/u/levalencia)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/levalencia/argocdimageupdater

---


# 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.