쿠버네티스 클러스터에 Argo CD 와 ArgoCD Image Updater 를 설치했다면 이제 Argo CD application 에 자동 배포 설정을 해야 한다. 이때 아래 그림처럼 application 에 annotation 설정만 해주면 된다.
각각의 항목은 다음과 같은 규칙으로 세팅한다.
| key | value | 의미 |
| argocd-image-updater.argoproj.io/image-list | <alias>=<Dockerhub-Username>/<Dockerhub-Repositoryname> | 도커 허브에서 이미지 대상 지정 |
| argocd-image-updater.argoproj.io/<alias>.update-strategy | name|semver|latest|digest | 업데이트 전략 선택 |
| argocd-image-updater.argoproj.io/<alias>.allow-tags | regexp:<Tag-Regular-Expressions> | 태그 정규식 설정 |
key 의 <alias> 부분은 image-list annotation 에서 지정한 value 의 alias 로 지정하면 된다. 해당 이미지에 대해 적용할 규칙/전략을 세팅한다는 의미이다.
update-strategy 는 name, semver, latest, digest 가 올 수 있는데, 각각의 의미는 아래와 같다.
| 전략 | 의미 | 특징 |
| name/alphabetical | 알파벳 오름차순으로 정렬된 목록의 마지막 태그로 업데이트 | YYYY-MM-DD 형태의 캘린더 버저닝 처럼 문자열 정렬만으로 우선순위 비교가 가능한 경우에 적합하다. |
| semver | 주어진 이미지 제약 조건에 따라 허용되는 가장 높은 버전으로 업데이트(Semantic Versioning)(기본값) | 1.x, 1.2.x와 같이 버전 제약 조건을 지정하여 특정 마이너/패치 버전 범위 내에서 가장 높은 버전을 찾아 업데이트한다. 태그 이름에 X.Y.Z 형태의 숫자가 포함되어야 한다. |
| latest/newest-build | 가장 최근에 생성된 이미지 태그로 업데이트(빌드 날짜(Build Date)가 가장 최신인 이미지) | Git 커밋 SHA나 랜덤 문자열처럼 버전 순서를 매길 수 없는 태그를 사용할 때 유용하다. 단, 태그가 생성되거나 푸시된 날짜가 아니라 이미지 내부의 ' 빌드 날짜 '를 기준으로 판단한다는 점에 유의하자. |
| digest | 고정된 단일 태그(예: latest, dev, stage)를 모니터링하다가, 해당 태그의 SHA 다이제스트(Digest)가 변경되면 업데이트 | 동일한 태그 이름을 계속 재사용하는 가변 태그(Mutable Tag) 방식을 사용할 때 유일하게 사용 가능한 전략이다. |
'CICD > Argo' 카테고리의 다른 글
| [ARGO] Argo CD 아키텍쳐 (0) | 2026.06.01 |
|---|---|
| [ARGO] Argo 의 대표적인 제품 (0) | 2026.05.28 |
망원동똑똑이
프로그래밍 지식을 자유롭게 모아두는 곳입니다.