Consul on Kubernetes 업그레이드 호환성

Consul on Kubernetes의 각 릴리스마다 Helm chart, consul-k8s-control-plane 바이너리, consul-k8s CLI 바이너리가 단일 버전으로 빌드되고 배포돼요. Helm으로 배포할 때는 Helm Chart와 Control Plane 바이너리가 밀접하게 결합되어 있으므로 Helm Chart와 같은 consul-k8s-control-plane 버전으로 업그레이드하는 것이 권장돼요.

출처: 문서

본문

Consul on Kubernetes의 각 릴리스마다 Helm chart, consul-k8s-control-plane 바이너리, consul-k8s CLI 바이너리가 단일 버전으로 빌드되고 배포됩니다. Helm으로 배포할 때 Consul on Kubernetes를 업그레이드하는 권장 최상의 경로는 Helm Chart와 Control Plane 바이너리가 밀접하게 결합되어 있으므로 Helm Chart와 같은 consul-k8s-control-plane 버전으로 업그레이드하는 것입니다.

지원되는 Consul 및 Kubernetes 버전

Consul Kubernetes는 모든 컴포넌트(consul-k8s CLI, consul-k8s-control-plane, Helm chart)를 단일 시맨틱 버전으로 버전 관리합니다. 특정 버전으로 설치하거나 업그레이드할 때는 호환되는 Helm chart 또는 consul-k8s CLI와 함께 올바른 Consul 버전을 사용하고 있는지 확인하세요.

호환성 매트릭스 (Compatibility matrix)

다음 섹션은 Consul Kubernetes 컴포넌트와 종속성에 대한 호환성 매트릭스를 설명합니다. Consul Enterprise의 일부 릴리스는 Long Term Support (LTS)를 받으며 비 LTS Enterprise 및 커뮤니티 에디션 릴리스보다 확장된 호환성 기간을 갖습니다.

표준 릴리스 (Standard releases)

달리 명시되지 않는 한 다음 호환성 표의 행은 Consul Enterprise와 Consul 커뮤니티 에디션(CE) 모두에 적용됩니다.

| Consul 버전 | 호환 consul-k8s 버전 | 호환 Kubernetes 버전 | 호환 OpenShift 버전 | Consul 수명주기 상태 | | 2.0.x | 2.0.x | 1.30.x - 1.35.x | 4.18, 4.19, 4.20, 4.21 | Supported | | 1.22.x | 1.9.x | 1.30.x - 1.35.x | TBD | Supported | | 1.21.x | 1.8.x 1.7.x | 1.30.x - 1.35.x 1.30.x - 1.33.x | 4.16.x - 4.18.x 4.13.x - 4.15.x | Supported | | 1.17.x | 1.3.x | 1.25.x - 1.28.x | 4.12.x - 4.15.x | EOL |

Enterprise 장기 지원 릴리스 (Enterprise Long Term Support releases)

활성 Consul Enterprise Long Term Support (LTS) 릴리스는 LTS 릴리스가 유지보수 종료 시점에 도달할 때까지 Kubernetes 버전 호환성 기간을 확장합니다.

버전별 업그레이드 요구 사항

Consul v1.14.0부터 Kubernetes 배포는 클라이언트 에이전트 대신 Consul Dataplane을 사용합니다. 클라이언트 에이전트를 사용하는 버전에서 dataplane을 사용하는 버전으로 Consul을 업그레이드하면 Helm chart를 업데이트하고 기존 배포에서 클라이언트 에이전트를 제거하는 특정 단계를 따라야 합니다. 자세한 내용은 Upgrading to Consul Dataplane을 참조하세요.

Consul on Kubernetes Helm chart의 v1.0.0 릴리스는 externalServers[].hosts 매개변수에 대한 변경도 도입했습니다. 이전에는 이 필드에 문자열로 공급자 조회를 입력할 수 있었습니다. 이제는 공급자 조회를 포함하는 문자열 시작 부분에 exec=를 포함해야 합니다. 그렇지 않으면 문자열이 DNS 이름으로 처리됩니다. 자세한 내용은 go-netaddrs 라이브러리와 명령줄 도구를 참조하세요.

지원되는 Envoy 버전

Consul 버전에 대한 지원되는 Envoy 및 consul-dataplane(Consul K8s 1.0 이상) 버전은 Envoy - Supported Versions에도 있습니다. consul-k8s 1.0부터 consul-dataplane은 번들된 Envoy 버전을 포함합니다. 권장 모범 사례는 주어진 Helm chart에 대해 기본 Consul 및 Consul Kubernetes 바이너리로 테스트된 버전인 Helm values.yaml 파일에 제공된 기본 Envoy 또는 consul-dataplane 버전을 사용하는 것입니다.

Vault를 시크릿 백엔드로 사용하는 호환성

Consul K8s 0.39.0 및 Consul 1.11.x부터 Consul Kubernetes는 Consul on Kubernetes가 사용하는 모든 시크릿에 대해 Vault를 시크릿 백엔드로 활용하는 기능을 지원합니다.

플랫폼별 호환성 참고 사항

Red Hat OpenShift

global.openshift 스탠자에서 enabled: true를 설정해 Red Hat OpenShift 지원을 활성화할 수 있습니다. OpenShift에 배포하는 지침은 Deploy Consul on RedHat OpenShift 튜토리얼을 참조하세요.

VMware Tanzu Kubernetes Grid 및 Tanzu Kubernetes Grid Integrated Edition

Consul Kubernetes는 VMware Tanzu Kubernetes Grid와 VMware Tanzu Kubernetes Integrated Edition 둘 다에 대해 인증되었습니다.

Tanzu Kubernetes Grid는 버전 1.3.0 이상에서 인증되었습니다. CNI 플러그인으로 Calico만 지원됩니다.

Consul on Kubernetes 업그레이드 호환성