새 클러스터에서 클러스터 내 Istio로 마이그레이션
이 튜토리얼에서는 클러스터 내 Cloud Service Mesh 를 사용하는 기존 Google Kubernetes Engine (GKE) 클러스터에서 오픈소스 Istio 를 사용하는 새 GKE 클러스터로 애플리케이션을 마이그레이션하는 방법을 보여줍니다. 원활한 마이그레이션을 위해 에지-멀티 클러스터 메시 기능을 활용합니다.
용어 참고: 이 튜토리얼에서 Cloud Service Mesh는 Google의 클러스터 내 Cloud Service Mesh를 나타내고 Istio는 오픈소스 Istio 서비스 메시를 나타냅니다.
이 튜토리얼에서는 다음 단계를 진행합니다.
- 마이그레이션을 위해 클러스터 내 Cloud Service Mesh를 사용하여 기존 클러스터를 준비합니다.
- Istio를 사용하여 새 GKE 클러스터를 프로비저닝합니다.
- 전용 클러스터에서 GKE 멀티 클러스터 Gateway API를 구성하고 멀티 클러스터 서비스를 구성하여 메시 인그레스로 라우팅을 설정합니다.
- 카나리아 배포를 실행하여 Cloud Service Mesh와 Istio 간에 실시간 HTTP 트래픽을 분할합니다.
- Istio로 최종 전환을 완료하고 클러스터 내 Cloud Service Mesh 리소스를 폐기합니다.
카나리아 배포
'카나리아 배포'는 모든 프로덕션 사용자에게 출시하기 전에 소프트웨어 또는 인프라의 새 버전을 테스트하기 위해 소프트웨어 엔지니어링에 사용되는 기술입니다. 새 대상 버전으로 전송되는 트래픽의 비율을 점진적으로 늘리는 작업이 포함됩니다.
이 튜토리얼에서는 Istio를 사용하여 새 클러스터를 설정하고 사용자 트래픽을 점진적으로 이동합니다. 먼저 사용자 트래픽의 0% 를 새 클러스터로, 50%를 새 클러스터로, 마지막으로 100% 를 Istio가 있는 GKE 클러스터로 전달합니다. 프로덕션 환경에서는 더 작고 세분화된 증분 (예: 1%, 5%, 10%, 25%, 50%, 100%)을 사용할 수 있습니다. 언제든지 새 클러스터에 오류가 발생하거나 성능이 저하되는 것을 발견하면 Istio 클러스터의 트래픽 비율을 0% 로 다시 설정하여 즉시 롤백을 실행할 수 있습니다.
카나리아 컨트롤 플레인과 카나리아 클러스터 비교
서비스 메시 컨트롤 플레인 간에 마이그레이션하는 두 가지 기본 전략이 있습니다.
- 카나리아 클러스터 마이그레이션 (권장): 이 전략에서는 기존 클러스터와 동일한 Google Cloud 프로젝트 및 Fleet에 새 클러스터를 만들고, 대상 서비스 메시 컨트롤 플레인 (Istio)을 설치하고, 워크로드와 인그레스 트래픽을 새 클러스터로 마이그레이션합니다.
- 카나리아 컨트롤 플레인 마이그레이션 (지원되지 않음): 이 전략에서는 초기 컨트롤 플레인이 설치된 동일한 클러스터에 새 컨트롤 플레인을 나란히 설치합니다. 이 마이그레이션 모드는 지원되지 않습니다.
이 가이드에서는 카나리아 클러스터 마이그레이션 전략을 따릅니다. 두 클러스터 모두 동일한 Google Cloud 프로젝트에 있어야 합니다.
비용
이 튜토리얼에서는 비용이 청구될 수 있는 구성요소를 사용합니다 Google Cloud. 포함:
이 튜토리얼을 완료하면 만든 리소스를 삭제하여 지속적인 비용이 발생하지 않도록 할 수 있습니다. 자세한 내용은 정리를 참조하세요.
시작하기 전에
-
Google Cloud 콘솔의 프로젝트 선택기 페이지에서 클러스터 내 Cloud Service Mesh가 설치된 Google Cloud 프로젝트를 선택합니다.
- 계정에 로그인합니다. Google Cloud 를 처음 사용하는 경우 Google Cloud, 계정을 만들어 실제 시나리오에서 제품이 어떻게 작동하는지 평가하세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
-
Verify that billing is enabled for your Google Cloud project.
Enable the required APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
Verify that billing is enabled for your Google Cloud project.
Enable the required APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
마이그레이션을 위해 클러스터 내 Cloud Service Mesh를 사용하여 클러스터 준비
이 섹션에서는 클러스터 내 Cloud Service Mesh를 실행하는 기존 GKE 클러스터를 Istio가 있는 GKE 클러스터로 마이그레이션할 수 있도록 준비합니다.
클러스터 내 Cloud Service Mesh 클러스터가 실행 중이고 마이그레이션할 준비가 되었는지 확인
클러스터 내 Cloud Service Mesh 설치 가이드에 따라 클러스터 내
istiod컨트롤 플레인으로 클러스터 내 Cloud Service Mesh 클러스터GKE_CSM_CLUSTER가 실행 중인지 확인합니다.다음 명령어를 실행하여 설치 상태를 확인합니다.
kubectl get deployment -A -l app=istiod -L istio.io/rev출력은 다음과 비슷합니다.
NAMESPACE NAME READY UP-TO-DATE AVAILABLE AGE REV ISTIOD_NAMESPACE istiod-asm-1295-12 2/2 2 2 4d16h asm-1295-12다음 명령어를 사용하여
istiod컨트롤 플레인에 오류가 없는지 확인합니다.kubectl logs -n ISTIOD_NAMESPACE -l app=istiod
클러스터를 마이그레이션 준비 상태로 만들기
클러스터 및 노드 풀에서 워크로드 아이덴티티가 사용 설정되었는지 확인합니다.
클러스터에서 워크로드 아이덴티티를 확인하려면 다음 명령어를 실행합니다.
gcloud container clusters describe "GKE_CSM_CLUSTER" \ --location="LOCATION" \ --project="PROJECT_ID" \ --format="value(workloadIdentityConfig.workloadPool)"GKE_CSM_CLUSTER를 기존 클러스터 이름으로, LOCATION를 클러스터 위치로, PROJECT_ID를 프로젝트 ID로 바꿉니다.
예상 출력:
PROJECT_ID.svc.id.goog워크로드 아이덴티티가 누락된 경우 워크로드 아이덴티티 가이드 를 참조하여 클러스터를 업데이트하세요.
클러스터가 Fleet에 등록되었는지 확인합니다.
gcloud container clusters describe "GKE_CSM_CLUSTER" \ --location="LOCATION" \ --project="PROJECT_ID" \ --format="yaml(fleet)"등록된 클러스터의 예상 출력:
fleet: membership: //gkehub.googleapis.com/projects/PROJECT_NUMBER/locations/LOCATION/memberships/MEMBERSHIP_NAMEFleet 세부정보가 비어 있는 경우 Fleet 멤버십 등록 가이드 를 참조하여 클러스터를 Fleet에 등록하세요.
게이트웨이 설치 및 업그레이드 가이드에 따라 인그레스 게이트웨이를 사용하여 애플리케이션을 노출합니다.
새 GKE 클러스터에 Istio 설치
이 섹션에서는 카나리아 클러스터 마이그레이션 전략을 위해 오픈소스 Istio를 실행하는 새 GKE 클러스터를 프로비저닝합니다.
기존 클러스터 내 Cloud Service Mesh 클러스터와 동일한 Google Cloud 프로젝트 (
PROJECT_ID)에 새 GKE 클러스터GKE_ISTIO_CLUSTER를 만듭니다.클러스터를 만들 때
--project를 지정하고 워크로드 아이덴티티를--workload-pool=PROJECT_ID.svc.id.goog를 사용하여 사용 설정해야 합니다.gcloud container clusters create GKE_ISTIO_CLUSTER \ --project=PROJECT_ID \ --location=LOCATION \ --workload-pool=PROJECT_ID.svc.id.goog클러스터를 이미 만든 경우 워크로드 아이덴티티 가이드 를 사용하여 워크로드 아이덴티티를 사용 설정하세요.
Istio 클러스터를 Fleet에 등록합니다.
gcloud container fleet memberships register \ GKE_ISTIO_CLUSTER \ --gke-cluster=LOCATION/GKE_ISTIO_CLUSTER \ --enable-workload-identity \ --location=LOCATION \ --project=PROJECT_ID인그레스 트래픽을 위해 배포된 인그레스 게이트웨이 를 사용하여 공식 Istio 설치 가이드 에 따라 Istio를 설치합니다. 원활한 마이그레이션을 위해 동일한 버전의 오픈소스 Istio를 설치하는 것이 좋습니다. 오픈소스 Istio를 업그레이드하기로 결정한 경우 Istio's 출시 노트를 검토하여 동작 변경사항을 확인하세요.
클러스터 내 Cloud Service Mesh를 사용하는 GKE 클러스터와 동일한 방식으로 애플리케이션을 설치하여 이 클러스터를 설정합니다. 이 가이드에서는 인그레스 게이트웨이를 호스팅하는 네임스페이스를
ISTIO_INGRESS_NAMESPACE로 참조합니다.클러스터가 정상이고 트래픽을 처리할 준비가 되었는지 확인합니다. 애플리케이션팀은 실시간 사용자 트래픽을 라우팅하기 전에 모든 마이크로서비스가 깨끗하게 실행되고 상태 점검을 통과하는지 확인해야 합니다.
전용 클러스터에서 멀티 클러스터 Gateway API 구성
이 섹션에서는 GKE Gateway Controller를 통해 외부 애플리케이션 부하 분산기(L7XLB)를 구성하여 메시로의 인그레스 트래픽을 사용 설정합니다. 마이그레이션 중에 부하 분산기를 관리하기 위해 전용 GKE 구성 클러스터에 Gateway API 리소스를 배포하는 것이 좋습니다. 이 가이드에서는 이 전용 구성 클러스터를 GKE_CONFIG_CLUSTER로 참조합니다.
구성 클러스터 준비
멀티 클러스터 게이트웨이
가이드에 따라 Gateway 및 HTTPRoute API를 호스팅하도록 구성 클러스터를 준비합니다.
멀티 클러스터 서비스를 사용하여 서비스 내보내기
멀티 클러스터 서비스
(MCS)
가이드에 설명된 대로
ServiceExport를 사용하여 두 메시 클러스터에서 istio-ingressgateway 서비스를 내보냅니다.
apiVersion: net.gke.io/v1
kind: ServiceExport
metadata:
namespace: NAMESPACE
name: SERVICE_EXPORT_NAME
구성 클러스터에서 Gateway API 리소스 프로비저닝
게이트웨이 에지-메시 가이드 에 따라 전용 구성 클러스터에서
Gateway및HTTPRoute리소스를 만듭니다. 샘플 구성은 다음과 같습니다.apiVersion: gateway.networking.k8s.io/v1 kind: Gateway metadata: name: global-gateway namespace: CSM_INGRESS_NAMESPACE spec: gatewayClassName: gke-l7-global-external-managed-mc listeners: - name: http protocol: HTTP port: 80 allowedRoutes: namespaces: from: Same --- apiVersion: gateway.networking.k8s.io/v1 kind: HTTPRoute metadata: name: edge-to-mesh-route namespace: CSM_INGRESS_NAMESPACE spec: parentRefs: - name: global-gateway rules: - backendRefs: # Backend 1: Cloud Service Mesh Cluster (CSM_INGRESS_NAMESPACE namespace) - group: net.gke.io kind: ServiceImport name: istio-ingressgateway namespace: CSM_INGRESS_NAMESPACE port: 80 weight: 100ServiceImport리소스가HTTPRoute와 다른 네임스페이스에 있는 경우ReferenceGrant를 사용하여 교차 네임스페이스 트래픽 라우팅을 사용 설정합니다.apiVersion: gateway.networking.k8s.io/v1beta1 kind: ReferenceGrant metadata: name: allow-csm-ingress-to-ISTIO_INGRESS_NAMESPACE namespace: ISTIO_INGRESS_NAMESPACE spec: from: - group: gateway.networking.k8s.io kind: HTTPRoute namespace: CSM_INGRESS_NAMESPACE to: - group: net.gke.io kind: ServiceImport
카나리아 배포를 사용하여 트래픽 마이그레이션
이 섹션에서는 트래픽을 새 클러스터로 이동하고 마이그레이션을 완료합니다.
트래픽의 50% 를 Istio로 이동
이 섹션에서는 카나리아 배포를 실행하여 트래픽을 천천히 마이그레이션합니다. 자세한 내용은 트래픽 분할 가이드를 참조하세요.
구성 클러스터에서
HTTPRoute커스텀 리소스를 적용하여 카나리아 트래픽을 Istio 클러스터로 분할합니다.apiVersion: gateway.networking.k8s.io/v1 kind: HTTPRoute metadata: name: edge-to-mesh-route namespace: CSM_INGRESS_NAMESPACE spec: parentRefs: - name: global-gateway rules: - backendRefs: # Backend 1: CSM Cluster (CSM_INGRESS_NAMESPACE namespace) - group: net.gke.io kind: ServiceImport name: istio-ingressgateway namespace: CSM_INGRESS_NAMESPACE port: 80 weight: 50 # Backend 2: Istio Cluster (ISTIO_INGRESS_NAMESPACE namespace) - group: net.gke.io kind: ServiceImport name: istio-ingressgateway namespace: ISTIO_INGRESS_NAMESPACE port: 80 weight: 50게이트웨이 공개 IP 주소에 대해 병렬 요청을 실행하여 실시간 트래픽 분산을 검증합니다.
예상 출력: 응답은
GKE_CSM_CLUSTER와GKE_ISTIO_CLUSTER모두에서 부하 분산됩니다.앞서 언급한 대로 프로덕션에서는 더 작은 증분 (예: 1%, 5%, 10%, 25%, 50%, 100%)으로 트래픽을 마이그레이션합니다. 이러한 가중치 증분이 부하 분산기에 완전히 전파되는 데 시간이 걸릴 수 있으므로 더 늘리기 전에 트래픽이 올바르게 분할되었는지 확인하세요.
Istio 클러스터로 마이그레이션 완료
Istio 클러스터의 애플리케이션이 카나리아 트래픽에서 올바르게 작동하고 모든 트래픽이 Istio 클러스터로 이동했는지 확인합니다. 트래픽 라우팅이 제대로 작동하는지 확인한 후 클러스터 내 Cloud Service Mesh 클러스터에서 ServiceExport 리소스를 삭제하여 마이그레이션을 완료합니다.
kubectl --context="GKE_CSM_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n CSM_INGRESS_NAMESPACE
GKE Gateway Controller는 Cloud Service Mesh 클러스터의 네트워크 엔드포인트 그룹 (NEG)을 Google Cloud 부하 분산기 백엔드 서비스에서 자동으로 분리합니다. 모든 수신 클라이언트 트래픽은 다운타임 없이 Istio 클러스터로 원활하게 전환됩니다.
정리
이 튜토리얼에서 사용된 리소스에 대해 Google Cloud 계정에 요금이 청구되지 않도록 배포된 구성요소를 정리하세요.
Istio 클러스터에서
ServiceExport리소스를 삭제합니다.kubectl --context="GKE_ISTIO_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n ISTIO_INGRESS_NAMESPACEFleet 멤버십을 등록 취소합니다.
gcloud container fleet memberships unregister \ GKE_CSM_CLUSTER \ --gke-cluster="LOCATION/GKE_CSM_CLUSTER" \ --project="PROJECT_ID"클러스터 내 Cloud Service Mesh 클러스터를 삭제합니다.
gcloud container clusters delete GKE_CSM_CLUSTER \ --location="LOCATION" \ --project="PROJECT_ID"
다음 단계
- 기본 아키텍처 가이드인 에지에서 멀티 클러스터 메시로: GKE 게이트웨이 및 Cloud Service Mesh를 통해 전역으로 분산된 애플리케이션 배포를 읽어보세요.
- 멀티 클러스터 Gateway API 패턴에 대해 자세히 알아보세요.
- 멀티 클러스터 부하 분산에 대해 자세히 알아보세요.
- Istio 메시 트래픽 관리 문서를 살펴보세요.