REST Resource: projects.locations.vmwareAdminClusters

리소스: VmwareAdminCluster

VMware 관리자 클러스터를 나타내는 리소스입니다.

JSON 표현 
{
  "name": string,
  "description": string,
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "annotations": {
    string: string,
    ...
  },
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "localName": string,
  "bootstrapClusterMembership": string,
  "onPremVersion": string,
  "fleet": {
    object (Fleet)
  },
  "imageType": string,
  "vcenter": {
    object (VmwareAdminVCenterConfig)
  },
  "networkConfig": {
    object (VmwareAdminNetworkConfig)
  },
  "loadBalancer": {
    object (VmwareAdminLoadBalancerConfig)
  },
  "controlPlaneNode": {
    object (VmwareAdminControlPlaneNodeConfig)
  },
  "addonNode": {
    object (VmwareAdminAddonNodeConfig)
  },
  "antiAffinityGroups": {
    object (VmwareAAGConfig)
  },
  "autoRepairConfig": {
    object (VmwareAutoRepairConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "platformConfig": {
    object (VmwarePlatformConfig)
  },
  "preparedSecrets": {
    object (VmwareAdminPreparedSecretsConfig)
  },
  "authorization": {
    object (VmwareAdminAuthorizationConfig)
  },
  "validationCheck": {
    object (ValidationCheck)
  },
  "privateRegistryConfig": {
    object (VmwareAdminPrivateRegistryConfig)
  },
  "enableAdvancedCluster": boolean
}
필드
name

string

변경할 수 없습니다. VMware 관리자 클러스터 리소스 이름입니다.
description

string

이 VMware 관리자 클러스터에 대해 인간이 읽을 수 있는 설명입니다.
uid

string

출력 전용입니다. VMware 관리자 클러스터의 고유 식별자입니다.
etag

string

이 체크섬은 다른 필드의 값을 기준으로 서버에서 계산되며, 처리 전 클라이언트에 최신 값이 적용되도록 업데이트 및 삭제 요청이 있을 때 전송될 수 있습니다. 클라이언트가 낙관적 동시 실행 제어를 통해 일관적인 읽기-수정-쓰기를 수행하도록 허용합니다.
createTime

string (Timestamp format)

출력 전용입니다. VMware 관리자 클러스터가 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. VMware 관리자 클러스터가 마지막으로 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
annotations

map (key: string, value: string)

VMware 관리자 클러스터의 주석입니다. 이 필드에는 Kubernetes 주석과 동일한 제한사항이 있습니다. 결합된 모든 키와 값의 총 크기는 256k로 제한됩니다. 키에는 슬래시(/)로 구분된 프리픽스(선택사항)와 이름(필수)의 두 가지 세그먼트가 포함될 수 있습니다. 프리픽스는 DNS 하위 도메인이어야 합니다. 이름은 63자 이하여야 하고, 영숫자로 시작해서 영숫자로 끝나야 하고, 그 사이에 대시(-), 밑줄(_), 점(.), 영숫자가 포함되어야 합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
state

enum (State)

출력 전용입니다. VMware 관리자 클러스터의 현재 상태입니다.
endpoint

string

출력 전용입니다. VMware 관리자 클러스터의 API 서버의 DNS 이름입니다.
reconciling

boolean

출력 전용입니다. 설정된 경우 VMware 관리자 클러스터에 현재 실행 중인 변경사항이 있습니다.
localName

string

출력 전용입니다. VMware OnPremAdminCluster 커스텀 리소스의 객체 이름입니다. 이 필드는 기존 클러스터를 API에 등록할 때 충돌하는 이름을 지원하는 데 사용됩니다. 클러스터 등록의 일부로 사용되는 경우 이 필드는 리소스 이름의 ID와 다릅니다. 새 클러스터의 경우 이 필드는 사용자가 제공한 클러스터 이름과 일치하며 리소스 이름의 마지막 구성요소에 표시됩니다. 수정할 수 없습니다.

모든 사용자는 이 이름을 사용하여 gkectl 또는 kubectl을 통해 클러스터에 액세스해야 하며 관리자 클러스터 컨트롤러 로그를 볼 때 로컬 이름이 표시되어야 합니다.
bootstrapClusterMembership

string

이 VMware 관리자 클러스터가 속한 부트스트랩 클러스터입니다.
onPremVersion

string

관리자 클러스터의 VMware용 Anthos 클러스터 버전입니다.
fleet

object (Fleet)

출력 전용입니다. 클러스터의 Fleet 구성입니다.
imageType

string

VMware 관리자 클러스터의 OS 이미지 유형입니다.
vcenter

object (VmwareAdminVCenterConfig)

VMware 관리자 클러스터 VCenter 구성입니다.
networkConfig

object (VmwareAdminNetworkConfig)

VMware 관리자 클러스터 네트워크 구성입니다.
loadBalancer

object (VmwareAdminLoadBalancerConfig)

VMware 관리 클러스터 부하 분산기 구성입니다.
controlPlaneNode

object (VmwareAdminControlPlaneNodeConfig)

VMware 관리자 클러스터 컨트롤 플레인 노드 구성입니다.
addonNode

object (VmwareAdminAddonNodeConfig)

VMware 관리자 클러스터 부가기능 노드 구성입니다.
antiAffinityGroups

object (VmwareAAGConfig)

VMware 관리자 클러스터 안티어피니티 그룹 구성입니다.
autoRepairConfig

object (VmwareAutoRepairConfig)

VMware 관리자 클러스터 자동 복구 구성입니다.
status

object (ResourceStatus)

출력 전용입니다. 자세한 클러스터 상태를 나타내는 ResourceStatus입니다.
platformConfig

object (VmwarePlatformConfig)

VMware 플랫폼 구성입니다.
preparedSecrets

object (VmwareAdminPreparedSecretsConfig)

출력 전용입니다. VMware 관리자 클러스터 준비된 보안 비밀 구성입니다. 사용자가 설정하도록 허용하는 대신 항상 중앙 API에서 사용 설정해야 합니다.
authorization

object (VmwareAdminAuthorizationConfig)

VMware 관리자 클러스터 승인 구성입니다.
validationCheck

object (ValidationCheck)

출력 전용입니다. ValidationCheck은 프리플라이트 검사 작업의 결과를 나타냅니다.
privateRegistryConfig

object (VmwareAdminPrivateRegistryConfig)

레지스트리 구성입니다.
enableAdvancedCluster

boolean

고급 클러스터를 사용 설정합니다.

주

VMware 관리자 클러스터의 수명 주기 상태입니다.

열거형
STATE_UNSPECIFIED 설정되지 않았습니다.
PROVISIONING PROVISIONING 상태는 클러스터가 생성 중임을 나타냅니다.
RUNNING RUNNING 상태는 클러스터가 생성되었고 완전히 사용 가능한 상태임을 나타냅니다.
RECONCILING RECONCILING 상태는 클러스터가 업데이트 중임을 나타냅니다. 계속 사용할 수 있지만 성능이 저하될 수 있습니다.
STOPPING STOPPING 상태는 클러스터가 삭제 중임을 나타냅니다.
ERROR ERROR 상태는 클러스터가 손상되어 복구 불가 상태임을 나타냅니다.
DEGRADED DEGRADED 상태는 전체 기능을 복원하려면 클러스터에 사용자 작업이 필요함을 나타냅니다.

VmwareAdminVCenterConfig

VmwareAdminVCenterConfig에는 VMware 관리자 클러스터의 VCenter 구성이 포함됩니다.

JSON 표현 
{
  "resourcePool": string,
  "datastore": string,
  "datacenter": string,
  "cluster": string,
  "folder": string,
  "caCertData": string,
  "address": string,
  "dataDisk": string,
  "storagePolicyName": string
}
필드
resourcePool

string

관리자 클러스터의 vCenter 리소스 풀 이름입니다.
datastore

string

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

string

관리자 클러스터에 대한 vCenter 데이터 센터의 이름입니다.
cluster

string

관리자 클러스터의 vCenter 클러스터 이름입니다.
folder

string

관리자 클러스터의 vCenter 폴더 이름입니다.
caCertData

string

SSL 확인을 위한 vCenter CA 인증서 공개 키를 포함합니다.
address

string

vCenter IP 주소
dataDisk

string

관리자 클러스터의 가상 머신 디스크 (VMDK) 이름입니다.
storagePolicyName

string

사용자 클러스터의 vCenter 스토리지 정책 이름입니다.

VmwareAdminNetworkConfig

VmwareAdminNetworkConfig에는 VMware 관리자 클러스터의 네트워크 구성이 포함됩니다.

JSON 표현 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ],
  "vcenterNetwork": string,
  "hostConfig": {
    object (VmwareHostConfig)
  },
  "haControlPlaneConfig": {
    object (VmwareAdminHAControlPlaneConfig)
  },

  // Union field ip_configuration can be only one of the following:
  "staticIpConfig": {
    object (VmwareStaticIpConfig)
  },
  "dhcpIpConfig": {
    object (VmwareDhcpIpConfig)
  }
  // End of list of possible types for union field ip_configuration.
}
필드
serviceAddressCidrBlocks[]

string

(필수) 클러스터의 모든 서비스에 이 범위의 RFC1918 IPv4 주소가 할당됩니다. 단일 범위만 지원됩니다. 이 필드는 생성 후 변경할 수 없습니다.
podAddressCidrBlocks[]

string

(필수) 클러스터의 모든 포드에 이 범위의 RFC1918 IPv4 주소가 할당됩니다. 단일 범위만 지원됩니다. 이 필드는 생성 후 변경할 수 없습니다.
vcenterNetwork

string

vcenterNetwork는 vCenter 네트워크 이름을 지정합니다.
hostConfig

object (VmwareHostConfig)

호스트의 IP 주소와 관계없이 일반적인 네트워크 설정을 나타냅니다.
haControlPlaneConfig

object (VmwareAdminHAControlPlaneConfig)

HA 관리자 클러스터 컨트롤 플레인의 구성입니다.
통합 필드 ip_configuration. VMware 관리자 클러스터에서 사용하는 IP 구성 유형입니다. ip_configuration은 다음 중 하나여야 합니다.
staticIpConfig

object (VmwareStaticIpConfig)

고정 IP 구성의 구성 설정입니다.
dhcpIpConfig

object (VmwareDhcpIpConfig)

DHCP IP 구성의 구성 설정입니다.

VmwareAdminHAControlPlaneConfig

HA 관리자 컨트롤 플레인 구성을 지정합니다.

JSON 표현 
{
  "controlPlaneIpBlock": {
    object (VmwareIpBlock)
  }
}
필드
controlPlaneIpBlock

object (VmwareIpBlock)

관리자 컨트롤 플레인 노드의 고정 IP 주소입니다.

VmwareAdminLoadBalancerConfig

VmwareAdminLoadBalancerConfig에는 VMware 관리자 클러스터의 부하 분산기 구성이 포함됩니다.

JSON 표현 
{
  "vipConfig": {
    object (VmwareAdminVipConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "f5Config": {
    object (VmwareAdminF5BigIpConfig)
  },
  "manualLbConfig": {
    object (VmwareAdminManualLbConfig)
  },
  "metalLbConfig": {
    object (VmwareAdminMetalLbConfig)
  },
  "seesawConfig": {
    object (VmwareAdminSeesawConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
필드
vipConfig

object (VmwareAdminVipConfig)

부하 분산기에서 사용하는 VIP입니다.
통합 필드 load_balancer_configuration. VMware 관리자 클러스터에서 사용할 부하 분산기 구성입니다. load_balancer_configuration은 다음 중 하나여야 합니다.
f5Config

object (VmwareAdminF5BigIpConfig)

F5 Big IP 유형 부하 분산기의 구성입니다.
manualLbConfig

object (VmwareAdminManualLbConfig)

수동으로 구성된 부하 분산기입니다.
metalLbConfig

object (VmwareAdminMetalLbConfig)

MetalLB 부하 분산기입니다.
seesawConfig

object (VmwareAdminSeesawConfig)

출력 전용입니다. Seesaw 유형 부하 분산기의 구성입니다.

VmwareAdminVipConfig

VMware 부하 분산기 구성의 VmwareAdminVipConfig입니다.

JSON 표현 
{
  "controlPlaneVip": string,
  "addonsVip": string
}
필드
controlPlaneVip

string

이전에 관리자 클러스터의 Kubernetes API에 대해 별도로 설정한 VIP입니다.
addonsVip

string

부가기능의 부하 분산기를 구성할 VIP입니다.

VmwareAdminF5BigIpConfig

VmwareAdminF5BigIpConfig는 F5 BIG-IP 부하 분산기의 구성 매개변수를 나타냅니다.

JSON 표현 
{
  "address": string,
  "partition": string,
  "snatPool": string
}
필드
address

string

부하 분산기의 IP 주소입니다.
partition

string

부하 분산기에서 사용할 기존 파티션입니다. 이 파티션은 일반적으로 관리자 클러스터용으로 생성됩니다(예: 'my-f5-admin-partition').
snatPool

string

풀 이름입니다. SNAT를 사용하는 경우에만 필요합니다.

VmwareAdminManualLbConfig

JSON 표현 
{
  "ingressHttpNodePort": integer,
  "ingressHttpsNodePort": integer,
  "controlPlaneNodePort": integer,
  "konnectivityServerNodePort": integer,
  "addonsNodePort": integer
}
필드
ingressHttpNodePort

integer

인그레스 서비스의 http에 대한 NodePort입니다. 관리자 클러스터의 인그레스 서비스는 NodePort 유형의 서비스로 구현됩니다(예: 32527).
ingressHttpsNodePort

integer

인그레스 서비스의 https용 NodePort입니다. 관리자 클러스터의 인그레스 서비스는 NodePort 유형의 서비스로 구현됩니다(예: 30139).
controlPlaneNodePort

integer

컨트롤 플레인 서비스의 NodePort입니다. 관리자 클러스터의 Kubernetes API 서버는 NodePort 유형의 서비스입니다(예: 30968).
konnectivityServerNodePort

integer

각 kube-apiserver 포드에서 사이드카로 실행되는 연결 서버 서비스의 NodePort입니다(예: 30564).
addonsNodePort

integer

관리자 클러스터의 부가기능 서버에 대한 NodePort입니다.

VmwareAdminMetalLbConfig

VmwareAdminMetalLbConfig는 MetalLB 부하 분산기의 구성 매개변수를 나타냅니다. 관리자 클러스터의 경우 현재 구성이 필요하지 않습니다.

JSON 표현 
{
  "enabled": boolean
}
필드
enabled

boolean

MetalLB 사용 설정 여부입니다.

VmwareAdminSeesawConfig

VmwareSeesawConfig는 이미 존재하는 Seesaw 부하 분산기의 구성 매개변수를 나타냅니다.

중요: Anthos On-Prem API는 Seesaw 구성을 생성하거나 업데이트하지 않으며, 기존 구성을 새 사용자 클러스터에 바인딩하기만 합니다.

중요: 기존 Seesaw 부하 분산기를 사용하여 사용자 클러스터를 만들려면 'vmwareClusters.create' API 메서드를 호출하기 전에 몇 가지 준비 단계를 따라야 합니다. 먼저 kubectl을 통해 사용자 클러스터의 네임스페이스를 만들어야 합니다. 네임스페이스는 다음 이름 지정 규칙을 사용해야 합니다. 'VmwareCluster.local_name'을 사용하여 충돌을 구분했는지 여부에 따라 -gke-onprem-mgmt 또는 -gke-onprem-mgmt가 됩니다. 자세한 'VmwareCluster.local_name' 문서를 참고하세요. 네임스페이스가 생성되면 kubectl을 통해 보안 비밀 리소스를 만들어야 합니다. 이 보안 비밀에는 Seesaw 사용자 인증 정보의 사본이 포함됩니다. 보안 비밀의 이름은 'user-cluster-creds'여야 하며 Seesaw의 SSH 및 인증서 사용자 인증 정보가 포함되어야 합니다. 사용자 인증 정보는 'seesaw-ssh-private-key', 'seesaw-ssh-public-key', 'seesaw-ssh-ca-key', 'seesaw-ssh-ca-cert'라는 이름으로 키가 지정되어야 합니다.

JSON 표현 
{
  "group": string,
  "masterIp": string,
  "ipBlocks": [
    {
      object (VmwareIpBlock)
    }
  ],
  "enableHa": boolean,
  "vms": [
    string
  ],
  "stackdriverName": string
}
필드
group

string

일반적으로 Seesaw 그룹 이름에는 seesaw-for-[clusterName] 형식을 사용해야 합니다.
masterIp

string

MasterIP는 Seesaw 그룹의 마스터가 공지한 IP입니다.
ipBlocks[]

object (VmwareIpBlock)

Seesaw 부하 분산기에서 사용할 IP 블록
enableHa

boolean

고가용성 Seesaw 부하 분산기를 구현하려면 부하 분산기 VM을 두 개 사용 설정하세요.
vms[]

string

이 Seesaw 그룹에 대해 생성된 VM의 이름입니다.
stackdriverName

string

Stackdriver에서 사용할 이름입니다.

VmwareAdminControlPlaneNodeConfig

VmwareAdminControlPlaneNodeConfig에는 VMware 관리자 클러스터의 컨트롤 플레인 노드 구성이 포함됩니다.

JSON 표현 
{
  "cpus": string,
  "memory": string,
  "replicas": string
}
필드
cpus

string (int64 format)

관리자 클러스터의 컨트롤 플레인 노드에 대한 vCPU 수입니다.
memory

string (int64 format)

관리자 클러스터의 컨트롤 플레인 노드에 대한 메모리 용량 수(메비바이트)입니다.
replicas

string (int64 format)

이 VMware 관리자 클러스터의 컨트롤 플레인 노드 수입니다. (기본값: 복제본 1개)

VmwareAdminAddonNodeConfig

VmwareAdminAddonNodeConfig에는 VMware 관리자 클러스터의 부가기능 노드 구성이 포함됩니다.

JSON 표현 
{
  "autoResizeConfig": {
    object (VmwareAutoResizeConfig)
  }
}
필드
autoResizeConfig

object (VmwareAutoResizeConfig)

VmwareAutoResizeConfig 구성은 자동 크기 조절 구성을 지정합니다.

VmwarePlatformConfig

VmwarePlatformConfig는 VMware 플랫폼의 구성을 나타냅니다.

JSON 표현 
{
  "requiredPlatformVersion": string,
  "platformVersion": string,
  "bundles": [
    {
      object (VmwareBundleConfig)
    }
  ],
  "status": {
    object (ResourceStatus)
  }
}
필드
requiredPlatformVersion

string

입력 전용입니다. 필수 플랫폼 버전(예: 1.13.1) 현재 플랫폼 버전이 타겟 버전보다 낮은 경우 플랫폼 버전이 타겟 버전으로 업데이트됩니다. 타겟 버전이 플랫폼에 설치되어 있지 않으면 (번들 버전) 타겟 버전 번들을 다운로드합니다.
platformVersion

string

출력 전용입니다. 플랫폼 버전(예: 1.13.2)
bundles[]

object (VmwareBundleConfig)

출력 전용입니다. 관리자 클러스터에 설치된 번들 목록입니다.
status

object (ResourceStatus)

출력 전용입니다. 플랫폼의 리소스 상태입니다.

VmwareBundleConfig

VmwareBundleConfig는 번들의 구성을 나타냅니다.

JSON 표현 
{
  "version": string,
  "status": {
    object (ResourceStatus)
  }
}
필드
version

string

번들의 버전입니다.
status

object (ResourceStatus)

출력 전용입니다. 번들의 리소스 상태입니다.

VmwareAdminPreparedSecretsConfig

VmwareAdminPreparedSecretsConfig는 관리자 클러스터 준비된 보안 비밀의 구성을 나타냅니다.

JSON 표현 
{
  "enabled": boolean
}
필드
enabled

boolean

준비된 보안 비밀이 사용 설정되어 있는지 여부입니다.

VmwareAdminAuthorizationConfig

VmwareAdminAuthorizationConfig는 관리 클러스터 승인 구성을 나타냅니다.

JSON 표현 
{
  "viewerUsers": [
    {
      object (ClusterUser)
    }
  ]
}
필드
viewerUsers[]

object (ClusterUser)

VMware 관리자 클러스터의 경우 사용자에게 클러스터에 대한 클러스터 뷰어 역할이 부여됩니다.

VmwareAdminPrivateRegistryConfig

VmwareAdminPrivateRegistryConfig는 관리자 클러스터 레지스트리의 구성을 나타냅니다.

JSON 표현 
{
  "address": string,
  "caCert": string
}
필드
address

string

레지스트리 주소입니다.
caCert

string

컨테이너 런타임이 비공개 레지스트리에서 이미지를 가져올 때 레지스트리는 인증서를 제공하여 해당 ID를 입증해야 합니다. 레지스트리의 인증서는 인증 기관 (CA)에 의해 서명됩니다. 컨테이너 런타임은 CA 인증서를 사용하여 레지스트리 인증서를 검증합니다.

메서드

create

 특정 프로젝트 및 위치에 새 VMware 관리자 클러스터를 만듭니다.

enroll

 특정 프로젝트 및 위치 내에서 기존 VMware 관리자 클러스터를 Anthos On-Prem API에 등록합니다.

get

 단일 VMware 관리자 클러스터의 세부정보를 가져옵니다.

list

 특정 프로젝트 및 위치의 VMware 관리자 클러스터를 나열합니다.

patch

 단일 VMware 관리자 클러스터 파라미터를 업데이트합니다.