클러스터 구성에서 vSphere 폴더 지정

이 문서에서는 vCenter 구성에 상위 폴더가 포함되어 있을 때 클러스터 구성 파일에 vSphere 객체를 지정하는 방법을 보여줍니다. 또한 1.13.0부터 프리플라이트 검증에서 적용하는 이름 지정 규칙에 대해서도 설명합니다.

다음 예시에서는 vCenter 루트에서 특정 객체까지의 경로를 나타내는 vCenter 구성을 가정합니다.

호스트 및 클러스터

VM 및 템플릿

스토리지

네트워크

my-vcenter
  my-datacenter-folder
    my-datacenter
      my-cluster-folder
        my-cluster
          my-resourcepool
        
my-vcenter
  my-datacenter-folder
    my-datacenter
      my-vm-folder
        
my-vcenter
  my-datacenter-folder
    my-datacenter
      my-storage-folder
        my-datastore
        
my-vcenter
  my-datacenter-folder
    my-datacenter
      my-network-folder
        my-portgroup
        

my-datastore 및 my-portgroup을 사용하여 my-resource-pool 및 my-vm-folder에서 Anthos 클러스터를 만들려면 다음 관리자 클러스터 구성을 지정합니다.

    vCenter:
      address: "my-vcenter"
      datacenter: "my-datacenter-folder/my-datacenter"
      cluster: "my-cluster-folder/my-cluster"
      resourcePool: "my-resourcepool"
      datastore: "my-datastore"
      folder: "my-vm-folder"
    network:
      vCenter:
        networkName: "my-network-folder/my-portgroup"

  

리소스 풀이 다른 리소스 풀 아래에 중첩되어 있는 경우 다음 예시와 같이 관리자 클러스터 구성에서 리소스 풀의 전체 경로를 지정하세요.

    vCenter:
      address: "my-vcenter"
      datacenter: "my-datacenter-folder/my-datacenter"
      cluster: "my-cluster-folder/my-cluster"
      resourcePool: "my-cluster-folder/my-cluster/Resources/my-resourcepool/my-nested-resourcepool"
      datastore: "my-datastore"
      folder: "my-vm-folder"
    network:
      vCenter:
        networkName: "my-network-folder/my-portgroup"
  

my-datastore 및 my-portgroup을 사용하여 기본 ResourcePool에 Anthos 관리자 클러스터를 만들려면 다음 클러스터 구성을 지정합니다.

    vCenter:
      address: "my-vcenter"
      datacenter: "my-datacenter-folder/my-datacenter"
      cluster: "my-cluster-folder/my-cluster"
      resourcePool: "my-cluster-folder/my-cluster/Resources"
      datastore: "my-datastore"
      folder: "my-vm-folder"
    network:
      vCenter:
        networkName: "my-network-folder/my-portgroup"
  

VM 폴더가 다른 VM 폴더에 중첩된 경우 다음 예시와 같이 관리자 클러스터 구성의 VM 폴더에 대한 전체 경로를 지정합니다.

    vCenter:
      address: "my-vcenter"
      datacenter: "my-datacenter-folder/my-datacenter"
      cluster: "my-cluster-folder/my-cluster"
      resourcePool: "my-resourcepool"
      datastore: "my-datastore"
      folder: "/my-datacenter-folder/my-datacenter/vm/my-vm-folder/my-nested-vm-folder"
    network:
      vCenter:
        networkName: "my-network-folder/my-portgroup"
  

VM 폴더 전체 경로에 첫 번째 '/'를 포함해야 합니다.

vCenter 섹션은 이러한 구성 파일에 공통적으로 적용되므로 사용자 클러스터 및 관리자 워크스테이션 구성에도 적용됩니다.

이름 지정 규칙

데이터 스토어 이름은 데이터 센터 내에서 고유해야 하므로 데이터 스토어를 지정할 때 상위 폴더를 지정하지 마세요. 폴더가 지정되면 다음 오류가 반환됩니다.

  Datastore name 'storage-folder/my-datastore' should not contain parent folders

다른 모든 vSphere 객체 유형에서는 vCenter 구성에 상위 폴더가 포함되어 있으면 상위 폴더를 지정해야 합니다. 필요한 상위 폴더가 클러스터 구성에 지정되지 않았지만 vCenter 구성에는 존재하는 경우 다음 오류가 반환됩니다.

 Parent folder is not specified for cluster, you must specify the full path 'clusters/my-cluster' in the cluster field  
VMware용 Anthos 클러스터 1.13.0부터 위 규칙에 따라 다음 작업에 대해 vSphere 객체 이름을 검증합니다.

  • gkectl create
  • gkectl check-config

다음과 같은 예시 상황에서는 vSphere 객체 변환이 여전히 모호할 수 있습니다.

  • 클러스터가 이름 지정 규칙을 위반하는 이전 버전에서 업그레이드되며 vCenter 구성에 충돌하는 폴더/객체가 포함되어 있습니다.
  • 클러스터 생성 중에는 이름이 충돌하는 객체가 없었으나 나중에 추가되었습니다.

예를 들어 특정 vCenter 구성을 가정해 보겠습니다.

 
my-vcenter
  my-datacenter-folder
    my-datacenter
      my-cluster-folder
        my-cluster
          my-resourcepool
  

나중에 다음과 같은 계층 구조가 추가되는 경우

my-vcenter
  my-datacenter-folder
    my-datacenter
      my-cluster
        my-resourcepool
  

클러스터 생성 중에 구성 파일이 my-cluster-folder를 지정하지 않으면 'my-resourcepool'의 변환이 모호합니다.

다음 오류가 발생할 수 있습니다. path 'my-resourcepool' resolves to multiple resource pools

일반적으로는 객체 변환이 모호한 경우 vSphere 라이브러리가 다음 오류 메시지를 반환합니다.

 path xxx resolves to multiple objects 

이 오류를 해결하려면 경로에 충돌하는 객체 이름(예: 폴더 내에 있는 객체 이름과 폴더가 없는 객체 이름)이 포함되지 않았는지 확인합니다. 클러스터에 속하지 않아 충돌을 일으키는 객체를 삭제하거나 이름을 바꿉니다. vSphere 필드는 클러스터를 만든 후에 변경할 수 없으므로 vCenter 구성을 수정하여 충돌을 해결할 수 없는 경우 새 클러스터를 만들어야 합니다.