이 단계는 Istio on GKE의 인그레스 게이트웨이가 클러스터에 구성된 것으로 확인된 설치에 해당합니다. 이 프로세스에서 Cloud Service Mesh 버전 1.18은 관리형 컨트롤 플레인으로 설치됩니다.
시작하기 전에
'Istio 부가기능'에서 마이그레이션하려면 Google 관리 컨트롤 플레인에서 Cloud Service Mesh를 사용해야 합니다. 따라서 Cloud Service Mesh 클러스터 내 컨트롤 플레인은 지원되는 마이그레이션 옵션이 아닙니다.
먼저 검토를 수행하여 업그레이드 요구사항을 충족하는지 확인해야 합니다.
이 페이지의 명령어는 업그레이드 준비 단계의 환경 변수 및 마이그레이션 스크립트를 사용합니다.
지정된 순서로 이 프로세스의 각 단계를 수행하는 것이 중요합니다.
개요
일반적으로 컨트롤 플레인을 사용하여 'Istio 부가기능'에서 Cloud Service Mesh로 마이그레이션하는 프로세스에는 다음이 포함됩니다.
- Cloud Service Mesh 관리 컨트롤 플레인을 설치합니다.
- 마이그레이션 스크립트를 사용하여 Cloud Service Mesh 인그레스 게이트웨이를 구성합니다.
Cloud Service Mesh 버전 1.18로 마이그레이션
Cloud Service Mesh 문서 'Istio on GKE에서 Cloud Service Mesh로 마이그레이션'의 자세한 안내를 따라야 합니다. 설치를 완료하고 워크로드를 마이그레이션한 후 이 페이지로 돌아와서 남은 구성 단계를 완료하세요.
'Istio 부가기능 마이그레이션 안내'에 따라 Google 관리형 컨트롤 플레인을 사용해서 Cloud Service Mesh로 설치를 마이그레이션합니다.
이 과정 중에 알아야 하는 핵심 항목:
custom envoy filters are not supported
가 표시되는 경우, 단순히 '예'를 선택하면 마이그레이션이 계속됩니다. 예:Detected custom envoy filters are not supported by Cloud Service Mesh. Please remove these if possible NAMESPACE NAME AGE gke-system allowconnect-cluster-local-gateway 26m Continue anyways? [y/N] Y
마이그레이션 안내에는 Cloud Service Mesh 설치를 완료하기 위한 단계를 수행하는 성공적인 마이그레이션 완료 섹션이 포함되어 있습니다. 중요: 이러한 단계를 수행한 후에는 더 이상 변경사항을 롤백할 수 없습니다.
Istio 부가기능 마이그레이션 안내: Istio on GKE에서 Cloud Service Mesh로 마이그레이션
마이그레이션 단계를 완료하고 워크로드를 Cloud Service Mesh로 마이그레이션한 후 다음 명령어를 실행하여
knative-serving
네임스페이스에서 인그레스 포드를 다시 시작하고 라벨을 지정합니다.인그레스 포드를 다시 시작합니다.
kubectl rollout restart deployment autoscaler activator webhook -n knative-serving
istio: ingressgateway
라벨을 추가합니다.kubectl patch deployment ${INGRESS_NAME} --namespace ${INGRESS_NAMESPACE} --patch '{"spec": {"template": {"metadata": {"labels": {"istio": "ingressgateway"}}}}}'
Cloud Service Mesh 인그레스 구성
이 섹션에서는 마이그레이션 스크립트를 사용하여 출시 채널을 Cloud Service Mesh 관리 컨트롤 플레인에 대해 asm-managed-rapid
로 설정합니다.
다음 명령어를 실행하여 마이그레이션 스크립트를 시작합니다.
./migration-addon.sh \
--asm-revision asm-managed-rapid \
--command set-up-asm-ingress
다음 단계
롤백
위 단계를 통해 수행한 변경사항을 롤백해야 하는 경우 다음과 같이 할 수 있습니다.
- 마이그레이션 스크립트를 사용하여 Cloud Service Mesh 인그레스를 삭제합니다.
- Cloud Service Mesh 설치를 롤백합니다.
Google 관리형 컨트롤 플레인을 사용하여 Cloud Service Mesh 설치 및 구성을 롤백하려면 다음을 수행합니다.
다음 명령어를 실행하여 Cloud Service Mesh 인그레스를 삭제합니다.
./migration-addon.sh --command rollback-set-up-asm-ingress
프로세스 중의 터미널 출력은 다음과 비슷하게 표시됩니다.
Deleting Cloud Service Mesh ingress deployment.apps "istio-ingressgateway" deleted horizontalpodautoscaler.autoscaling "istio-ingressgateway" deleted role.rbac.authorization.k8s.io "istio-ingressgateway-sds" deleted rolebinding.rbac.authorization.k8s.io "istio-ingressgateway-sds" deleted Cloud Service Mesh ingress is successfully deleted.
롤백을 확인하려면
istio-ingressgateway
서비스가gke-system
네임스페이스에 더 이상 없는지 확인합니다.kubectl get deployment istio-ingressgateway -n gke-system
다음 명령어를 실행하여 'Istio 부가기능'을 다시 사용 설정합니다.
./migration-addon.sh --command rollback-uninstall-istio-addon
변경사항을 설치 초기 상태로 계속 롤백하려면 Istio 부가 기능을 롤백합니다.