이 단계는 'Istio 부가기능'이라고도 하는 Istio on GKE의 설치에만 적용됩니다.
시작하기 전에
먼저 검토를 수행하여 업그레이드 요구사항을 충족하는지 확인해야 합니다.
이 페이지의 명령어는 업그레이드 준비 단계의 환경 변수 및 마이그레이션 스크립트를 사용합니다.
지정된 순서로 이 프로세스의 각 단계를 수행하는 것이 중요합니다.
Istio 부가기능이 사용 중인지 확인
Istio 부가기능의 인그레스 게이트웨이 또는 사이드카 삽입 기능이 클러스터 내에서 사용 중인지 여부에 따라 두 가지 가능한 마이그레이션 경로가 있습니다.
앞서 준비 단계에서 Istio 부가기능이 구성되었는지 이미 확인한 바 있습니다. 이제 다음 명령어를 실행하여
istio-system
네임스페이스가 존재하는지 확인할 수 있습니다.echo $INGRESS_NAMESPACE
다음 명령어를 실행하여 Istio 부가기능의 사이드카 삽입 기능이 클러스터 내에서 사용 중인지 확인합니다.
kubectl get ns -l istio-injection=enabled
knative-serving
이외의 네임스페이스가 나열되면 Istio 부가기능의 사이드카 삽입이 사용 중임을 나타냅니다.예를 들어 명령어로
knative-serving
네임스페이스만 나열되는 경우 Istio 부가기능의 사이드카 삽입을 구성하지 않은 것이고 사용할 수 없습니다.
결과:
하나 또는 둘 다 사용 - Istio 부가기능 중 하나 또는 둘 모두가 클러스터 내에서 사용됩니다.
- Istio 부가기능 인그레스 서비스
istio-ingressgateway
가 사용됩니다. - Istio 부가기능 사이드카 삽입이 사용됩니다.
다음 단계: 다음 섹션의 안내에 따라 Istio 부가기능을 제거한 후 관리형 컨트롤 플레인이 있는 Cloud Service Mesh 가이드를 진행해야 합니다.
- Istio 부가기능 인그레스 서비스
사용되지 않음 - Istio 부가기능의 인그레스 게이트웨이 또는 사이드카 삽입이 클러스터 내에서 사용하도록 구성되지 않았습니다. 즉, 설치 시 '번들 버전의 Istio'를 사용합니다.
다음 단계: 다음 섹션의 안내에 따라 사용하지 않는 Istio 부가기능을 제거한 후 클러스터 내 컨트롤 플레인이 있는 Cloud Service Mesh 가이드로 진행할 수 있습니다.
Istio 부가기능 제거
이 섹션에서는 마이그레이션 스크립트를 사용하여 'Istio 부가기능'을 제거합니다.
다음 명령어를 실행하여 마이그레이션 스크립트를 시작합니다.
./migration-addon.sh --command uninstall-istio-addon
istio-system
네임스페이스가 삭제되었는지 확인합니다.kubectl get ns istio-system --ignore-not-found
다음 단계
위에서 확인한 인그레스 게이트웨이 구성에 따라 해당 설치 가이드를 진행합니다.
'Istio 부가기능' 중 하나 또는 둘 다 구성 내에서 구성 및 사용된 것을 앞에서 확인한 경우 클러스터 관리형 컨트롤 플레인이 있는 Cloud Service Mesh 가이드로 진행해야 합니다.
클러스터에서 'Istio 부가기능'의 인그레스 게이트웨이 또는 사이드카 삽입이 사용되지 않은 것을 앞에서 확인했다면 설치 시 '번들 버전의 Istio'를 사용한 것입니다. 이제 클러스터 내 컨트롤 플레인이 있는 Cloud Service Mesh를 설치할 수 있습니다.
롤백
위 단계를 통해 수행한 변경사항을 롤백해야 할 경우 마이그레이션 스크립트를 사용하여 'Istio 부가기능'을 다시 사용 설정할 수 있습니다.
다음 명령어를 실행합니다.
./migration-addon.sh --command rollback-uninstall-istio-addon
변경사항을 원래 상태로 계속 롤백하려면 Knative serving 'GKE 부가기능'을 롤백합니다.