Argo CD 업그레이드 개요
Argo CD 업그레이드 개요
이 문서는 Argo CD를 업그레이드할 때 꼭 알아야 할 내용을 다룹니다. 업그레이드 전에 반드시 버전 간 변경 사항(breaking changes)을 확인하세요. Argo CD는 세미버(SemVer)와 유사한 버전 규칙을 사용하기 때문에, 어떤 업그레이드가 안전한지 미리 파악할 수 있습니다.
출처: 문서
본문
이 섹션은 Argo CD를 업그레이드하기 위한 정보를 담고 있습니다. 업그레이드하기 전에 반드시 Argo CD 버전 간의 변경 사항(breaking changes)을 읽어 주세요.
Argo CD는 다음 규칙을 보장하는 세미버(SemVer) 유사 버전 체계를 사용합니다:
-
패치 릴리스는 어떤 breaking change도 도입하지 않습니다. 따라서 v1.5.1에서 v1.5.3으로 업그레이드할 때는 특별한 지침이 필요하지 않습니다.
-
마이너 릴리스는 우회 방법(workaround)이 있는 사소한 변경을 도입할 수 있습니다. v1.3.0에서 v1.5.2로 업그레이드한다면, v1.3 → v1.4 및 v1.4 → v1.5 업그레이드 지침을 모두 확인해 주세요.
-
메이저 릴리스는 하위 호환되지 않는 동작 변경을 도입합니다. 재해 복구(disaster recovery) 가이드를 따라 Argo CD 설정을 백업해 두는 것을 권장합니다.
새 Argo CD 버전에서 도입될 수 있는 breaking change에 대한 관련 노트를 읽은 뒤, 아래 명령어로 Argo CD를 업그레이드하세요. <version>은 원하는 버전 번호로 바꿔 주세요.
Non-HA:
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/<version>/manifests/install.yaml
HA:
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/<version>/manifests/ha/install.yaml
참고:
--server-side --force-conflicts플래그가 필요한 이유는 일부 Argo CD CRD가 클라이언트 사이드 apply의 크기 제한을 초과하기 때문입니다. 자세한 내용은 getting started 가이드를 참고하세요.
경고: 일부 릴리스는 이미지 변경만 필요하더라도, 전체 매니페스트 세트를 적용하는 것을 권장합니다. 매니페스트 변경에는 중요한 파라미터 수정이 포함될 수 있으며, 전체 세트를 적용하면 잘못된 설정이 발생하는 것을 막을 수 있습니다.
- v3.4 → v3.5
- v3.3 → v3.4
- v3.2 → v3.3
- v3.1 → v3.2
- v3.0 → v3.1
- v2.14 → v3.0
- v2.13 → v2.14
- v2.12 → v2.13
- v2.11 → v2.12
- v2.10 → v2.11
- v2.9 → v2.10
- v2.8 → v2.9
- v2.7 → v2.8
- v2.6 → v2.7
- v2.5 → v2.6
- v2.4 → v2.5
- v2.3 → v2.4
- v2.2 → v2.3
- v2.1 → v2.2
- v2.0 → v2.1
- v1.8 → v2.0
- v1.7 → v1.8
- v1.6 → v1.7
- v1.5 → v1.6
- v1.4 → v1.5
- v1.3 → v1.4
- v1.2 → v1.3
- v1.1 → v1.2
- v1.0 → v1.1