이 페이지에서는 Anthos Service Mesh에 필요한 옵션을 사용하여 기존 GKE 클러스터를 설정하는 방법을 설명합니다. 다른 Google Cloud 프로젝트의 클러스터를 Anthos Service Mesh에 추가하려면 클러스터가 공유 Virtual Private Cloud(VPC)에 있어야 합니다. 자세한 내용은 공유 VPC를 사용하여 클러스터 설정을 참조하세요.
1.9 or a 1.10 patch release에서 업그레이드하는 경우 프로젝트 및 클러스터 요구사항은 변경되지 않습니다. 업그레이드하려면 다중 프로젝트 업그레이드를 참조하세요.
시작하기 전에
클러스터 설정을 시작하기 전에 다음을 확인합니다.
기존 클러스터 설정
다음의 환경 변수를 만듭니다.
클러스터 이름을 설정합니다.
export CLUSTER_NAME=YOUR_CLUSTER_NAME
CLUSTER_LOCATION
을 클러스터 영역 또는 클러스터 리전으로 설정합니다.export CLUSTER_LOCATION=YOUR_ZONE_OR_REGION
워크로드 풀을 설정합니다.
export WORKLOAD_POOL=${PROJECT_ID}.svc.id.goog
메시 ID를 설정합니다.
export MESH_ID="proj-${FLEET_PROJECT_NUMBER}"
Google Cloud CLI의 기본 영역 또는 리전을 설정합니다. 여기서 기본값을 설정하지 않으면 이 페이지의
gcloud container clusters
명령어에--zone
또는--region
옵션을 지정해야 합니다.단일 영역 클러스터가 있는 경우 기본 영역을 설정합니다.
gcloud config set compute/zone ${CLUSTER_LOCATION}
리전 클러스터가 있는 경우 기본 리전을 설정합니다.
gcloud config set compute/region ${CLUSTER_LOCATION}
팁: 나중에 셸 환경을 더 쉽게 설정할 수 있도록 각 환경 변수의
export
문을 복사하여 새로운 셸을 시작할 때source
로 사용하는 간단한 셸 스크립트에 붙여넣습니다. 또한 스크립트에 기본값을 설정하는gcloud
명령어를 추가할 수 있습니다. 또는gcloud init
를 사용하여 이름이 지정된gcloud
구성을 만들고 활성화할 수 있습니다.클러스터에
mesh_id
라벨을 설정합니다. 클러스터에 보존하려는 기존 라벨이 있으면mesh_id
라벨을 추가할 때 이러한 라벨을 포함해야 합니다.클러스터에 기존 라벨이 있는지 확인하려면 다음 안내를 따르세요.
gcloud container clusters describe ${CLUSTER_NAME} \ --project ${PROJECT_ID}
출력에서
resourceLabels
필드를 찾습니다. 각 라벨은resourceLabels
필드 아래에 있는 별도의 줄에 저장됩니다. 예를 들면 다음과 같습니다.resourceLabels: csm: '' env: dev release: stable
csm
라벨이 출력에 있는 경우 보존할 필요가 없습니다.mesh_id
라벨은csm
라벨을 바꿉니다.편의를 위해 환경 변수에 라벨을 추가할 수 있습니다. 다음에서
YOUR_EXISTING_LABELS
를 쉼표로 구분된 클러스터의 기존 라벨 목록을KEY=VALUE
(예:env=dev,release=stable
)로 바꿉니다.export EXISTING_LABELS="YOUR_EXISTING_LABELS"
mesh_id
라벨을 설정합니다.클러스터에 보존하려는 기존 라벨이 있으면
mesh_id
와 기존 라벨을 사용하여 클러스터를 업데이트합니다.gcloud container clusters update ${CLUSTER_NAME} \ --project ${PROJECT_ID} \ --update-labels=mesh_id=${MESH_ID},${EXISTING_LABELS}
클러스터에 기존 라벨이 없는 경우
mesh_id
라벨로만 클러스터를 업데이트합니다.gcloud container clusters update ${CLUSTER_NAME} \ --project=${PROJECT_ID} \ --update-labels=mesh_id=${MESH_ID}
워크로드 아이덴티티를 사용 설정합니다.
gcloud container clusters update ${CLUSTER_NAME} \ --project=${PROJECT_ID} \ --workload-pool=${WORKLOAD_POOL}
워크로드 아이덴티티를 사용 설정하는 데 최대 10~15분이 걸릴 수 있습니다.
GKE에서 Cloud Monitoring 및 Cloud Logging을 사용 설정합니다.
gcloud container clusters update ${CLUSTER_NAME} \ --project=${PROJECT_ID} \ --enable-stackdriver-kubernetes