호환성 개요 업그레이드 | Teleport 공식 기술 문서 한국판 by 인포그랩

호환성 개요 업그레이드

Teleport는 여러 호스트에서 실행되는 여러 서비스로 구성된 분산 시스템이므로 클러스터 업그레이드 시 모든 구성 요소의 호환성이 유지되도록 주의해야 합니다.

이 가이드는 호환성을 유지하면서 Teleport 클러스터의 구성 요소를 업그레이드하는 방법에 대한 개요를 제공합니다.

구성 요소 호환성

Teleport는 의미 체계 버전 관리(Semantic Versioning)를 사용합니다. 버전 번호는 주 버전, 보조 버전, 패치 버전으로 구성되며, 점으로 구분됩니다. 클러스터 내에서 여러 teleport 바이너리를 실행할 때는 다음 규칙이 적용됩니다:

패치 및 보조 버전은 항상 호환됩니다. 예를 들어, 어떤 8.0.1 구성 요소는 어떤 8.0.3 구성 요소와 작동하며, 어떤 8.1.0 구성 요소는 어떤 8.3.0 구성 요소와도 작동합니다.
서버는 한 개의 주 버전이 낮은 클라이언트를 지원하지만, 새로운 주 버전의 클라이언트는 지원하지 않습니다. 예를 들어, 8.x.x Proxy Service 인스턴스는 7.x.x 에이전트와 7.x.x tsh 와 호환되지만, 9.x.x 에이전트가 8.x.x Proxy Service 인스턴스와 작동할 것이라고 보장하지 않습니다. 이는 또한 6.x.x에서 8.x.x로 직접 업그레이드하지 않아야 함을 의미합니다. 먼저 7.x.x로 업그레이드해야 합니다.
Proxy Service 인스턴스와 에이전트는 이전 주 버전의 Auth Service 인스턴스를 지원하지 않으며, 기본적으로 이전 Auth Service 인스턴스에 연결할 수 없습니다. 에이전트와 Proxy Service 인스턴스를 시작할 때 --skip-version-check 를 전달하여 버전 검사를 무시할 수 있습니다.

Teleport Enterprise Cloud에서는 Auth 및 Proxy 서비스를 관리합니다. mytenant 가 귀하의 Teleport Enterprise Cloud 테넌트 이름인 다음 명령을 실행하여 이러한 서비스의 현재 버전을 확인할 수 있습니다:

curl -s https://mytenant.teleport.sh/webapi/ping | jq '.server_version'

앞서 설명한 구성 요소 호환성 보장을 때문에 자가 호스팅 Teleport 클러스터를 업그레이드할 때는 다음 순서를 준수해야 합니다:

Auth 서비스 업그레이드 중 데이터 마이그레이션을 수행할 수 있으므로 예기치 않은 사고를 대비하여 Teleport 클러스터 상태를 백업합니다. 백업 및 복원 의 지침을 따르십시오.
여러 Auth 서비스 인스턴스가 고가용성 구성(예: AWS Auto Scaling 그룹)으로 실행 중인 경우 업그레이드 전에 그룹을 하나의 Auth 서비스로 축소해야 합니다.
Auth 서비스를 다음 주요 버전으로 먼저 업그레이드합니다. 새 버전에 데이터 형식 변경 사항이 도입된 경우, Auth 서비스는 필요한 마이그레이션을 수행합니다. 업그레이드 후 Auth 서비스를 시작하고 계속 진행하기 전에 건강 상태가 양호한지 확인합니다.
Proxy 서비스 인스턴스를 Auth 서비스와 동일한 버전 번호로 업그레이드합니다. Proxy 서비스 인스턴스는 상태 비저장형이며 어떤 순서로든 또는 동시에 업그레이드할 수 있습니다.
Teleport 에이전트를 Auth 서비스와 동일한 버전 번호로 업그레이드합니다. 리소스 에이전트를 어떤 순서로든 또는 동시에 업그레이드할 수 있습니다.

여러 버전 번호를 업그레이드하는 경우, 목표 주요 버전 번호에 도달할 때까지 이 단계를 반복합니다.

신뢰 관계가 있는 여러 Teleport 클러스터를 업그레이드할 때는 호환성 문제를 피하기 위해 다음 순서를 따라야 합니다.

모든 클러스터를 한 번에 하나의 주요 버전으로 업그레이드해야 합니다. 예를 들어, 클러스터를 v10에서 v12로 업그레이드하려면 클러스터를 v10에서 v11로 업그레이드하는 순서를 따르고, 그런 다음 이 순서를 반복하여 v10에서 v11로 업그레이드해야 합니다.

Teleport 클러스터 내의 개별 구성 요소를 업그레이드하는 방법에 대한 업그레이드 소개로 돌아갑니다.

인포레터에서 최신 DevOps 트렌드를 격주로 만나보세요!