REST Resource: projects.locations.bareMetalAdminClusters

리소스: BareMetalAdminCluster

베어메탈 관리자 클러스터를 나타내는 리소스입니다.

JSON 표현 
{
  "name": string,
  "description": string,
  "uid": string,
  "bareMetalVersion": string,
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "localName": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "networkConfig": {
    object (BareMetalAdminNetworkConfig)
  },
  "controlPlane": {
    object (BareMetalAdminControlPlaneConfig)
  },
  "loadBalancer": {
    object (BareMetalAdminLoadBalancerConfig)
  },
  "storage": {
    object (BareMetalAdminStorageConfig)
  },
  "fleet": {
    object (Fleet)
  },
  "clusterOperations": {
    object (BareMetalAdminClusterOperationsConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "maintenanceConfig": {
    object (BareMetalAdminMaintenanceConfig)
  },
  "maintenanceStatus": {
    object (BareMetalAdminMaintenanceStatus)
  },
  "validationCheck": {
    object (ValidationCheck)
  },
  "nodeConfig": {
    object (BareMetalAdminWorkloadNodeConfig)
  },
  "proxy": {
    object (BareMetalAdminProxyConfig)
  },
  "securityConfig": {
    object (BareMetalAdminSecurityConfig)
  },
  "nodeAccessConfig": {
    object (BareMetalAdminNodeAccessConfig)
  },
  "osEnvironmentConfig": {
    object (BareMetalAdminOsEnvironmentConfig)
  },
  "binaryAuthorization": {
    object (BinaryAuthorization)
  }
}
필드
name

string

변경할 수 없습니다. 베어메탈 관리자 클러스터의 리소스 이름입니다.
description

string

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

string

출력 전용입니다. 베어 메탈 관리자 클러스터의 고유 식별자입니다.
bareMetalVersion

string

베어메탈 관리자 클러스터를 위한 베어메탈용 Anthos 클러스터 버전입니다.
state

enum (State)

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

string

출력 전용입니다. 베어메탈 관리자 클러스터의 API 서버의 IP 주소 이름입니다.
reconciling

boolean

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

string (Timestamp format)

출력 전용입니다. 이 베어메탈 관리자 클러스터가 생성된 시간입니다.

생성된 출력은 항상 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)

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

생성된 출력은 항상 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"입니다.
deleteTime

string (Timestamp format)

출력 전용입니다. 이 베어메탈 관리자 클러스터가 삭제된 시간입니다. 리소스가 삭제되지 않은 경우 비어 있어야 합니다.

생성된 출력은 항상 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"입니다.
localName

string

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

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

string

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

map (key: string, value: string)

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

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

object (BareMetalAdminNetworkConfig)

네트워크 구성
controlPlane

object (BareMetalAdminControlPlaneConfig)

컨트롤 플레인 구성
loadBalancer

object (BareMetalAdminLoadBalancerConfig)

부하 분산기 구성
storage

object (BareMetalAdminStorageConfig)

스토리지 구성
fleet

object (Fleet)

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

object (BareMetalAdminClusterOperationsConfig)

클러스터 작업 구성
status

object (ResourceStatus)

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

object (BareMetalAdminMaintenanceConfig)

유지보수 구성
maintenanceStatus

object (BareMetalAdminMaintenanceStatus)

출력 전용입니다. 유지보수 상태를 나타내는 MaintenanceStatus입니다.
validationCheck

object (ValidationCheck)

출력 전용입니다. 프리플라이트 검사의 결과를 나타내는 ValidationCheck입니다.
nodeConfig

object (BareMetalAdminWorkloadNodeConfig)

워크로드 노드 구성입니다.
proxy

object (BareMetalAdminProxyConfig)

프록시 구성입니다.
securityConfig

object (BareMetalAdminSecurityConfig)

보안 관련 구성입니다.
nodeAccessConfig

object (BareMetalAdminNodeAccessConfig)

노드 액세스 관련 구성입니다.
osEnvironmentConfig

object (BareMetalAdminOsEnvironmentConfig)

OS 환경 관련 구성입니다.
binaryAuthorization

object (BinaryAuthorization)

Binary Authorization 관련 구성입니다.

상태

베어메탈 관리자 클러스터의 수명 주기 상태입니다.

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

BareMetalAdminNetworkConfig

BareMetalAdminNetworkConfig는 클러스터 네트워크 구성을 지정합니다.

JSON 표현 
{

  // Union field cluster_cidr_configuration can be only one of the following:
  "islandModeCidr": {
    object (BareMetalAdminIslandModeCidrConfig)
  }
  // End of list of possible types for union field cluster_cidr_configuration.
}
필드
통합 필드 cluster_cidr_configuration. 관리자 클러스터에서 사용할 CIDR 구성입니다. cluster_cidr_configuration은 다음 중 하나여야 합니다.
islandModeCidr

object (BareMetalAdminIslandModeCidrConfig)

섬(island) 모드 CIDR의 구성입니다.

BareMetalAdminIslandModeCidrConfig

BareMetalAdminIslandModeCidrConfig는 섬(island) 모드에서 실행하는 동안 클러스터 CIDR 구성을 지정합니다.

JSON 표현 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ]
}
필드
serviceAddressCidrBlocks[]

string

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

string

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

BareMetalAdminControlPlaneConfig

BareMetalAdminControlPlaneConfig는 컨트롤 플레인 구성을 지정합니다.

JSON 표현 
{
  "controlPlaneNodePoolConfig": {
    object (BareMetalAdminControlPlaneNodePoolConfig)
  },
  "apiServerArgs": [
    {
      object (BareMetalAdminApiServerArgument)
    }
  ]
}
필드
controlPlaneNodePoolConfig

object (BareMetalAdminControlPlaneNodePoolConfig)

필수 항목입니다. 컨트롤 플레인을 실행하는 노드 풀을 구성합니다. 지정하면 클러스터의 컨트롤 플레인에 해당하는 NodePool이 생성됩니다. NodePool의 이름과 네임스페이스는 클러스터와 동일합니다.
apiServerArgs[]

object (BareMetalAdminApiServerArgument)

기본 API 서버 args를 맞춤설정합니다. 맞춤설정된 플래그의 하위 집합만 지원됩니다. 정확한 형식은 아래 API 서버 문서를 참조하세요. https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

BareMetalAdminControlPlaneNodePoolConfig

BareMetalAdminControlPlaneNodePoolConfig는 컨트롤 플레인 노드 풀 구성을 지정합니다. 향후 컨트롤 플레인별 필드를 유연하게 지원할 수 있도록 컨트롤 플레인별 노드 풀 구성이 있습니다.

JSON 표현 
{
  "nodePoolConfig": {
    object (BareMetalNodePoolConfig)
  }
}
필드
nodePoolConfig

object (BareMetalNodePoolConfig)

필수 항목입니다. 컨트롤 플레인을 실행하는 노드 풀의 일반 구성입니다.

BareMetalAdminApiServerArgument

BareMetalAdminApiServerArgument는 arg 이름 -> 값 쌍을 나타냅니다. 맞춤설정된 플래그의 하위 집합만 지원됩니다. 정확한 형식은 아래 API 서버 문서를 참조하세요. https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

JSON 표현 
{
  "argument": string,
  "value": string
}
필드
argument

string

필수 항목입니다. API 서버 명령줄에 표시되는 인수 이름입니다. 선행 대시를 삭제해야 합니다.
value

string

필수 항목입니다. API 서버 명령줄에 전달될 arg 값입니다.

BareMetalAdminLoadBalancerConfig

BareMetalAdminLoadBalancerConfig는 부하 분산기 구성을 지정합니다.

JSON 표현 
{
  "vipConfig": {
    object (BareMetalAdminVipConfig)
  },
  "portConfig": {
    object (BareMetalAdminPortConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "manualLbConfig": {
    object (BareMetalAdminManualLbConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
필드
vipConfig

object (BareMetalAdminVipConfig)

부하 분산기에서 사용하는 VIP입니다.
portConfig

object (BareMetalAdminPortConfig)

부하 분산기에서 리슨할 포트를 구성합니다.
통합 필드 load_balancer_configuration. 관리자 클러스터에서 사용할 부하 분산기 구성입니다. load_balancer_configuration은 다음 중 하나여야 합니다.
manualLbConfig

object (BareMetalAdminManualLbConfig)

수동으로 구성된 부하 분산기

BareMetalAdminVipConfig

베어메탈 부하 분산기 구성을 위한 BareMetalAdminVipConfig입니다.

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

string

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

BareMetalAdminPortConfig

BareMetalAdminPortConfig는 부하 분산기 포트의 사양입니다.

JSON 표현 
{
  "controlPlaneLoadBalancerPort": integer
}
필드
controlPlaneLoadBalancerPort

integer

컨트롤 플레인 호스팅 부하 분산기가 리슨할 포트입니다.

BareMetalAdminManualLbConfig

BareMetalAdminManualLbConfig는 수동 부하 분산기의 구성 매개변수를 나타냅니다.

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

boolean

수동 부하 분산을 사용 설정할지 여부입니다.

BareMetalAdminStorageConfig

BareMetalAdminStorageConfig는 클러스터 스토리지 구성을 지정합니다.

JSON 표현 
{
  "lvpShareConfig": {
    object (BareMetalLvpShareConfig)
  },
  "lvpNodeMountsConfig": {
    object (BareMetalLvpConfig)
  }
}
필드
lvpShareConfig

object (BareMetalLvpShareConfig)

필수 항목입니다. 공유 파일 시스템의 하위 디렉터리가 지원하는 로컬 PersistentVolumes의 구성을 지정합니다. 이러한 하위 디렉터리는 클러스터 생성 중에 자동으로 생성됩니다.
lvpNodeMountsConfig

object (BareMetalLvpConfig)

필수 항목입니다. 마운트된 노드 디스크가 지원하는 로컬 PersistentVolumes의 구성을 지정합니다. 이러한 디스크는 클러스터 생성 전이나 후에 사용자가 포맷하고 마운트해야 합니다.

BareMetalAdminClusterOperationsConfig

BareMetalAdminClusterOperationsConfig는 관리자 클러스터의 모니터링 가능성 인프라를 지정합니다.

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

boolean

시스템 로그/측정항목 외에 애플리케이션 로그/측정항목 수집을 사용 설정해야 하는지 여부입니다.

BareMetalAdminMaintenanceConfig

BareMetalAdminMaintenanceConfig는 베어메탈 관리자 클러스터 CR 노드를 유지보수 모드로 전환하거나 유지보수 모드에서 해제하는 구성을 지정합니다.

JSON 표현 
{
  "maintenanceAddressCidrBlocks": [
    string
  ]
}
필드
maintenanceAddressCidrBlocks[]

string

필수 항목입니다. 이 범위의 모든 IPv4 주소가 유지보수 모드로 전환됩니다. 유지보수 모드의 노드는 차단되고 드레이닝됩니다. 이 두 가지가 모두 true인 경우 노드 리소스에 'baremetal.cluster.gke.io/maintenance' 주석이 설정됩니다.

BareMetalAdminMaintenanceStatus

BareMetalAdminMaintenanceStatus는 베어메탈 관리자 클러스터 CR 노드의 유지보수 상태를 나타냅니다.

JSON 표현 
{
  "machineDrainStatus": {
    object (BareMetalAdminMachineDrainStatus)
  }
}
필드
machineDrainStatus

object (BareMetalAdminMachineDrainStatus)

드레이닝 중인 머신 노드와 드레이닝된 머신 노드의 상태를 나타냅니다. 클러스터 업그레이드의 진행률을 표시하는 데 사용됩니다.

BareMetalAdminMachineDrainStatus

BareMetalAdminMachineDrainStatus는 드레인 작업을 진행 중인 베어메탈 노드 머신의 상태를 나타냅니다.

JSON 표현 
{
  "drainingMachines": [
    {
      object (BareMetalAdminDrainingMachine)
    }
  ],
  "drainedMachines": [
    {
      object (BareMetalAdminDrainedMachine)
    }
  ]
}
필드
drainingMachines[]

object (BareMetalAdminDrainingMachine)

드레이닝하는 머신 목록입니다.
drainedMachines[]

object (BareMetalAdminDrainedMachine)

드레이닝된 머신 목록입니다.

BareMetalAdminDrainingMachine

BareMetalAdminDrainingMachine은 현재 드레이닝 중인 머신을 나타냅니다.

JSON 표현 
{
  "nodeIp": string,
  "podCount": integer
}
필드
nodeIp

string

드레이닝하는 머신 IP 주소입니다.
podCount

integer

아직 드레이닝되지 않은 포드의 수입니다.

BareMetalAdminDrainedMachine

BareMetalAdminDrainedMachine은 드레이닝된 머신을 나타냅니다.

JSON 표현 
{
  "nodeIp": string
}
필드
nodeIp

string

드레이닝된 머신 IP 주소입니다.

BareMetalAdminWorkloadNodeConfig

BareMetalAdminWorkloadNodeConfig는 워크로드 노드 구성을 지정합니다.

JSON 표현 
{
  "maxPodsPerNode": string
}
필드
maxPodsPerNode

string (int64 format)

노드에서 실행할 수 있는 최대 포드 수입니다. 노드에 할당된 CIDR 범위의 크기는 이 매개변수에서 파생됩니다. 기본적으로 노드당 110개의 포드가 생성됩니다. HA 관리자 클러스터와 HA가 아닌 관리자 클러스터의 상한값은 모두 250입니다. 하한값은 HA가 아닌 관리자 클러스터의 경우 64이고 HA 관리자 클러스터의 경우 32입니다.

BareMetalAdminProxyConfig

BareMetalAdminProxyConfig는 클러스터 프록시 구성을 지정합니다.

JSON 표현 
{
  "uri": string,
  "noProxy": [
    string
  ]
}
필드
uri

string

필수 항목입니다. 프록시 서버의 주소를 지정합니다. 예: http://domain

경고: http://(username:password@)domain 형식으로 사용자 인증 정보를 제공하지 마세요. 서버에서 거부됩니다.
noProxy[]

string

프록시를 건너뛰어야 하는 IP, 호스트 이름, 도메인의 목록입니다. 예: ['127.0.0.1', 'example.com', '.corp', 'localhost']

BareMetalAdminSecurityConfig

베어메탈 관리자 클러스터의 보안 관련 설정을 지정합니다.

JSON 표현 
{
  "authorization": {
    object (Authorization)
  }
}
필드
authorization

object (Authorization)

관리자 클러스터에 대한 사용자 액세스를 구성합니다.

BareMetalAdminNodeAccessConfig

베어메탈 관리자 클러스터의 노드 액세스 관련 설정을 지정합니다.

JSON 표현 
{
  "loginUser": string
}
필드
loginUser

string

필수 항목입니다. LoginUser는 노드 머신에 액세스하는 데 사용되는 사용자 이름입니다. 설정하지 않으면 기본값은 'root'입니다.

BareMetalAdminOsEnvironmentConfig

클러스터 프로비저닝의 운영체제 작업 설정을 지정합니다.

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

boolean

베어메탈 머신을 초기화할 때 패키지 저장소를 추가해야 하는지 여부입니다.

메서드

create

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

enroll

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

get

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

list

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

patch

 단일 베어메탈 관리자 클러스터의 매개변수를 업데이트합니다.

queryVersionConfig

 베어메탈 관리자 클러스터 버전 구성을 쿼리합니다.