Anthos Service Mesh 1.7 문서를 보고 있습니다. 최신 문서를 보거나 사용 가능한 다른 버전을 선택합니다.

Istio에서 Anthos Service Mesh로 마이그레이션

이 페이지는 다른 Cloud 프로젝트에 있는 여러 클러스터를 포함하는 메시의 Istio를 GKE 클러스터 기반 Anthos Service Mesh 1.7.6 버전으로 마이그레이션하는 방법을 설명하는 여러 페이지로 된 가이드의 일부입니다. 단일 클러스터 메시 또는 동일한 Cloud 프로젝트의 다중 클러스터를 포함하는 메시의 마이그레이션은GKE 설치, 마이그레이션, 업그레이드를 참조하세요.

시작하기 전에

Anthos Service Mesh를 설치하기 전에 다음을 확인합니다.

사용자 인증 정보 및 권한 설정

  1. 프로젝트를 설치할 수 있도록 초기화합니다. 무엇보다도 이 명령어는 사이드카 프록시와 같은 제어 영역 구성요소가 프로젝트의 데이터 및 리소스에 안전하게 액세스할 수 있도록 서비스 계정을 만듭니다.

    curl --request POST \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --data '' \
      "https://meshconfig.googleapis.com/v1alpha1/projects/${PROJECT_ID}:initialize"

    이 명령어는 빈 중괄호({})를 사용하여 응답합니다.

  2. 클러스터와 상호작용하기 위해 사용자 인증 정보를 가져옵니다. 또한 이 명령어는 kubectl의 현재 컨텍스트를 클러스터로 설정합니다.

    gcloud container clusters get-credentials ${CLUSTER_NAME} \
        --project=${PROJECT_ID}
    
  3. 클러스터 관리자 권한을 현재 사용자에게 부여합니다. Anthos Service Mesh에 필요한 역할 기반 액세스 제어(RBAC) 규칙을 만들려면 이러한 권한이 필요합니다.

    kubectl create clusterrolebinding cluster-admin-binding \
      --clusterrole=cluster-admin \
      --user="$(gcloud config get-value core/account)"

"cluster-admin-binding" already exists 오류가 표시되면 안전하게 무시하고 기존 cluster-admin-binding을 계속 진행할 수 있습니다.

설치 파일 다운로드

    Linux

  1. Anthos Service Mesh 설치 파일을 현재 작업 디렉터리에 다운로드합니다.
    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.7.6-asm.1-linux-amd64.tar.gz
  2. 서명 파일을 다운로드하고 openssl을 사용하여 서명을 확인합니다.
    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.7.6-asm.1-linux-amd64.tar.gz.1.sig
    openssl dgst -verify /dev/stdin -signature istio-1.7.6-asm.1-linux-amd64.tar.gz.1.sig istio-1.7.6-asm.1-linux-amd64.tar.gz <<'EOF'
    -----BEGIN PUBLIC KEY-----
    MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
    wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
    -----END PUBLIC KEY-----
    EOF

    예상되는 출력은 Verified OK입니다.

  3. 원하는 파일 시스템 위치에 파일 콘텐츠 압축을 풉니다. 예를 들어 콘텐츠를 현재 작업 디렉터리에 추출하려면 다음을 사용하세요.
    tar xzf istio-1.7.6-asm.1-linux-amd64.tar.gz

    이 명령어는 다음을 포함하는 현재 작업 디렉터리에 istio-1.7.6-asm.1이라는 설치 디렉터리를 만듭니다.

    • 샘플 애플리케이션은 samples 디렉터리에 있습니다.
    • Anthos Service Mesh를 설치하는 데 사용하는 istioctl 명령줄 도구는 bin 디렉터리에 있습니다.
    • Anthos Service Mesh 구성 프로필은 manifests/profiles 디렉터리에 있습니다.

  4. MacOS

  5. Anthos Service Mesh 설치 파일을 현재 작업 디렉터리에 다운로드합니다.
    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.7.6-asm.1-osx.tar.gz
  6. 서명 파일을 다운로드하고 openssl을 사용하여 서명을 확인합니다.
    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.7.6-asm.1-osx.tar.gz.1.sig
    openssl dgst -sha256 -verify /dev/stdin -signature istio-1.7.6-asm.1-osx.tar.gz.1.sig istio-1.7.6-asm.1-osx.tar.gz <<'EOF'
    -----BEGIN PUBLIC KEY-----
    MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
    wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
    -----END PUBLIC KEY-----
    EOF

    예상되는 출력은 Verified OK입니다.

  7. 원하는 파일 시스템 위치에 파일 콘텐츠 압축을 풉니다. 예를 들어 콘텐츠를 현재 작업 디렉터리에 추출하려면 다음을 사용하세요.
    tar xzf istio-1.7.6-asm.1-osx.tar.gz

    이 명령어는 다음을 포함하는 현재 작업 디렉터리에 istio-1.7.6-asm.1이라는 설치 디렉터리를 만듭니다.

    • 샘플 애플리케이션은 samples 디렉터리에 있습니다.
    • Anthos Service Mesh를 설치하는 데 사용하는 istioctl 명령줄 도구는 bin 디렉터리에 있습니다.
    • Anthos Service Mesh 구성 프로필은 manifests/profiles 디렉터리에 있습니다.

  8. Windows

  9. Anthos Service Mesh 설치 파일을 현재 작업 디렉터리에 다운로드합니다.
    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.7.6-asm.1-win.zip
  10. 서명 파일을 다운로드하고 openssl을 사용하여 서명을 확인합니다.
    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.7.6-asm.1-win.zip.1.sig
    openssl dgst -verify - -signature istio-1.7.6-asm.1-win.zip.1.sig istio-1.7.6-asm.1-win.zip <<'EOF'
    -----BEGIN PUBLIC KEY-----
    MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
    wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
    -----END PUBLIC KEY-----
    EOF

    예상되는 출력은 Verified OK입니다.

  11. 원하는 파일 시스템 위치에 파일 콘텐츠 압축을 풉니다. 예를 들어 콘텐츠를 현재 작업 디렉터리에 추출하려면 다음을 사용하세요.
    tar xzf istio-1.7.6-asm.1-win.zip

    이 명령어는 다음을 포함하는 현재 작업 디렉터리에 istio-1.7.6-asm.1이라는 설치 디렉터리를 만듭니다.

    • 샘플 애플리케이션은 samples 디렉터리에 있습니다.
    • Anthos Service Mesh를 설치하는 데 사용하는 istioctl 명령줄 도구는 bin 디렉터리에 있습니다.
    • Anthos Service Mesh 구성 프로필은 manifests/profiles 디렉터리에 있습니다.

  12. Anthos Service Mesh 설치 루트 디렉터리에 있는지 확인합니다.
    cd istio-1.7.6-asm.1
  13. 편의를 위해 /bin 디렉터리의 도구를 PATH에 추가합니다.
    export PATH=$PWD/bin:$PATH

리소스 구성 파일 준비

istioctl install 명령어를 실행할 때 명령줄에서 -f istio-operator.yaml을 지정합니다. 이 파일에는 Anthos Service Mesh에 필요한 프로젝트 및 클러스터에 대한 정보가 포함되어 있습니다. 프로젝트와 클러스터 정보를 설정할 수 있도록 istio-operator.yaml 및 기타 리소스 구성 파일이 포함된 패키지를 다운로드해야 합니다.

리소스 구성 파일을 준비하려면 다음 안내를 따르세요.

Mesh CA

  1. Anthos Service Mesh 패키지 리소스 구성 파일을 위한 새 디렉터리를 만듭니다. 클러스터 이름을 디렉터리 이름으로 사용하는 것이 좋습니다.

  2. Anthos Service Mesh 패키지를 다운로드할 디렉터리로 변경합니다.

  3. 패키지를 다운로드합니다.

    kpt pkg get \
    https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/asm@release-1.7-asm asm
    
  4. 클러스터가 생성된 프로젝트의 프로젝트 ID를 설정합니다.

    kpt cfg set asm gcloud.core.project ${PROJECT_ID}
    
  5. Environ 호스트 프로젝트의 프로젝트 번호를 설정합니다.

    kpt cfg set asm gcloud.project.environProjectNumber ${ENVIRON_PROJECT_NUMBER}
    
  6. 클러스터 이름을 설정합니다.

    kpt cfg set asm gcloud.container.cluster ${CLUSTER_NAME}
    
  7. 기본 영역 또는 리전을 설정합니다.

    kpt cfg set asm gcloud.compute.location ${CLUSTER_LOCATION}
    
  8. 유효성 검증 웹훅이 버전 라벨을 사용하도록 설정합니다.

    kpt cfg set asm anthos.servicemesh.rev asm-176-1
    

    Anthos Service Mesh를 설치할 때 istiod에 버전 라벨을 설정합니다. 웹훅을 검증할 때 동일한 버전을 설정해야 합니다.

  9. 멀티 클러스터 구성의 클러스터가 다른 프로젝트에 있으므로 멀티 클러스터/멀티 프로젝트서비스 메시를 구성하는 다른 프로젝트에 신뢰할 수 있는 도메인 별칭을 구성해야 합니다.

    1. 멀티 클러스터/멀티 프로젝트 메시에 포함될 모든 클러스터의 프로젝트 ID를 가져옵니다.

    2. 클러스터의 프로젝트 ID마다 신뢰할 수 있는 도메인 별칭을 설정합니다. 예를 들어 프로젝트 3개에 클러스터가 있으면 다음 명령어를 실행하고 PROJECT_ID_1, PROJECT_ID_2, PROJECT_ID_3을 각 클러스터의 프로젝트 ID로 바꿉니다.

      kpt cfg set asm anthos.servicemesh.trustDomainAliases PROJECT_ID_1.svc.id.goog PROJECT_ID_2.svc.id.goog PROJECT_ID_3.svc.id.goog

      다른 프로젝트에서 클러스터를 구성할 때 동일한 명령어를 사용할 수 있습니다.

      신뢰할 수 있는 도메인 별칭을 사용하면 Mesh CA가 다른 프로젝트의 클러스터에 있는 워크로드를 인증할 수 있습니다. 신뢰할 수 있는 도메인 별칭 설정 외에도 Anthos Service Mesh를 설치한 후에는 교차 클러스터 부하 분산을 사용 설정해야 합니다.

  10. kpt setter의 값을 출력합니다.

    kpt cfg list-setters asm
    

    이 명령어 출력은 다음과 비슷합니다.

                              NAME                                                       VALUE
    anthos.servicemesh.canonicalServiceHub               gcr.io/gke-release/asm/canonical-service-controller:1.7.6-asm.1
    anthos.servicemesh.controlplane.monitoring.enabled   true
    anthos.servicemesh.hub                               gcr.io/gke-release/asm
    anthos.servicemesh.hubMembershipID                   MEMBERSHIP_ID
    anthos.servicemesh.tag                               1.7.6-asm.1
    anthos.servicemesh.trustDomainAliases                [example-project-12345.svc.id.goog,example-project-23456.svc.id.goog,example-project-98765.svc.id.goog]
    base-dir                                             base
    gcloud.compute.location                              us-central
    gcloud.compute.network                               default
    gcloud.compute.subnetwork                            default
    gcloud.container.cluster                             example-cluster-1
    gcloud.container.cluster.clusterSecondaryRange
    gcloud.container.cluster.releaseChannel              REGULAR
    gcloud.container.cluster.servicesSecondaryRange
    gcloud.container.nodepool.max-nodes                  4
    gcloud.core.project                                  example-project-12345
    gcloud.project.environProjectID                      ENVIRON_PROJECT_ID
    gcloud.project.environProjectNumber                  1234567890123
    gcloud.project.projectNumber                         9876543210987

    다음 setter의 값이 올바른지 확인합니다.

    • anthos.servicemesh.trustDomainAliases
    • gcloud.compute.location
    • gcloud.container.cluster
    • gcloud.core.project
    • gcloud.project.environProjectNumber

    다른 setter의 값은 무시해도 됩니다.

Citadel

  1. Anthos Service Mesh 패키지 리소스 구성 파일을 위한 새 디렉터리를 만듭니다. 클러스터 이름을 디렉터리 이름으로 사용하는 것이 좋습니다.

  2. Anthos Service Mesh 패키지를 다운로드할 디렉터리로 변경합니다.

  3. 패키지를 다운로드합니다.

    kpt pkg get \
    https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/asm@release-1.7-asm asm
    
  4. 클러스터가 생성된 프로젝트의 프로젝트 ID를 설정합니다.

    kpt cfg set asm gcloud.core.project ${PROJECT_ID}
    
  5. Environ 호스트 프로젝트의 프로젝트 번호를 설정합니다.

    kpt cfg set asm gcloud.project.environProjectNumber ${ENVIRON_PROJECT_NUMBER}
    
  6. 클러스터 이름을 설정합니다.

    kpt cfg set asm gcloud.container.cluster ${CLUSTER_NAME}
    
  7. 기본 영역 또는 리전을 설정합니다.

    kpt cfg set asm gcloud.compute.location ${CLUSTER_LOCATION}
    
  8. kpt setter의 값을 출력합니다.

    kpt cfg list-setters asm
    

    이 명령어 출력은 다음과 비슷합니다.

                              NAME                                                       VALUE
    anthos.servicemesh.canonicalServiceHub               gcr.io/gke-release/asm/canonical-service-controller:1.7.6-asm.1
    anthos.servicemesh.controlplane.monitoring.enabled   true
    anthos.servicemesh.hub                               gcr.io/gke-release/asm
    anthos.servicemesh.hubMembershipID                   MEMBERSHIP_ID
    anthos.servicemesh.tag                               1.7.6-asm.1
    anthos.servicemesh.trustDomainAliases
    base-dir                                             base
    gcloud.compute.location                              us-central
    gcloud.compute.network                               default
    gcloud.compute.subnetwork                            default
    gcloud.container.cluster                             example-cluster-1
    gcloud.container.cluster.clusterSecondaryRange
    gcloud.container.cluster.releaseChannel              REGULAR
    gcloud.container.cluster.servicesSecondaryRange
    gcloud.container.nodepool.max-nodes                  4
    gcloud.core.project                                  example-project-12345
    gcloud.project.environProjectID                      ENVIRON_PROJECT_ID
    gcloud.project.environProjectNumber                  1234567890123
    gcloud.project.projectNumber                         9876543210987

    다음 setter의 값이 올바른지 확인합니다.

    • gcloud.compute.location
    • gcloud.container.cluster
    • gcloud.core.project
    • gcloud.project.environProjectNumber

    다른 setter의 값은 무시해도 됩니다.

Anthos Service Mesh로 마이그레이션

Istio에서 마이그레이션하려면 이중 제어 영역 업그레이드 프로세스(Istio 문서에서는 카나리아 업그레이드라고 함)를 따릅니다. 이중 제어 영역 업그레이드를 사용하는 경우 기존 제어 영역과 함께 새 버전의 제어 영역을 설치합니다. 새 버전을 설치할 때 새 제어 영역의 버전을 식별하는 revision 라벨을 포함합니다. 각 버전은 자체 배포 및 서비스로 구현된 전체 Anthos Service Mesh 제어 영역입니다.

그런 다음 워크로드의 동일한 revision 라벨이 새 제어 영역을 가리키도록 설정하고 순차적 재시작을 수행하여 새 Anthos Service Mesh 버전으로 프록시를 다시 삽입합니다. 이 방식을 사용하면 일부 워크로드에서 업그레이드의 효과를 모니터링할 수 있습니다. 애플리케이션을 테스트한 후 모든 트래픽을 새 버전으로 마이그레이션할 수 있습니다. 이 방식은 새로운 제어 영역이 이전 버전의 제어 영역을 즉시 대체하는 인플레이스(In-Place) 업그레이드보다 훨씬 안전합니다.

제어 영역 업데이트

Mesh CA

  1. 현재 kubeconfig 컨텍스트가 Anthos Service Mesh를 설치할 클러스터를 가리키는지 확인합니다.

    kubectl config current-context
    

    출력은 다음 형식입니다.

    gke_PROJECT_ID_CLUSTER_LOCATION_CLUSTER_NAME

    kubeconfig 컨텍스트와 kpt setter의 값이 일치해야 합니다. 필요한 경우 gcloud container clusters get-credentials 명령어를 실행하여 현재 kubeconfig 컨텍스트를 설정합니다.

  2. 다음 명령어를 실행하여 asm-gcp-multiproject 프로필로 새 제어 영역을 배포합니다. 지원되는 선택 기능을 사용 설정하려면 다음 명령줄에 -f와 YAML 파일 이름을 포함합니다. 자세한 내용은 선택 기능 사용 설정을 참조하세요.

    istioctl install \
      -f asm/istio/istio-operator.yaml \
      -f asm/istio/options/multiproject.yaml \
      -f asm/istio/options/multicluster.yaml\
      --revision=asm-176-1
    

    --revision 인수는 istio.io/rev=asm-176-1 형식의 버전 라벨을 istiod에 추가합니다. 버전 라벨은 자동 사이드카 인젝터 웹훅에서 삽입된 사이드카를 특정 istiod 버전과 연결하는 데 사용됩니다. 네임스페이스에 사이드카 자동 삽입을 사용 설정하려면 istiod 배포와 일치하는 버전으로 라벨을 지정해야 합니다.

    다음 파일은 istio-operator.yaml 파일의 설정을 재정의합니다.

    • multiproject.yaml 파일은 asm-gcp-multiproject 프로필을 설정합니다.

    • multicluster.yaml 파일은 Anthos Service Mesh 멀티 클러스터 구성에 필요한 설정을 구성합니다.

Citadel

  1. 현재 kubeconfig 컨텍스트가 Anthos Service Mesh를 설치할 클러스터를 가리키는지 확인합니다.

    kubectl config current-context
    

    출력은 다음 형식입니다.

    gke_PROJECT_ID_CLUSTER_LOCATION_CLUSTER_NAME

    kubeconfig 컨텍스트와 kpt setter의 값이 일치해야 합니다. 필요한 경우 gcloud container clusters get-credentials 명령어를 실행하여 현재 kubeconfig 컨텍스트를 설정합니다.

  2. 다음 명령어를 실행하여 asm-gcp-multiproject 프로필로 새 제어 영역을 배포합니다. 지원되는 선택 기능을 사용 설정하려면 다음 명령줄에 -f와 YAML 파일 이름을 포함합니다. 자세한 내용은 선택 기능 사용 설정을 참조하세요.

    istioctl install \
      -f asm/istio/istio-operator.yaml \
      -f asm/istio/options/citadel-ca.yaml \
      -f asm/istio/options/multiproject.yaml \
      -f asm/istio/options/multicluster.yaml\
      --revision=asm-176-1
    

    --revision 인수는 istio.io/rev=asm-176-1 형식의 버전 라벨을 istiod에 추가합니다. 버전 라벨은 자동 사이드카 인젝터 웹훅에서 삽입된 사이드카를 특정 istiod 버전과 연결하는 데 사용됩니다. 네임스페이스에 사이드카 자동 삽입을 사용 설정하려면 istiod 배포와 일치하는 버전으로 라벨을 지정해야 합니다.

    다음 파일은 istio-operator.yaml 파일의 설정을 재정의합니다.

    • citadel-ca.yaml은 Citadel을 CA로 구성합니다.

    • multiproject.yaml 파일은 asm-gcp-multiproject 프로필을 설정합니다.

    • multicluster.yaml 파일은 Anthos Service Mesh 멀티 클러스터 구성에 필요한 설정을 구성합니다.

명령어를 실행하면 두 개의 제어 영역 배포와 서비스가 나란히 실행됩니다.

kubectl get pods -n istio-system

출력 예시:

NAME                                        READY   STATUS    RESTARTS   AGE
istio-ingressgateway-c56675fcd-86zdn        1/1     Running   0          2m9s
istio-ingressgateway-c56675fcd-vn4nv        1/1     Running   0          2m21s
istiod-asm-176-1-6d5cfd4b89-xztlr           1/1     Running   0          3m44s
istiod-fb7f746f4-wcntn                      1/1     Running   0          50m

워크로드 재배포

새 버전을 설치해도 기존 사이드카 프록시에는 영향을 미치지 않습니다. 기존 사이드카 프록시를 업그레이드하려면 새 제어 영역을 가리키도록 구성해야 합니다. 사이드카 삽입 중에는 네임 스페이스 라벨 istio.io/rev를 기반으로 제어됩니다.

  1. 새로운 Anthos Service Mesh 버전으로 삽입되도록 워크로드를 업데이트합니다.

    kubectl label namespace NAMESPACE istio-injection- istio.io/rev=asm-176-1 --overwrite

    istio-injection 라벨은 istio.io/rev 라벨보다 우선하므로 삭제해야 합니다.

  2. pod를 다시 시작하여 다시 삽입을 트리거합니다.

    kubectl rollout restart deployment -n NAMESPACE
  3. pod가 istiod-asm-176-1 제어 영역을 가리키도록 구성되어 있는지 확인합니다.

    kubectl get pods -n NAMESPACE -l istio.io/rev=asm-176-1

  4. 애플리케이션을 테스트하여 워크로드가 올바르게 작동하는지 확인합니다.

  5. 다른 네임스페이스에 워크로드가 있으면 각 네임스페이스에 이전 단계를 반복합니다.

  6. 애플리케이션이 예상대로 작동한다고 판단되면 마이그레이션 완료로 건너뜁니다. 그렇지 않으면 다음 단계를 수행하여 이전 버전으로 롤백합니다.

    롤백하려면 다음 안내를 따르세요.

    1. 제어 영역의 이전 버전으로 삽입되도록 워크로드를 업데이트합니다.

      kubectl label namespace NAMESPACE istio.io/rev- istio-injection=enabled --overwrite
    2. Pod를 다시 시작하여 프록시에 이전 버전이 지정되도록 다시 삽입을 트리거합니다.

      kubectl rollout restart deployment -n NAMESPACE
    3. istio-ingressgateway의 이전 버전을 다시 배포합니다.

      kubectl -n istio-system rollout undo deploy istio-ingressgateway
      
    4. 새 제어 영역을 삭제합니다.

      kubectl delete Service,Deployment,HorizontalPodAutoscaler,PodDisruptionBudget istiod-asm-176-1 -n istio-system --ignore-not-found=true
      

마이그레이션 완료

애플리케이션이 예상대로 작동한다고 판단되면 다음 단계를 수행하여 Anthos Service Mesh로의 마이그레이션을 완료합니다.

  1. 이전 제어 영역을 삭제합니다.

    kubectl delete Service,Deployment,HorizontalPodAutoscaler,PodDisruptionBudget istiod -n istio-system --ignore-not-found=true
    

클러스터 등록

Cloud Console에서 통합 사용자 인터페이스에 액세스하려면 프로젝트의 Environ에 클러스터를 등록해야 합니다. Environ은 Google Cloud 외부의 클러스터를 포함하여 클러스터와 워크로드를 보고 관리하는 통합된 방법을 제공합니다.

클러스터 등록에 대한 자세한 내용은 Environ에 클러스터 등록을 참조하세요.

다음 단계