Teleport는 여러 호스트에서 실행될 수 있는 여러 서비스가 있는 분산 시스템이므로 클러스터를 업그레이드할 때 모든 구성 요소가 호환성을 유지하도록 주의해야 합니다.
이 가이드는 호환성을 유지하면서 Teleport 클러스터의 구성 요소를 업그레이드하는 방법에 대한 개요를 제공합니다.
구성 요소 호환성
Teleport는 시맨틱 버전 관리를 사용합니다. 버전 번호는 주요 버전, 부 버전 및 패치 버전으로 구성되며, 점으로 구분됩니다. 클러스터 내에서 여러 teleport 바이너리를 실행할 때 다음 규칙이 적용됩니다:
- 패치 및 부 버전은 항상 호환됩니다. 예를 들어, 8.0.1 구성 요소는 8.0.3 구성 요소와 함께 작동하며, 8.1.0 구성 요소는 8.3.0 구성 요소와 함께 작동합니다.
- 서버는 하나의 주요 버전 뒤에 있는 클라이언트를 지원하지만, 최신 주요 버전의 클라이언트는 지원하지 않습니다. 예를 들어, 8.x.x 프록시 서비스 인스턴스는 7.x.x 에이전트 및 7.x.x
tsh와 호환되지만, 9.x.x 에이전트가 8.x.x 프록시 서비스 인스턴스와 작동할 것이라고 보장하지 않습니다. 이는 또한 6.x.x에서 바로 8.x.x로 업그레이드하려고 해서는 안 된다는 것을 의미합니다. 먼저 7.x.x로 업그레이드해야 합니다. - 프록시 서비스 인스턴스와 에이전트는 이전 주요 버전의 인증 서비스 인스턴스를 지원하지 않으며, 기본적으로 이전 인증 서비스 인스턴스에 연결하는 데 실패합니다. 에이전트 및 프록시 서비스 인스턴스를 시작할 때
--skip-version-check를 전달하여 버전 검사를 무시할 수 있습니다.
Teleport Enterprise Cloud에서는 Auth 및 Proxy 서비스 관리를 대신해 드립니다. 아래 명령을 실행하여 이러한 서비스의 현재 버전을 확인할 수 있습니다. 여기서 mytenant는 Teleport Enterprise Cloud 테넌트의 이름입니다:
curl -s https://mytenant.teleport.sh/webapi/ping | jq '.server_version'
자가 호스팅 Teleport 클러스터 업그레이드
이전 섹션에서 설명한 구성 요소 호환성 보장 때문에 자가 호스팅 Teleport 클러스터를 업그레이드할 때는 다음 순서를 준수해야 합니다:
-
Auth 서비스 업그레이드 중 데이터 마이그레이션을 수행할 수 있으므로 예상치 못한 사고에 대비해 Teleport 클러스터 상태를 백업하십시오. 백업 및 복원 지침을 따르십시오.
-
여러 Auth 서비스 인스턴스가 고가용성 구성(예: AWS 오토 스케일링 그룹)으로 실행되고 있는 경우, 업그레이드를 수행하기 전에 하나의 Auth 서비스로 그룹을 축소해야 합니다.
-
Auth 서비스를 다음 주요 버전으로 먼저 업그레이드하십시오. 새 버전에서 데이터 형식 변경이 도입된 경우, Auth 서비스가 필요한 마이그레이션을 수행합니다. 업그레이드 후 Auth 서비스를 시작하고 계속 진행하기 전에 정상 상태인지 확인하십시오.
-
Proxy 서비스 인스턴스를 Auth 서비스와 동일한 버전 번호로 업그레이드하십시오. Proxy 서비스 인스턴스는 상태 비저장(stateless)이며 어떤 순서로든 또는 동시에 업그레이드할 수 있습니다.
-
Teleport 에이전트를 Auth 서비스와 동일한 버전 번호로 업그레이드하십시오. 리소스 에이전트는 어떤 순서로든 또는 동시에 업그레이드할 수 있습니다.
여러 버전 번호로 업그레이드하는 경우, 목표 주요 버전 번호에 도달할 때까지 이러한 단계를 반복하십시오.
여러 Teleport 클러스터 업그레이드
신뢰 관계가 있는 여러 Teleport 클러스터를 업그레이드할 때는 호환성 문제를 피하기 위해 다음 순서로 업그레이드해야 합니다.
모든 클러스터를 한 번에 하나의 주요 버전으로 업그레이드해야 합니다. 예를 들어, 클러스터를 v10에서 v12로 업그레이드하려면, 클러스터를 v10에서 v11로 업그레이드한 다음, 같은 순서를 반복하여 v10에서 v11로 업그레이드해야 합니다.
- 다른 클러스터가 신뢰하는 루트 클러스터를 먼저 업그레이드하십시오.
- 업그레이드가 성공했는지 확인하십시오.
- 신뢰할 수 있는 잎 클러스터를 업그레이드하십시오.
다음 단계
업그레이드 소개로 돌아가 Teleport 클러스터 내의 개별 구성 요소를 업그레이드하는 방법을 확인하십시오.