이 페이지에서는 Google Distributed Cloud 클러스터 리소스를 만들고 관리하는 방법을 설명합니다.
Distributed Cloud 클러스터에 대한 자세한 내용은 Distributed Cloud 작동 방식을 참고하세요.
Distributed Cloud 1.5.x의 로컬 컨트롤 플레인 클러스터
Google에서 Distributed Cloud 배포를 버전 1.5.0 이상으로 업데이트한 후에는 Distributed Cloud 버전 1.4.0으로 만든 모든 로컬 컨트롤 플레인 클러스터를 수동으로 삭제하고 다시 만들어야 합니다. 그렇지 않으면 예기치 않은 동작과 데이터 손실이 발생할 수 있습니다. 클라우드 컨트롤 플레인을 사용하도록 구성된 클러스터는 Google에서 Distributed Cloud 배포를 버전 1.5.0 이상으로 업데이트한 후에도 정상적으로 계속 실행됩니다.
클러스터 만들기
Distributed Cloud 클러스터를 만들려면 이 섹션의 단계를 완료하세요. 클러스터 생성은 Distributed Cloud에 워크로드를 배포하는 데 필요한 여러 단계 중 하나입니다.
Google Cloud에서 일시적으로 연결이 해제된 동안 워크로드를 실행할 수 있는 로컬 컨트롤 플레인으로 클러스터를 만들려면 먼저 생존 가능성 모드를 읽으세요.
이 작업을 완료하려면 Google Cloud 프로젝트에Edge Container 관리자 역할(roles/edgecontainer.admin)이 있어야 합니다.
Distributed Cloud 소프트웨어 버전 1.5.0을 실행하는 로컬 제어 영역 클러스터를 만들려면 Google Cloud SDK를 버전 450.0.0 이상으로 업그레이드해야 합니다. 그렇지 않으면 이러한 클러스터를 만들 수 없습니다.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
클러스터 만들기를 클릭합니다.
클러스터 만들기 페이지에서 온프레미스 탭을 클릭합니다.
Distributed Cloud Edge 옵션 옆에 있는 구성을 클릭합니다.
클러스터 기본사항 페이지에서 다음 정보를 입력합니다.
- 이름: 이 클러스터를 식별하는 고유한 이름입니다. 이 이름은 RFC 1213을 준수해야 하며 소문자 영숫자 문자와 하이픈 (
-)으로만 구성되어야 합니다. 영숫자 문자로 시작하고 끝나야 합니다. - 위치: 이 클러스터를 만들 Google Cloud 리전입니다.
- 노드당 기본 최대 포드 수: 이 클러스터의 각 노드에서 실행할 원하는 최대 Kubernetes 포드 수입니다.
- 라벨: 라벨 추가를 클릭하여 이 클러스터에 라벨을 하나 이상 추가할 수 있습니다.
- 이름: 이 클러스터를 식별하는 고유한 이름입니다. 이 이름은 RFC 1213을 준수해야 하며 소문자 영숫자 문자와 하이픈 (
왼쪽 탐색 메뉴에서 네트워킹을 클릭합니다.
네트워킹 페이지에서 다음 정보를 입력합니다.
- 클러스터 기본 포드 주소 범위: 이 클러스터에서 실행되는 Kubernetes 포드의 원하는 IPv4 CIDR 블록입니다.
- 서비스 주소 범위: 이 클러스터에서 실행되는 Kubernetes 서비스의 원하는 IPv4 CIDR 블록입니다.
자세한 내용은 분산 클라우드 포드 및 서비스 네트워크 주소 할당을 참고하세요.
왼쪽 탐색 메뉴에서 승인을 클릭합니다.
승인 페이지에서 클러스터 리소스를 수정할 권한이 있는 타겟 Google Cloud 프로젝트 내 사용자 계정의 이름을 입력합니다.
왼쪽 탐색 메뉴에서 유지관리 정책을 클릭합니다.
유지보수 정책 페이지에서 다음 정보를 입력합니다.
- 유지보수 기간 사용 설정: 이 체크박스를 선택하여 클러스터의 유지보수 기간을 구성합니다. Distributed Cloud 소프트웨어 업데이트로 인해 예기치 않은 다운타임이 발생하지 않도록 하려면 만드는 각 Distributed Cloud 클러스터에 대해 항상 유지보수 기간을 구성하는 것이 좋습니다. 자세한 내용은 소프트웨어 업데이트 및 유지보수 기간 이해를 참고하세요.
- 시작 시간: 이 클러스터의 유지보수 기간이 시작되기를 원하는 날짜와 시간입니다.
- 종료 시간: 이 클러스터의 유지보수 기간이 종료되는 원하는 날짜와 시간입니다.
- RRule:
FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU형식의 유지보수 기간 빈도입니다.FREQ은DAILY또는WEEKLY일 수 있습니다.BYDAY:FREQ이WEEKLY로 설정된 경우 유지보수가 발생할 수 있는 쉼표로 구분된 요일 목록입니다.BYDAY매개변수를 생략하면 Google에서 요일을 선택합니다.FREQ을DAILY로 설정하면 지정된 시간에 매일 유지보수 기간이 발생합니다.
다음 중 하나를 수행하여 클러스터에 노드 풀을 할당합니다.
- 이 클러스터에 기존 노드 풀을 할당하려면 왼쪽 탐색의 노드 풀 섹션에서 기존 노드 풀을 선택하고 노드 풀 세부정보 페이지의 노드 풀 구성이 올바른지 확인합니다.
- 이 클러스터에 할당할 새 노드 풀을 만들려면 노드 풀 추가를 클릭하고 노드 풀 세부정보 페이지에서 다음 정보를 제공합니다.
- 노드 풀 이름: 이 노드 풀을 식별하는 고유한 이름입니다.
- 노드 풀 라벨: 라벨 추가를 클릭하여 이 노드 풀에 하나 이상의 라벨을 추가합니다.
- 워커 노드 환경설정: 이 노드 풀에 할당할 Distributed Cloud 노드를 선택합니다.
만들기를 클릭하여 Distributed Cloud 클러스터를 만듭니다.
gcloud
gcloud edge-cloud container clusters create 명령어를 사용합니다.
gcloud edge-cloud container clusters create CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION \
--fleet-project=FLEET_PROJECT_ID \
--cluster-ipv4-cidr=CLUSTER_IPV4_CIDR_BLOCK \
--services-ipv4-cidr=SERVICE_IPV4_CIDR_BLOCK \
--default-max-pods-per-node=MAX_PODS_PER_NODE \
--release-channel RELEASE_CHANNEL \
--control-plane-kms-key=CONTROL_PLANE_KMS_KEY \
--control-plane-node-location=CONTROL_PLANE_LOCATION \
--control-plane-node-count=CONTROL_PLANE_NODE_COUNT \
--control-plane-machine-filter=CONTROL_PLANE_NODE_FILTER \
--control-plane-shared-deployment-policy=CONTROL_PLANE_NODE_SHARING \
--external-lb-ipv4-address-pools=IPV4_DATA_PLANE_ADDRESSES \
--version SOFTWARE_VERSION
다음을 바꿉니다.
CLUSTER_ID: 이 클러스터를 식별하는 고유한 이름입니다. 이 이름은 RFC 1213을 준수해야 하며 소문자 영숫자 문자와 하이픈 (-)으로만 구성되어야 합니다. 영숫자 문자로 시작하고 끝나야 합니다.PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 클러스터가 생성되고 클러스터의 Kubernetes 컨트롤 플레인이 프로비저닝되는 Google Cloud 리전입니다.FLEET_PROJECT_ID: 클러스터가 등록된 Fleet 호스트 프로젝트의 ID입니다. 이 플래그를 생략하면 Distributed Cloud 클러스터 프로젝트가 Fleet 호스트 프로젝트로 사용됩니다.CLUSTER_IPV4_CIDR_BLOCK: 이 클러스터에서 실행되는 Kubernetes 포드의 원하는 IPv4 CIDR 블록입니다.SERVICE_IPV4_CIDR_BLOCK: 이 클러스터에서 실행되는 Kubernetes 서비스의 원하는 IPv4 CIDR 블록입니다.MAX_PODS_PER_NODE(선택사항): 이 클러스터의 각 노드에서 실행할 원하는 최대 Kubernetes 포드 수입니다.RELEASE_CHANNEL: (선택사항) 이 클러스터에서 실행할 Distributed Cloud 소프트웨어 버전의 출시 채널을 지정합니다. 유효한 값은REGULAR(자동 클러스터 업그레이드 사용 설정) 및NONE(자동 클러스터 업그레이드 사용 중지)입니다. 생략하면 기본값은REGULAR입니다.CONTROL_PLANE_KMS_KEY(선택사항): 이 클러스터의 컨트롤 플레인 노드와 함께 사용할 Cloud KMS 키의 전체 경로입니다. 예를 들면 다음과 같습니다./projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
이 플래그는 로컬 스토리지에 고객 관리 암호화 키 (CMEK) 지원 사용 설정에 설명된 대로 Distributed Cloud를 Cloud Key Management Service와 통합한 경우에만 적용됩니다.
로컬 컨트롤 플레인으로 클러스터를 만드는 경우 이전 변수를 바꾸는 것 외에도 다음을 바꿔야 합니다.
CONTROL_PLANE_LOCATION: Distributed Cloud에 이 클러스터의 컨트롤 플레인 워크로드를 로컬로 배포하도록 지시합니다. 값은 대상 Distributed Cloud 영역의 이름입니다.CONTROL_PLANE_NODE_COUNT(선택사항): 로컬 컨트롤 플레인 워크로드를 실행할 노드 수를 지정합니다. 유효한 값은 고가용성의 경우3, 표준 작업의 경우1입니다. 생략하면 기본값은3입니다.CONTROL_PLANE_NODE_FILTER(선택사항): 로컬 컨트롤 플레인 워크로드를 실행하는 노드의 정규식 형식 목록을 지정합니다. 생략하면 Distributed Cloud에서 무작위로 노드를 자동으로 선택합니다.CONTROL_PLANE_NODE_SHARING: (선택사항) 애플리케이션 워크로드가 로컬 컨트롤 플레인 워크로드를 실행하는 노드에서 실행될 수 있는지 여부를 지정합니다. 유효한 값은DISALLOWED,ALLOWED입니다. 생략할 경우 기본값은DISALLOWED입니다.IPV4_DATA_PLANE_ADDRESSES: 클러스터가 생존 모드로 실행될 때 분산 클라우드 부하 분산기 뒤에서 실행되는 서비스의 수신 트래픽에 대한 쉼표로 구분된 IPv4 주소, 주소 범위 또는 서브넷 목록을 지정합니다.SOFTWARE_VERSION: 이 클러스터가 실행할 Distributed Cloud 소프트웨어 버전을 지정합니다. 형식은1.X.Y입니다. 여기서X는 부 버전이고Y는 패치 버전입니다(예:1.5.0). 생략하면 서버 기본 소프트웨어 버전이 기본값으로 설정되며, 이는 일반적으로 사용 가능한 최신 버전의 Distributed Cloud입니다. 서버 기본 버전을 비롯해 클러스터 생성에 사용할 수 있는 소프트웨어 버전을 확인하려면 클러스터에 사용할 수 있는 소프트웨어 버전 가져오기를 참고하세요.
API
projects.locations.clusters 메서드에 대해 POST 요청을 실행합니다.
POST /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&requestId=REQUEST_ID&fleetId=FLEET_PROJECT_ID
{
"labels": { LABELS,
},
"authorization": {
"adminUsers": {
"username": "USERNAME"
}
},
"fleet": {
"project": "FLEET_PROJECT_ID"
},
"networking": {
"clusterIpv4CidrBlocks": CLUSTER_IPV4_CIDR_BLOCK,
"servicesIpv4CidrBlocks": SERVICE_IPV4_CIDR_BLOCK,
},
"defaultMaxPodsPerNode": MAX_PODS_PER_NODE,
"releaseChannel": "RELEASE_CHANNEL",
"controlPlaneEncryption": {
"kmsKey": CONTROL_PLANE_KMS_KEY,
},
"controlPlane": {
"local": {
"nodeLocation": "CONTROL_PLANE_LOCATION",
"nodeCount": CONTROL_PLANE_NODE_COUNT,
"machineFilter": "CONTROL_PLANE_NODE_FILTER",
"sharedDeploymentPolicy": "CONTROL_PLANE_NODE_SHARING"
}
},
"externalLoadBalancerIpv4AddressPools": [
"IPV4_DATA_PLANE_ADDRESSES"
],
"targetVersion": "SOFTWARE_VERSION",
}
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 대상 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.CLUSTER_ID: 이 클러스터를 식별하는 고유한 이름입니다. 이 이름은 RFC 1213을 준수해야 하며 소문자 영숫자 문자와 하이픈 (-)으로만 구성되어야 합니다. 영숫자 문자로 시작하고 끝나야 합니다.REQUEST_ID: 이 요청을 식별하는 고유한 프로그래매틱 ID입니다.FLEET_PROJECT_ID: 클러스터가 등록된 Fleet 호스트 프로젝트의 ID입니다. 별도의 프로젝트이거나 이 클러스터가 속한 Distributed Cloud 프로젝트 (PROJECT_ID)일 수 있습니다. Fleet 등록은 필수입니다.LABELS: 이 클러스터 리소스에 적용할 라벨 목록입니다.USERNAME: 클러스터 리소스를 수정할 권한이 있는 타겟 Google Cloud 프로젝트 내 사용자 계정의 이름입니다.CLUSTER_IPV4_CIDR_BLOCK: 이 클러스터에서 실행되는 Kubernetes 포드의 원하는 IPv4 CIDR 블록입니다.SERVICE_IPV4_CIDR_BLOCK: 이 클러스터에서 실행되는 Kubernetes 서비스의 원하는 IPv4 CIDR 블록입니다.MAX_PODS_PER_NODE: 이 클러스터의 각 노드에서 실행할 원하는 최대 Kubernetes 포드 수입니다.RELEASE_CHANNEL: 이 클러스터에서 실행할 Distributed Cloud 소프트웨어의 버전에 대한 출시 채널을 지정합니다. 유효한 값은REGULAR및NONE입니다. 생략하면 기본값은REGULAR입니다.CONTROL_PLANE_KMS_KEY(선택사항): 이 클러스터의 컨트롤 플레인 노드와 함께 사용할 Cloud KMS 키의 전체 경로입니다. 예를 들면 다음과 같습니다./projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
이 매개변수는 로컬 스토리지에 고객 관리 암호화 키 (CMEK) 지원 사용 설정에 설명된 대로 Distributed Cloud를 Cloud Key Management Service와 통합한 경우에만 적용됩니다.
로컬 컨트롤 플레인으로 클러스터를 만드는 경우 이전 변수를 바꾸는 것 외에도 다음을 바꿔야 합니다.
CONTROL_PLANE_LOCATION: Distributed Cloud에 이 클러스터의 컨트롤 플레인 워크로드를 로컬로 배포하도록 지시합니다. 값은 대상 Distributed Cloud 영역의 이름입니다.CONTROL_PLANE_NODE_COUNT: 로컬 컨트롤 플레인 워크로드를 실행할 노드 수를 지정합니다. 유효한 값은 고가용성의 경우3이고 표준 작업의 경우1입니다.CONTROL_PLANE_NODE_FILTER(선택사항): 로컬 컨트롤 플레인 워크로드를 실행하는 노드의 정규식 형식 목록을 지정합니다. 생략하면 Distributed Cloud에서 무작위로 노드를 자동으로 선택합니다.CONTROL_PLANE_NODE_SHARING: 애플리케이션 워크로드가 로컬 컨트롤 플레인 워크로드를 실행하는 노드에서 실행될 수 있는지 여부를 지정합니다. 유효한 값은DISALLOWED,ALLOWED입니다. 생략할 경우 기본값은DISALLOWED입니다.IPV4_DATA_PLANE_ADDRESSES: 로컬 제어 영역 클러스터의 Distributed Cloud 부하 분산기 뒤에서 실행되는 서비스의 수신 트래픽에 대한 쉼표로 구분된 IPv4 주소, 주소 범위 또는 서브넷 목록을 지정합니다. Cloud 컨트롤 플레인 클러스터에는 적용되지 않습니다.SOFTWARE_VERSION: 이 클러스터가 실행할 Distributed Cloud 소프트웨어 버전을 지정합니다. 형식은1.X.Y입니다. 여기서X는 부 버전이고Y는 패치 버전입니다(예:1.5.0). 생략하면 서버 기본 소프트웨어 버전이 기본값으로 설정되며, 이는 일반적으로 사용 가능한 최신 버전의 Distributed Cloud입니다. 서버 기본 버전을 비롯해 클러스터 생성에 사용할 수 있는 소프트웨어 버전을 확인하려면 클러스터에 사용할 수 있는 소프트웨어 버전 가져오기를 참고하세요.
리전의 클러스터 나열
Google Cloud 리전에 프로비저닝된 Distributed Cloud 클러스터를 나열하려면 이 섹션의 단계를 완료하세요.
이 작업을 완료하려면 Google Cloud 프로젝트에 Edge Container 뷰어 역할(roles/edgecontainer.viewer)이 있어야 합니다.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
클러스터 목록을 검사합니다.
gcloud
gcloud edge-cloud container clusters list 명령어를 사용합니다.
gcloud edge-cloud container clusters list \
--project=PROJECT_ID \
--location=REGION
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: Distributed Cloud 클러스터를 만든 Google Cloud 리전입니다.
API
projects.locations.clusters.list 메서드에 대해 GET 요청을 실행합니다.
GET /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 타겟 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.CLUSTER_ID: 대상 클러스터의 이름입니다.FILTER: 반환된 결과를 특정 값으로 제한하는 표현식입니다.PAGE_SIZE: 페이지당 반환할 결과 수입니다.SORT_BY: 반환된 결과를 정렬하는 쉼표로 구분된 필드 이름 목록입니다. 기본 정렬 순서는 오름차순입니다. 내림차순 정렬의 경우 원하는 필드 앞에~를 붙입니다.PAGE_TOKEN: 응답의nextPageToken필드에 있는 마지막 목록 요청에 대한 응답에서 수신된 토큰입니다. 결과 페이지를 수신하려면 이 토큰을 전송하세요.
클러스터 정보 가져오기
Distributed Cloud 클러스터에 대한 정보를 가져오려면 이 섹션의 단계를 완료하세요.
이 작업을 완료하려면 Google Cloud 프로젝트에 Edge Container 뷰어 역할(roles/edgecontainer.viewer)이 있어야 합니다.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
원하는 클러스터를 선택합니다.
클러스터에 대한 세부정보가 포함된 펼쳐지는 패널이 오른쪽 창에 표시됩니다.
gcloud
gcloud edge-cloud container clusters describe 명령어를 사용합니다.
gcloud edge-cloud container clusters describe CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION
다음을 바꿉니다.
CLUSTER_ID: 대상 클러스터의 이름입니다.PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: Distributed Cloud 영역을 생성한 Google Cloud 리전입니다.
API
projects.locations.clusters.get 메서드에 대해 GET 요청을 실행합니다.
GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 타겟 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.CLUSTER_ID: 대상 클러스터의 이름입니다.
클러스터에 사용 가능한 소프트웨어 버전 가져오기
Distributed Cloud 영역에서 클러스터를 생성하는 데 사용할 수 있는 Distributed Cloud 소프트웨어 버전을 확인하려면 이 섹션의 단계를 완료하세요.
이 작업을 완료하려면 Google Cloud 프로젝트에 Edge Container 뷰어 역할(roles/edgecontainer.viewer)이 있어야 합니다.
gcloud
gcloud edge-cloud container get-server-config 명령어를 사용합니다.
gcloud edge-cloud container get-server-config --location=REGION
REGION을 Distributed Cloud 영역을 만든 Google Cloud 리전으로 바꿉니다.
API
projects.locations.serverConfig 메서드에 대해 GET 요청을 실행합니다.
GET /v1/projects/PROJECT_ID/locations/REGION/serverConfig
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 타겟 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.
로컬 컨트롤 플레인 클러스터의 소프트웨어 버전 업그레이드
Distributed Cloud 로컬 컨트롤 플레인 클러스터의 소프트웨어 버전을 업그레이드하려면 이 섹션의 단계를 완료하세요. 이 기능은 Cloud 제어 영역 클러스터에서 사용할 수 없습니다.
이 작업을 완료하려면 Google Cloud 프로젝트에Edge Container 관리자 역할(roles/edgecontainer.admin)이 있어야 합니다.
gcloud
gcloud edge-cloud container clusters upgrade 명령어를 사용합니다.
gcloud edge-cloud container clusters upgrade CLUSTER_ID \ --location=REGION \ --project=PROJECT_ID \ --schedule=UPGRADE_SCHEDULE \ --version=SOFTWARE_VERSION
다음을 바꿉니다.
CLUSTER_ID: 대상 클러스터의 이름입니다.REGION: 대상 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.UPGRADE_SCHEDULE: 소프트웨어 업그레이드를 트리거할 시기를 지정합니다. 유일하게 유효한 값은IMMEDIATELY입니다.SOFTWARE_VERSION: 이 클러스터가 실행할 Distributed Cloud 소프트웨어 버전을 지정합니다. 형식은1.X.Y입니다. 여기서X는 부 버전이고Y는 패치 버전입니다(예:1.5.1). 서버 기본 버전을 비롯해 클러스터 생성에 사용할 수 있는 소프트웨어 버전을 확인하려면 클러스터에 사용할 수 있는 소프트웨어 버전 가져오기를 참고하세요.
API
projects.locations.clusters.upgrade 메서드에 대해 POST 요청을 실행합니다.
POST /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID:upgrade?requestId=REQUEST_ID
{
"name": "projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID",
"targetVersion": "SOFTWARE_VERSION",
"schedule": "UPGRADE_SCHEDULE",
}
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 타겟 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.CLUSTER_ID: 대상 클러스터의 이름입니다.REQUEST_ID: 이 요청을 식별하는 고유한 프로그래매틱 ID입니다.UPGRADE_SCHEDULE: 소프트웨어 업그레이드를 트리거할 시기를 지정합니다. 유일하게 유효한 값은IMMEDIATELY입니다.SOFTWARE_VERSION: 이 클러스터가 실행할 Distributed Cloud 소프트웨어 버전을 지정합니다. 형식은1.X.Y입니다. 여기서X는 부 버전이고Y는 패치 버전입니다(예:1.5.1). 서버 기본 버전을 비롯해 클러스터 생성에 사용할 수 있는 소프트웨어 버전을 확인하려면 클러스터에 사용할 수 있는 소프트웨어 버전 가져오기를 참고하세요.
소프트웨어 업그레이드는 일반적으로 클러스터의 노드 풀에 속한 각 노드당 약 2시간이 걸립니다.
이 명령어는 소프트웨어 업그레이드의 진행 상황을 추적할 수 있는 작업을 반환합니다. 소프트웨어 업그레이드가 진행되는 동안 클러스터의 상태는 Reconciling로 설정되며 업그레이드가 완료되면 Running로 돌아갑니다. 클러스터 상태가 Error이면 소프트웨어 업그레이드에 실패한 것입니다.
이 경우 업그레이드 프로세스를 다시 실행하세요. 클러스터 상태를 확인하는 방법은 클러스터에 대한 정보 가져오기를 참고하세요.
클러스터의 사용자 인증 정보 가져오기
Distributed Cloud 클러스터의 사용자 인증 정보를 가져오려면 이 섹션의 단계를 완료하세요.
이 작업을 완료하려면 Google Cloud 프로젝트에 Edge Container 뷰어 역할(roles/edgecontainer.viewer)이 있어야 합니다.
gcloud
gcloud edge-cloud container clusters get-credentials 명령어를 사용합니다.
gcloud edge-cloud container clusters get-credentials CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION
다음을 바꿉니다.
CLUSTER_ID: 대상 클러스터의 이름입니다.PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 타겟 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.
API
projects.locations.clusters 메서드에 대해 GET 요청을 실행합니다.
GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 대상 Distributed Cloud 영역이 생성된 Google Cloud 리전입니다.CLUSTER_ID: 대상 클러스터의 이름입니다.
클러스터의 유지보수 기간 구성
이 섹션에서는 Distributed Cloud 클러스터의 유지보수 기간을 지정하고 유지보수 기간을 지우는 방법을 설명합니다.
클러스터의 유지보수 기간 지정
Distributed Cloud 클러스터의 유지보수 기간을 지정하려면 이 섹션의 단계를 완료하세요. 클러스터 유지보수에 대한 자세한 내용은 소프트웨어 업데이트 및 유지보수 기간 이해하기를 참고하세요.
날짜 및 시간 형식에는 RFC 5545를 사용합니다.
이 작업을 완료하려면 Google Cloud 프로젝트에Edge Container 관리자 역할(roles/edgecontainer.admin)이 있어야 합니다.
콘솔
Google Cloud 콘솔을 사용하는 경우 클러스터를 만들 때만 유지관리 기간을 지정할 수 있습니다. 기존 클러스터에서 유지보수 기간을 지정하려면 Google Cloud CLI 또는 Distributed Cloud Edge Container API를 사용해야 합니다.
gcloud
gcloud edge-cloud container clusters update 명령어를 사용합니다.
gcloud edge-cloud container clusters update CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION \
--maintenance-window-start=MAINTENANCE_START \
--maintenance-window-end=MAINTENANCE_END \
--maintenance-window-recurrence=MAINTENANCE_FREQUENCY
다음을 바꿉니다.
CLUSTER_ID: 대상 클러스터의 이름입니다.PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 타겟 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.MAINTENANCE_START: 유지보수 기간의 시작 시간입니다(YYYY-MM-DDTHH:MM:SSZ형식).MAINTENANCE_END: 유지보수 기간의 종료 시간입니다(YYYY-MM-DDTHH:MM:SSZ형식).MAINTENANCE_FREQUENCY:FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU형식의 유지보수 기간 빈도입니다.BYDAY:FREQ이WEEKLY로 설정된 경우 유지보수가 발생할 수 있는 요일의 쉼표로 구분된 목록입니다.BYDAY매개변수를 생략하면 Google에서 요일을 선택합니다.FREQ를 매일로 설정하면 지정된 시간에 매일 유지보수 기간이 발생합니다.
API
projects.locations.clusters.update 메서드에 대해 PATCH 요청을 실행합니다.
PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
"maintenance_policy": {
"window": {
"recurring_window": {
"window": {
"start_time": "MAINTENANCE_START",
"end_time": "MAINTENANCE_END"
},
"recurrence": "MAINTENANCE_FREQUENCY"
}
}
}
}
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 대상 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.CLUSTER_ID: 대상 클러스터의 이름입니다.UPDATE_MASK: 이 요청에서 업데이트할 정규화된 필드 이름의 쉼표로 구분된 목록입니다(FieldMask 형식).REQUEST_ID: 이 요청을 식별하는 고유한 프로그래매틱 ID입니다.CLUSTER_ID: 대상 클러스터의 이름입니다.USERNAME: 클러스터 리소스를 수정할 권한이 있는 타겟 Google Cloud 프로젝트 내 사용자 계정의 이름입니다.MAINTENANCE_START: 유지보수 기간의 시작 시간입니다(YYYY-MM-DDTHH:MM:SSZ형식).MAINTENANCE_END: 유지보수 기간의 종료 시간입니다(YYYY-MM-DDTHH:MM:SSZ형식).MAINTENANCE_FREQUENCY:FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU형식의 유지보수 기간 빈도입니다.FREQ은DAILY또는WEEKLY일 수 있습니다.BYDAY:FREQ이WEEKLY로 설정된 경우 유지보수가 발생할 수 있는 요일의 쉼표로 구분된 목록입니다.BYDAY매개변수를 생략하면 Google에서 요일을 선택합니다.FREQ를 매일로 설정하면 지정된 시간에 매일 유지보수 기간이 발생합니다.
자세한 내용은 리소스: 클러스터를 참고하세요.
클러스터의 유지보수 기간 지우기
Distributed Cloud 클러스터의 유지보수 기간을 지우려면 이 섹션의 단계를 완료하세요. 클러스터 유지보수에 대한 자세한 내용은 소프트웨어 업데이트 및 유지보수 기간 이해하기를 참고하세요.
이 작업을 완료하려면 Google Cloud 프로젝트에Edge Container 관리자 역할(roles/edgecontainer.admin)이 있어야 합니다.
gcloud
gcloud edge-cloud container clusters update 명령어를 사용합니다.
gcloud edge-cloud container clusters update CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION \
--clear-maintenance-window
다음을 바꿉니다.
CLUSTER_ID: 대상 클러스터의 이름입니다.PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 대상 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.
API
projects.locations.clusters.update 메서드에 대해 PATCH 요청을 실행합니다.
PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
"maintenance_policy": null
}
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 대상 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.CLUSTER_ID: 대상 클러스터의 이름입니다.UPDATE_MASK: 이 요청에서 업데이트할 정규화된 필드 이름의 쉼표로 구분된 목록입니다(FieldMask 형식).REQUEST_ID: 이 요청을 식별하는 고유한 프로그래매틱 ID입니다.USERNAME: 클러스터 리소스를 수정할 권한이 있는 타겟 Google Cloud 프로젝트 내 사용자 계정의 이름입니다.
자세한 내용은 리소스: 클러스터를 참고하세요.
클러스터 삭제
Distributed Cloud 클러스터를 삭제하려면 이 섹션의 단계를 완료하세요. 클러스터를 삭제하려면 먼저 다음을 실행해야 합니다.
이 작업을 완료하려면 Google Cloud 프로젝트에Edge Container 관리자 역할(roles/edgecontainer.admin)이 있어야 합니다.
gcloud
gcloud edge-cloud container clusters delete 명령어를 사용합니다.
gcloud edge-cloud container clusters delete CLUSTER_ID \
--project=PROJECT_ID \
--location=REGION
다음을 바꿉니다.
CLUSTER_ID: 대상 클러스터의 이름입니다.PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 타겟 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.
API
projects.locations.clusters.delete 메서드에 대해 DELETE 요청을 실행합니다.
DELETE /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?requestId=REQUEST_ID
다음을 바꿉니다.
PROJECT_ID: 대상 Google Cloud 프로젝트의 ID입니다.REGION: 타겟 Distributed Cloud 클러스터가 생성된 Google Cloud 리전입니다.CLUSTER_ID: 대상 클러스터의 이름입니다.REQUEST_ID: 이 요청을 식별하는 고유한 프로그래매틱 ID입니다.