프라이빗 클라우드 리소스 및 활동 관리

프라이빗 클라우드를 만든 후에는 관련 정보를 확인하고 리소스 및 활동을 관리하고 VMware 관리 어플라이언스에 액세스할 수 있습니다. 각 프라이빗 클라우드에는 클러스터가 한 개 이상 포함되고 각 클러스터에는 ESXi 호스트에 해당하는 노드가 포함됩니다.

중요: 클러스터를 조정하면 Google Cloud 프로젝트에 해당하는 VMware Engine 노드 할당량이 할당됩니다. 할당량을 늘리려면 할당량 및 한도를 참조하세요.

프라이빗 클라우드 목록을 보려면 먼저 리소스 요약 페이지에 액세스합니다.

1. Google Cloud 콘솔에서 프라이빗 클라우드 페이지로 이동합니다.

   프라이빗 클라우드로 이동

2. 프라이빗 클라우드 목록에서 관리하려는 프라이빗 클라우드를 선택합니다.

gcloud 및 API 요구사항

gcloud 명령줄 도구나 API를 사용하여 VMware Engine 리소스를 관리하려면 다음 설명대로 도구를 구성하는 것이 좋습니다.

gcloud

1. 기본 프로젝트 ID를 설정합니다.

   gcloud config set project PROJECT_ID
   

2. 기본 리전 및 영역을 설정합니다.

   gcloud config set compute/region REGION
   

   gcloud config set compute/zone ZONE
   

gcloud vmware 도구에 대한 자세한 내용은 Cloud SDK 참조 문서를 검토하세요.

API

이 문서 집합의 API 예시는 cURL 명령줄 도구를 사용하여 API를 쿼리합니다. cURL 요청의 일부로 유효한 액세스 토큰이 필요합니다. 유효한 액세스 토큰을 가져오는 방법에는 여러 가지가 있습니다. 다음 단계에서는 gcloud 도구를 사용하여 액세스 토큰을 생성합니다.

1. Google Cloud에 로그인합니다.

   gcloud auth login
   

2. 액세스 토큰을 생성하여 TOKEN으로 내보냅니다.

   export TOKEN=`gcloud auth print-access-token`
   

3. TOKEN이 제대로 설정되었는지 확인합니다.

   echo $TOKEN
   

이제 API에 대한 요청에 승인 토큰을 사용합니다. 예를 들면 다음과 같습니다.

curl -X GET -H "Authorization: Bearer \"$TOKEN\"" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

이 문서의 Python 코드 샘플은 VMware Engine 라이브러리를 사용하여 API와 통신합니다. 이 접근 방식을 사용하려면 라이브러리를 설치해야 하며 애플리케이션 기본 사용자 인증 정보를 구성해야 합니다.

1. Python 라이브러리를 다운로드하고 설치합니다.

   pip install google-cloud-vmwareengine
   

2. 셸에서 명령어를 실행하여 ADC 정보를 구성합니다.

   gcloud auth application-default login
   

   또는 서비스 계정 키 파일을 사용합니다.

   export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
   

라이브러리에 대한 자세한 내용은 참조 페이지를 확인하거나 GitHub의 코드 샘플을 확인하세요.

IP 주소 레이아웃 버전 확인

2022년 11월 이후에 생성된 프라이빗 클라우드는 IP 주소 레이아웃(IP 계획) 버전 2.0 서브넷 할당을 준수합니다. 2022년 11월 이전에 생성된 거의 모든 프라이빗 클라우드는 IP 계획 버전 1.0 서브넷 할당을 준수합니다.

프라이빗 클라우드가 준수하는 버전을 확인하려면 다음 단계를 완료하세요.

1. Google Cloud 콘솔에서 프라이빗 클라우드 페이지로 이동합니다.

   프라이빗 클라우드로 이동

2. 확인하려는 프라이빗 클라우드의 이름을 선택합니다. 버전 번호가 IP 계획 버전으로 표시됩니다.

프라이빗 클라우드 요약 보기

요약에서는 이름, vSphere 클러스터 수, 노드 수, 위치, 작업 상태 등을 포함한 프라이빗 클라우드에 대한 정보를 제공합니다. 요약 페이지에는 프라이빗 클라우드에 배포된 DNS 서버도 포함됩니다.

프라이빗 클라우드 요약 페이지에서 다음 작업을 수행할 수 있습니다.

• vSphere 클라이언트 실행. 이 프라이빗 클라우드의 vCenter에 액세스합니다.
• 노드 추가. 이 프라이빗 클라우드에 노드를 추가합니다.
• 클러스터 추가. 이 프라이빗 클라우드에 새 클러스터를 추가합니다.
• 커스텀 코어 수 구성으로 클러스터 만들기. 커스텀 코어 수 구성으로 새 클러스터 만들기
• 노드 삭제. 이 프라이빗 클라우드에서 노드를 삭제합니다.
• 프라이빗 클라우드 삭제. 모든 VM, vCenter 구성, 데이터를 포함한 프라이빗 클라우드를 삭제합니다. 삭제하기 전에 모든 시스템과 데이터를 백업합니다.
• vSphere 권한 변경. 프라이빗 클라우드에서 특정 작업을 수행할 수 있는 권한을 승격합니다.
• DNS 서버의 IP 주소 복사. 프라이빗 클라우드에서 DNS 서버 목록을 가져옵니다. 온프레미스 DNS 서버에서 프라이빗 Cloud DNS 서버로 DNS 전달을 설정할 수 있습니다. DNS 전달에 대한 자세한 내용은 온프레미스 워크스테이션에서 프라이빗 클라우드 vCenter에 액세스하기 위한 이름 확인용 DNS 구성을 참조하세요.

프라이빗 클라우드에 노드 추가

프라이빗 클라우드는 각각 여러 노드를 포함하는 vSphere 클러스터 한 개 이상으로 구성됩니다. 프라이빗 클라우드에 노드를 추가할 때 기존 클러스터에 노드를 추가하거나 새 클러스터를 만듭니다. 프라이빗 클라우드는 전체 노드 한도 내에서는 여러 번 확장될 수 있습니다. 프라이빗 클라우드를 확장할 때마다 기존 클러스터에 추가하거나 새 클러스터를 만듭니다.

Google은 새 클러스터 구성 중 VMware 인프라를 구성합니다. 설정에는 vSAN 디스크 그룹의 스토리지 설정, VMware 고가용성, Distributed Resource Scheduler(DRS)가 포함됩니다.

콘솔

Google Cloud 콘솔을 사용하여 프라이빗 클라우드에 노드를 추가하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 프라이빗 클라우드 페이지로 이동합니다.

   프라이빗 클라우드로 이동

2. 프라이빗 클라우드 요약 페이지에서 노드 추가를 클릭합니다.

3. 기존 클러스터 중 하나에 노드를 추가할지, 새 vSphere 클러스터를 만들지 선택합니다. 변경하면 페이지의 요약 정보가 업데이트됩니다.

4. 기존 클러스터 중 하나에 노드를 추가하려면 기존에 노드 추가를 선택합니다. 확장할 클러스터를 선택하고 추가할 노드 수를 입력합니다.

5. 새 클러스터를 추가하려면 새로 만들기를 선택합니다. 그런 다음 아래 세부정보를 제공합니다.

   1. 클러스터 이름을 입력합니다.
   2. 기존 vSphere 데이터 센터를 선택하거나 이름을 입력하여 새 데이터 센터를 만듭니다.
   3. 노드 수를 선택합니다. 새 클러스터마다 노드가 최소 3개 이상 있어야 합니다.
   4. 선택사항: 관리 클러스터의 각 노드에서 사용 가능한 코어 수를 줄이려면 코어 맞춤설정 전환 버튼을 클릭합니다. 자세한 내용은 커스텀 코어 수를 참조하세요.

6. 제출을 클릭합니다.

gcloud

update 명령어를 사용하면 클러스터의 총 노드 수를 변경할 수 있습니다. 이 명령어를 사용하려면 클러스터 및 프라이빗 클라우드의 이름이 필요합니다.

1. gcloud vmware private-clouds clusters list 명령어를 입력하여 클러스터를 나열합니다.

   gcloud vmware private-clouds clusters list \
   --private-cloud=PRIVATE_CLOUD_ID \
   --location=ZONE

다음을 바꿉니다.

• PRIVATE_CLOUD_ID: 프라이빗 클라우드의 이름
• ZONE: 프라이빗 클라우드의 영역입니다.

1. gcloud vmware private-clouds clusters update 명령어를 실행하여 클러스터를 업데이트합니다.

   gcloud vmware private-clouds clusters update CLUSTER_ID \
   --location=ZONE \
   --private-cloud=PRIVATE_CLOUD_ID \
   --update-nodes-config=type=NODE_TYPE,count=NODE_COUNT

   다음을 바꿉니다.

   • CLUSTER_ID: 이 프라이빗 클라우드에서 업데이트할 클러스터 ID입니다.
   • ZONE: 프라이빗 클라우드의 영역
   • PRIVATE_CLOUD_ID: 이 요청의 프라이빗 클라우드 ID
   • NODE_TYPE: 노드 유형입니다. 자세한 내용은 노드 유형을 참조하세요.
   • NODE_COUNT: 추가할 노드 수입니다.

API

Update API를 사용하면 클러스터의 총 노드 수를 변경할 수 있습니다. 이 명령어를 사용하려면 클러스터 및 프라이빗 클라우드의 이름이 필요합니다.

1. GET 요청을 수행하여 클러스터를 나열합니다.

   curl -L -X GET -H "Authorization: Bearer TOKEN" "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters"
   

다음을 바꿉니다.

• PROJECT_ID: 이 요청의 프로젝트 ID입니다.
• ZONE: 프라이빗 클라우드의 영역입니다.
• PRIVATE_CLOUD_ID: 이 요청의 프라이빗 클라우드 ID입니다.

1. PATCH 요청을 수행하여 클러스터를 업데이트합니다. 예를 들어 다음은 클러스터를 standard-72 노드 유형으로 업데이트합니다.

   curl -L -X PATCH -H "Authorization: Bearer TOKEN" \
   -H "Content-Type: application/json" \
   "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID?updateMask=node_type_configs.*.node_count" \
   -d '{
   "nodeTypeConfigs": {
     "standard-72" : {
       "nodeCount": NODE_COUNT
     }
   }
   }'

   다음을 바꿉니다.

   • PROJECT_ID: 이 요청의 프로젝트 ID입니다.
   • ZONE: 프라이빗 클라우드의 영역입니다.
   • PRIVATE_CLOUD_ID: 프라이빗 클라우드의 프라이빗 클라우드 ID입니다.
   • CLUSTER_ID: 이 프라이빗 클라우드에서 업데이트할 클러스터의 클러스터 ID입니다.
   • NODE_COUNT: 추가할 노드 수입니다.

Python

클러스터 업데이트 메서드를 사용하면 클러스터의 총 노드 수를 변경할 수 있습니다. 이 메서드를 사용하려면 클러스터 및 프라이빗 클라우드의 이름이 필요합니다.

1. 클러스터를 나열합니다.

from typing import Iterable

from google.cloud import vmwareengine_v1


def list_clusters(
    project_id: str, zone: str, private_cloud_name: str
) -> Iterable[vmwareengine_v1.Cluster]:
    """
    Retrieves a list of clusters in private cloud.

    Args:
        project_id: name of the project hosting the private cloud.
        zone: zone in which the private cloud is located.
        private_cloud_name: name of the cloud of which you want to list cluster.

    Returns:
        An iterable collection of Cluster objects.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    return client.list_clusters(
        parent=f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

1. 클러스터를 업데이트합니다. 다음 메서드를 사용하면 클러스터의 standard-72 노드 수를 수정할 수 있습니다.

from google.api_core import operation
from google.cloud import vmwareengine_v1


def update_cluster_node_count(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int,
) -> operation.Operation:
    """
    Modify the number of nodes in a cluster in a private cloud.

    Modifying a cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: zone in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the cluster.
        cluster_name: name of the cluster.
        node_count: desired number of nodes in the cluster.

    Returns:
        An Operation object related to cluster modification operation.
    """
    if node_count < 3:
        raise RuntimeError("Cluster needs to have at least 3 nodes")
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.UpdateClusterRequest()
    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.update_mask = "nodeTypeConfigs.*.nodeCount"
    return client.update_cluster(request)

프라이빗 클라우드에 새 클러스터 추가

기존 프라이빗 클라우드에 새 클러스터를 추가하려면 다음 안내를 따르세요.

gcloud

gcloud vmware private-clouds clusters create 명령어를 실행하여 새 클러스터를 추가하고 이름을 지정합니다. 예를 들면 다음과 같습니다.

gcloud vmware private-clouds clusters create CLUSTER_ID \
   --location=ZONE \
   --private-cloud=PRIVATE_CLOUD_ID \
   --node-type-config=type=NODE_TYPE,count=NODE_COUNT

다음을 바꿉니다.

• CLUSTER_ID: 프라이빗 클라우드에 추가할 클러스터의 클러스터 ID입니다.
• ZONE: 프라이빗 클라우드의 영역
• PRIVATE_CLOUD_ID: 프라이빗 클라우드의 프라이빗 클라우드 ID입니다.
• NODE_TYPE: 노드 유형입니다. 자세한 내용은 노드 유형을 참조하세요.
• NODE_COUNT: 추가할 노드 수입니다.

API

새 클러스터를 추가하고 POST 요청을 통해 이름을 지정합니다. 예를 들면 다음과 같습니다.

curl -L -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters?clusterId=CLUSTER_ID" \
-d '{
  "nodeTypeConfigs": {
    "standard-72": {
      "nodeCount": NODE_COUNT
      }
  }
}'

다음을 바꿉니다.

• CLUSTER_ID: 프라이빗 클라우드에 추가하려는 클러스터의 클러스터 ID입니다.
• ZONE: 프라이빗 클라우드의 영역입니다.
• PRIVATE_CLOUD_ID: 프라이빗 클라우드의 프라이빗 클라우드 ID입니다.
• NODE_COUNT: 추가할 노드 수입니다.

Python

새 클러스터를 추가하고 이름을 지정합니다.

from google.api_core import operation
from google.cloud import vmwareengine_v1


def create_cluster(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int = 4,
) -> operation.Operation:
    """
    Create a new cluster in a private cloud.

    Creation of a new cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.
        node_count: number of nodes in the new cluster. (Must be >= 3)

    Returns:
        An Operation object related to started cluster creation operation.

    Raises:
        ValueError in case an incorrect number of nodes is provided.
    """
    if node_count < 3:
        raise ValueError("Cluster needs to have at least 3 nodes")

    request = vmwareengine_v1.CreateClusterRequest()
    request.parent = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = cluster_name

    # Currently standard-72 is the only supported node type.
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count

    client = vmwareengine_v1.VmwareEngineClient()
    return client.create_cluster(request)

커스텀 코어 수 구성으로 새 클러스터 만들기

커스텀 코어 수 구성을 사용하여 새 클러스터를 만들려면 다음을 수행합니다.

gcloud

gcloud vmware private-clouds clusters create 명령어를 실행하여 새 클러스터를 추가하고 코어 수 구성을 지정합니다. 다음 예시에서는 standard-72 노드 유형으로 새 클러스터를 만듭니다.

gcloud vmware private-clouds clusters create CLUSTER_ID \
  --location=ZONE \
  --private-cloud=PRIVATE_CLOUD_ID \
  --node-type-config=type=standard-72,count=NODE_COUNT,custom-core-count=CORE_COUNT

다음을 바꿉니다.

• CLUSTER_ID: 프라이빗 클라우드에 추가할 클러스터의 클러스터 ID입니다.
• ZONE: 프라이빗 클라우드의 영역입니다.
• PRIVATE_CLOUD_ID: 프라이빗 클라우드의 프라이빗 클라우드 ID입니다.
• NODE_COUNT: 추가할 노드 수입니다.
• CORES_COUNT: 추가할 커스텀 코어 수입니다.

API

POST 요청을 통해 새 클러스터를 추가하고 코어 수 구성을 지정합니다. 다음 예시에서는 standard-72 노드 유형의 새 클러스터를 만듭니다.

curl -L -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters?clusterId=CLUSTER_ID" \
-d '{
      "nodeTypeConfigs": {
      "standard-72": {
        "nodeCount": NODE_COUNT,
        "customCoreCount": CORE_COUNT
        }
    }
}'

다음을 바꿉니다.

• PROJECT_ID: 프라이빗 클라우드의 프로젝트 ID입니다.
• CLUSTER_ID: 프라이빗 클라우드에 추가할 클러스터의 클러스터 ID입니다.
• ZONE: 프라이빗 클라우드의 영역입니다.
• PRIVATE_CLOUD_ID: 프라이빗 클라우드의 프라이빗 클라우드 ID입니다.
• NODE_COUNT: 추가할 노드 수입니다.
• CORES_COUNT: 추가할 커스텀 코어 수입니다.

Python

새 클러스터를 추가하고 코어 수 구성을 지정합니다. 예를 들어 다음은 구성 가능한 노드 수와 코어 수를 사용하여 standard-72 노드 유형의 새 클러스터를 만듭니다.

from google.api_core import operation
from google.cloud import vmwareengine_v1


def create_custom_cluster(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int = 4,
    core_count: int = 28,
) -> operation.Operation:
    """
    Create a new cluster with custom number of cores in its nodes
    in a private cloud.

    Creation of a new cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.
        node_count: number of nodes in the new cluster.
        core_count: number of CPU cores in the new cluster nodes.

    Returns:
        An Operation object related to started cluster creation operation.

    Raises:
        ValueError in case an incorrect number of nodes is provided.
    """
    if node_count < 3:
        raise ValueError("Cluster needs to have at least 3 nodes")

    request = vmwareengine_v1.CreateClusterRequest()
    request.parent = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
    )

    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = cluster_name

    # Currently standard-72 is the only supported node type.
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.cluster.node_type_configs["standard-72"].custom_core_count = core_count

    client = vmwareengine_v1.VmwareEngineClient()
    return client.create_cluster(request)

노드 삭제 또는 클러스터 삭제

프라이빗 클라우드에서 노드를 삭제할 때는 기존 클러스터에서 노드를 삭제하거나 전체 클러스터를 삭제합니다.

콘솔

더 적은 수의 노드로 클러스터를 업데이트하여 Google Cloud 콘솔을 사용하여 프라이빗 클라우드에서 노드를 삭제하려면 다음을 수행합니다.

1. Google Cloud 콘솔에서 프라이빗 클라우드 페이지로 이동합니다.

   프라이빗 클라우드로 이동

2. 프라이빗 클라우드 요약 페이지에서 노드 삭제를 클릭합니다.

3. 축소하거나 삭제할 클러스터를 선택합니다.

4. 노드 1개 삭제를 클릭합니다.

5. 클러스터 용량을 확인합니다.

6. 제출을 클릭하여 노드 삭제 프로세스를 시작합니다.

진행 상황을 모니터링하려면 활동 > 태스크를 선택합니다. 이 프로세스에는 vSAN의 재동기화가 필요하며 데이터에 따라 몇 시간이 걸릴 수 있습니다.

gcloud

Google Cloud CLI를 사용하여 프라이빗 클라우드에서 노드를 삭제하려면 gcloud vmware private-clouds clusters update 명령어를 사용합니다.

gcloud vmware private-clouds clusters update CLUSTER_ID \
  --location=ZONE \
  --private-cloud=PRIVATE_CLOUD_ID \
  --update-nodes-config=type=NODE_TYPE,count=NODE_COUNT

다음을 바꿉니다.

• CLUSTER_ID: 이 프라이빗 클라우드에서 업데이트할 클러스터의 클러스터 ID입니다.
• ZONE: 프라이빗 클라우드의 영역
• PRIVATE_CLOUD_ID: 프라이빗 클라우드의 프라이빗 클라우드 ID입니다.
• NODE_TYPE: 노드 유형입니다. 자세한 내용은 노드 유형을 참조하세요.
• NODE_COUNT: 새 노드 수입니다. 이 새 값은 현재 값보다 1 작아야 합니다.

API

VMware Engine API를 사용하여 프라이빗 클라우드에서 노드를 삭제하려면 PATCH 요청을 수행합니다.

curl -L -X PATCH -H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID?update_mask=node_type_configs.*.node_count" \
-d '{
  "nodeTypeConfigs": {
    "standard-72" : {
      "nodeCount": NODE_COUNT
    }
  }
}'

다음을 바꿉니다.

• CLUSTER_ID: 이 프라이빗 클라우드에서 업데이트할 클러스터의 클러스터 ID입니다.
• ZONE: 프라이빗 클라우드의 영역입니다.
• PRIVATE_CLOUD_ID: 프라이빗 클라우드의 프라이빗 클라우드 ID입니다.
• NODE_COUNT: 새 노드 수입니다. 이 새 값은 현재 값보다 1 작아야 합니다.

Python

from google.api_core import operation
from google.cloud import vmwareengine_v1


def update_cluster_node_count(
    project_id: str,
    zone: str,
    private_cloud_name: str,
    cluster_name: str,
    node_count: int,
) -> operation.Operation:
    """
    Modify the number of nodes in a cluster in a private cloud.

    Modifying a cluster is a long-running operation and it may take over an hour.

    Args:
        project_id: name of the project you want to use.
        zone: zone in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the cluster.
        cluster_name: name of the cluster.
        node_count: desired number of nodes in the cluster.

    Returns:
        An Operation object related to cluster modification operation.
    """
    if node_count < 3:
        raise RuntimeError("Cluster needs to have at least 3 nodes")
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.UpdateClusterRequest()
    request.cluster = vmwareengine_v1.Cluster()
    request.cluster.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    request.cluster.node_type_configs = {
        "standard-72": vmwareengine_v1.NodeTypeConfig()
    }
    request.cluster.node_type_configs["standard-72"].node_count = node_count
    request.update_mask = "nodeTypeConfigs.*.nodeCount"
    return client.update_cluster(request)

클러스터 삭제

전체 클러스터를 삭제하려면 다음 안내를 따르세요.

콘솔

1. Google Cloud 콘솔에서 프라이빗 클라우드 페이지로 이동합니다.

   프라이빗 클라우드로 이동

2. 프라이빗 클라우드 요약 페이지에서 노드 삭제를 클릭합니다.

3. 축소하거나 삭제할 클러스터를 선택합니다.

4. 전체 클러스터 삭제를 선택합니다.

5. 클러스터 용량을 확인합니다.

6. 제출을 클릭하여 노드 삭제 프로세스를 시작합니다.

gcloud

Google Cloud CLI를 사용하여 전체 클러스터를 삭제하려면 gcloud vmware private-clouds clusters delete 명령어를 사용합니다.

gcloud vmware private-clouds clusters delete CLUSTER_ID \
  --location=ZONE \
  --private-cloud=PRIVATE_CLOUD_ID

다음을 바꿉니다.

• CLUSTER_ID: 이 프라이빗 클라우드에서 업데이트할 클러스터의 클러스터 ID입니다.
• ZONE: 프라이빗 클라우드의 영역입니다.
• PRIVATE_CLOUD_ID: 프라이빗 클라우드의 프라이빗 클라우드 ID입니다.

API

VMware Engine API를 사용하여 전체 클러스터를 삭제하려면 DELETE 요청을 수행합니다.

curl -L -X DELETE -H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
"https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID"

다음을 바꿉니다.

• PROJECT_ID: 프라이빗 클라우드의 프로젝트 ID입니다.
• ZONE: 프라이빗 클라우드의 영역입니다.
• PRIVATE_CLOUD_ID: 프라이빗 클라우드의 프라이빗 클라우드 ID입니다.
• CLUSTER_ID: 이 프라이빗 클라우드에서 업데이트할 클러스터의 클러스터 ID입니다.

Python

from google.api_core import operation
from google.cloud import vmwareengine_v1


def delete_cluster(
    project_id: str, zone: str, private_cloud_name: str, cluster_name: str
) -> operation.Operation:
    """
    Delete a cluster from private cloud.

    Deleting a cluster is a long-running operation and it may take over an hour..

    Args:
        project_id: name of the project you want to use.
        zone: region in which your private cloud is located.
        private_cloud_name: name of the private cloud hosting the new cluster.
        cluster_name: name of the new cluster.

    Returns:
        An Operation object related to started cluster deletion operation.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.DeleteClusterRequest()
    request.name = (
        f"projects/{project_id}/locations/{zone}/privateClouds/{private_cloud_name}"
        f"/clusters/{cluster_name}"
    )
    return client.delete_cluster(request)

노드 나열

Google Cloud 콘솔, Google Cloud CLI, VMware Engine API를 사용하여 특정 프라이빗 클라우드 클러스터의 노드를 나열하고 여러 노드 또는 특정 노드에 대한 정보를 가져오려면 다음을 수행합니다.

콘솔

Google Cloud 콘솔을 사용하여 하나 또는 여러 프라이빗 클라우드 노드를 나열하려면 다음 단계를 수행합니다.

1. Google Cloud 콘솔에서 프라이빗 클라우드 페이지로 이동합니다.

   프라이빗 클라우드로 이동

2. 프라이빗 클라우드 요약 페이지에서 프라이빗 클라우드 이름을 클릭합니다.

3. 클러스터 세부정보 페이지에서 클러스터 탭을 클릭합니다.

4. 클러스터 탭에서 클러스터의 이름을 클릭합니다. 클러스터의 모든 노드가 클러스터 노드 테이블에 나열됩니다.

gcloud

Google Cloud CLI를 사용하여 하나 또는 여러 프라이빗 클라우드 노드를 나열하려면 다음을 수행합니다.

1. gcloud vmware private-clouds clusters node list 명령어를 실행하여 특정 프라이빗 클라우드의 PRIVATE_CLOUD_ID에 바인딩된 모든 노드를 나열합니다.

   gcloud vmware private-clouds clusters node list \
    --project=PROJECT_ID\
    --location=ZONE \
    --private-cloud=PRIVATE_CLOUD_ID \
    --cluster=CLUSTER_ID

   다음을 바꿉니다.

   • PROJECT_ID: 이 요청의 프로젝트 이름입니다.
   • ZONE: 이 네트워크가 있는 영역입니다.
   • PRIVATE_CLOUD_ID: 이 요청의 네트워크 ID
   • CLUSTER_ID: 이 요청의 클러스터 ID

API

VMware Engine API를 사용하여 하나 또는 여러 프라이빗 클라우드 노드를 나열하려면 다음을 수행합니다.

1. GET 요청을 수행하여 특정 프라이빗 클라우드의 PRIVATE_CLOUD_ID에 바인딩된 모든 노드를 나열합니다.

   GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"

   다음을 바꿉니다.

   • PROJECT_ID: 이 요청의 프로젝트 이름입니다.
   • ZONE: 이 네트워크가 있는 영역입니다.
   • PRIVATE_CLOUD_ID: 이 요청의 네트워크 ID
   • CLUSTER_ID: 이 요청의 클러스터 ID

노드 설명

Google Cloud 콘솔, Google Cloud CLI, VMware Engine API를 사용하여 노드의 설명을 가져오려면 다음을 수행합니다.

콘솔

Google Cloud 콘솔을 사용하여 하나 또는 여러 프라이빗 클라우드 노드를 나열하려면 다음 단계를 수행합니다.

1. Google Cloud 콘솔에서 프라이빗 클라우드 페이지로 이동합니다.

   프라이빗 클라우드로 이동

2. 프라이빗 클라우드 요약 페이지에서 프라이빗 클라우드 이름을 클릭합니다.

3. 클러스터 세부정보 페이지에서 클러스터 탭을 클릭합니다.

4. 클러스터 탭에서 클러스터의 이름을 클릭합니다. 노드 세부정보가 클러스터 노드 테이블에 나열됩니다.

gcloud

Google Cloud CLI를 사용하여 노드에 대한 설명을 가져오려는 경우

1. 선택사항: gcloud vmware private-clouds clusters node list 명령어를 실행하여 노드 이름을 찾습니다.

   gcloud vmware private-clouds clusters node list \
    --project=PROJECT_ID\
    --location=ZONE \
    --private-cloud=PRIVATE_CLOUD_ID \
    --cluster=CLUSTER_ID

   다음을 바꿉니다.

   • PROJECT_ID: 이 요청의 프로젝트 이름입니다.
   • ZONE: 이 네트워크가 있는 영역입니다.
   • PRIVATE_CLOUD_ID: 이 요청의 네트워크 ID
   • CLUSTER_ID: 이 요청의 클러스터 ID

2. gcloud vmware private-clouds clusters nodes describe 명령어를 실행하여 특정 노드에 대한 설명을 가져옵니다.

   gcloud vmware private-clouds clusters nodes describe NODE_NAME \
    --project=PROJECT_ID\
    --location=ZONE \
    --private-cloud=PRIVATE_CLOUD_ID \
    --cluster=CLUSTER_ID

   다음을 바꿉니다.

   • NODE_NAME: 이전 명령어에서 반환된 노드 이름입니다. 예를 들면 esxi-1435-f4d250입니다.
   • PROJECT_ID: 이 요청의 프로젝트 이름입니다.
   • ZONE: 이 네트워크가 있는 영역입니다.
   • PRIVATE_CLOUD_ID: 이 요청의 네트워크 ID입니다.
   • CLUSTER_ID: 이 요청의 클러스터 ID

API

VMware Engine API를 사용하여 노드의 설명을 가져오려는 경우

1. 선택사항: GET 요청을 수행하여 노드 이름을 찾습니다.

   GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes"
   

   다음을 바꿉니다.

   • PROJECT_ID: 이 요청의 프로젝트 이름입니다.
   • ZONE: 이 네트워크가 있는 영역입니다.
   • PRIVATE_CLOUD_ID: 이 요청의 네트워크 ID입니다.
   • CLUSTER_ID: 이 요청의 클러스터 ID

2. GET 요청을 수행하여 특정 노드에 대한 설명을 가져옵니다.

   GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PRIVATE_CLOUD_ID/clusters/CLUSTER_ID/nodes/NODE_NAME"

   다음을 바꿉니다.

   • NODE_NAME: 이전 명령어에서 반환된 노드 이름입니다. 예를 들면 esxi-1435-f4d250입니다.
   • PROJECT_ID: 이 요청의 프로젝트 이름입니다.
   • ZONE: 이 네트워크가 있는 영역입니다.
   • PRIVATE_CLOUD_ID: 이 요청의 네트워크 ID입니다.
   • CLUSTER_ID: 이 요청의 클러스터 ID

제한사항

프라이빗 클라우드에서 노드를 삭제하는 프로세스에는 다음과 같은 제한사항이 있습니다.

• vSphere 클러스터에는 노드가 최소 3개 이상 있어야 합니다. 노드가 3개인 vSphere 클러스터에서는 노드를 삭제할 수 없습니다.
• Google Cloud 콘솔, gcloud CLI 또는 VMware Engine API 중 무엇을 사용하는지에 관계없이 각 노드 삭제 요청에서 한 번에 하나의 노드만 삭제할 수 있습니다.
• 사용된 총 스토리지는 클러스터에서 노드를 삭제한 후에 총 용량을 초과할 수 없습니다.
• 프라이빗 클라우드가 생성되었을 때 생성된 첫 번째 클러스터는 삭제할 수 없습니다.
• vSphere DRS 규칙(어피니티 및 안티어피니티)이 클러스터의 모든 노드에 적용되는 경우 클러스터에서 노드를 삭제할 수 없습니다. 규칙을 삭제하고 노드 삭제 작업을 다시 시도할 수 있습니다.

서브넷 보기

프라이빗 클라우드에 정의된 관리 서브넷 목록을 보려면 서브넷 탭을 선택합니다. 프라이빗 클라우드를 만들 때 생성된 HCX 서브넷이 목록에 포함됩니다.

활동 정보 보기

프라이빗 클라우드의 활동 정보를 보려면 로그 뷰어로 이동을 클릭합니다. 전체 활동 목록 및 연관된 작업을 보려면 VMware Engine 활동 모니터링을 참조하세요.

vSphere 관리 네트워크 보기

프라이빗 클라우드에 구성되어 있는 VMware 관리 리소스 및 가상 머신의 목록을 보려면 vSphere Management Network 탭을 선택합니다. 정보에는 소프트웨어 버전, 정규화된 도메인 이름(FQDN), 리소스의 IP 주소가 포함됩니다.