관리자 클러스터 구성 파일 1.30

이 문서에서는 Google Distributed Cloud 버전 1.29의 관리자 클러스터 구성 파일에 있는 필드를 설명합니다.

구성 파일 템플릿 생성

gkeadm을 사용하여 관리자 워크스테이션을 만든 경우 gkeadm은 관리자 클러스터 구성 파일의 템플릿을 생성했습니다. 또한 gkeadm에는 일부 필드도 채워져 있습니다.

gkeadm을 사용하여 관리자 워크스테이션을 만들지 않은 경우 gkectl을 사용하여 관리자 클러스터 구성 파일의 템플릿을 생성할 수 있습니다.

관리자 클러스터 구성 파일의 템플릿을 생성하려면 다음 안내를 따르세요.

gkectl create-config admin --config=OUTPUT_FILENAME --gke-on-prem-version=VERSION

OUTPUT_FILENAME을 생성된 템플릿에 선택한 경로로 바꿉니다. 이 플래그를 생략하면 gkectl은 파일 이름을 admin-cluster.yaml로 지정하고 현재 디렉터리에 넣습니다.

VERSION을 1.29 패치 출시 버전의 정식 버전으로 바꿉니다. 예를 들면 gkectl create-config admin --gke-on-prem-version=1.29.500-gke.160입니다. 이 버전은 gkectl 버전과 같거나 낮아야 합니다. 이 플래그를 생략하면 생성된 구성 템플릿이 최신 1.29 패치를 기반으로 하는 값으로 채워집니다.

템플릿

구성 파일 작성

구성 파일에 다음 섹션에 설명된 대로 필드 값을 입력합니다.

name

선택사항
문자열
기본값: 프리픽스가 'gke-admin-'인 임의의 이름

클러스터에 대해 사용자가 선택한 이름입니다.

예를 들면 다음과 같습니다.

name: "my-admin-cluster"

bundlePath

필수
변경 가능
문자열

Google Distributed Cloud 번들 파일의 경로입니다.

Google Distributed Cloud 전체 번들 파일에는 Google Distributed Cloud의 특정 출시 버전에 있는 모든 구성요소가 포함되어 있습니다. 관리자 워크스테이션을 만들 때는 다음 위치에서 전체 번들과 함께 제공됩니다.

/var/lib/gke/bundles/gke-onprem-vsphere-VERSION-full.tgz

예를 들면 다음과 같습니다.

bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.10.0-gke.8.full.tgz"

preparedSecrets.enabled

미리보기
선택사항
변경 불가
불리언
자동 입력: false
기본값: false

관리자 클러스터에서 준비된 사용자 인증 정보를 사용하려면 이를 true로 설정합니다. 그렇지 않으면 false로 설정합니다.

예를 들면 다음과 같습니다.

preparedSecrets:
  enabled: true

vCenter

필수
변경 불가

이 섹션에서는 사용자의 vSphere 환경과 vCenter Server 연결에 대한 정보를 제공합니다.

vCenter.address

필수
변경 불가
문자열

vCenter Server의 IP 주소 또는 호스트 이름입니다.

자세한 내용은 vCenter 서버 주소 찾기를 참조하세요.

예를 들면 다음과 같습니다.

vCenter:
  address: "203.0.113.100"
vCenter:
  address: "my-vcenter-server.my-domain.example"

vCenter.datacenter

필수
변경 불가
문자열

vSphere 데이터 센터의 상대 경로입니다.

지정하는 값은 /라는 루트 폴더를 기준으로 지정됩니다.

데이터 센터가 루트 폴더에 있으면 값은 데이터 센터의 이름입니다.

예를 들면 다음과 같습니다.

vCenter:
  datacenter: "my-data-center"

그렇지 않으면 값은 데이터 센터 이름과 함께 하나 이상의 폴더를 포함하는 상대 경로입니다.

예를 들면 다음과 같습니다.

vCenter:
  datacenter: "data-centers/data-center-1"

vCenter.cluster

필수
변경 불가
문자열

관리자 클러스터 VM이 실행될 ESXi 호스트를 나타내는 vSphere 클러스터의 상대 경로입니다. 이 vSphere 클러스터는 vCenter 데이터 센터에서 물리적 ESXi 호스트의 하위 집합을 나타냅니다.

지정하는 값은 /.../DATA_CENTER/vm/을 기준으로 합니다.

vSphere 클러스터가 /.../DATA_CENTER/vm/ 폴더에 있으면 값은 vSphere 클러스터 이름입니다.

예를 들면 다음과 같습니다.

vCenter:
  cluster: "my-vsphere-cluster"

그렇지 않으면 값은 vSphere 클러스터 이름과 함께 하나 이상의 폴더를 포함하는 상대 경로입니다.

예를 들면 다음과 같습니다.

vCenter:
  cluster: "clusters/vsphere-cluster-1"

vCenter.resourcePool

필수
변경 불가
문자열

관리자 클러스터 VM의 vCenter 리소스 풀입니다.

기본 리소스 풀을 사용하려면 VSPHERE_CLUSTER/Resources로 설정합니다.

예를 들면 다음과 같습니다.

vCenter:
  resourcePool: "my-vsphere-cluster/Resources"

이미 만든 리소스 풀을 사용하려면 리소스 풀의 상대 경로로 설정합니다.

지정하는 값은 /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/를 기준으로 합니다.

리소스 풀이 /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/의 직접 하위 요소인 경우 값은 리소스 풀의 이름입니다.

예를 들면 다음과 같습니다.

vCenter:
  resourcePool: "my-resource-pool"

그렇지 않으면 값은 2개 이상의 리소스 풀이 있는 상대 경로입니다.

예를 들면 다음과 같습니다.

vCenter:
  resourcePool: "resource-pool-1/resource-pool-2"

vCenter.datastore

vCenter.storagePolicyName이 지정되지 않은 경우 필수
변경 불가
문자열

관리자 클러스터의 vSphere 데이터 스토어 이름입니다.

지정하는 값은 경로가 아닌 이름이어야 합니다. 값에 폴더를 포함하지 마세요.

예를 들면 다음과 같습니다.

vCenter:
  datastore: "my-datastore"

vCenter.datastore 또는 vCenter.storagePolicyName 중 하나의 값을 지정해야 하며, 둘 다 지정할 수는 없습니다. 이 필드의 값을 지정할 경우 vCenter.storagePolicyName 값을 지정하지 마세요. vCenter.datastore 필드는 데이터 스토어를 스토리지 정책 기반 관리(SPBM)로 마이그레이션할 때 필드를 빈 문자열로 설정하는 경우를 제외하고 변경할 수 없습니다.

vCenter.storagePolicyName

vCenter.datastore이 지정되지 않은 경우 필수
변경 불가
문자열

클러스터 노드에 대한 VM 스토리지 정책의 이름입니다.

스토리지 정책을 사용하려면 관리자 클러스터가 고가용성(HA)이어야 합니다.

자세한 내용은 스토리지 정책 구성을 참조하세요.

vCenter.datastore 또는 vCenter.storagePolicyName 중 하나의 값을 지정해야 하며, 둘 다 지정할 수는 없습니다. 이 필드의 값을 지정할 경우 vCenter.datastore 값을 지정하지 마세요.

vCenter.caCertPath

필수
변경 가능
문자열

vCenter Server의 CA 인증서 경로입니다.

자세한 내용은 vCenter CA 인증서 가져오기를 참조하세요.

기존 클러스터의 이 필드를 업데이트하는 방법은 vCenter 인증서 참조 업데이트를 참조하세요.

예를 들면 다음과 같습니다.

vCenter:
  caCertPath: "/usr/local/google/home/me/certs/vcenter-ca-cert.pem"

vCenter.credentials.fileRef.path

필수
문자열

vCenter 사용자 계정의 사용자 이름과 비밀번호가 포함된 사용자 인증 정보 구성 파일의 경로입니다. 사용자 계정에 관리자 역할 또는 이에 상응하는 권한이 있어야 합니다.