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)

섬 모드 CIDR의 구성입니다.

BareMetalAdminIslandModeCidrConfig

BareMetalAdminIslandModeCidrConfig는 섬 모드에서 실행되는 동안 클러스터 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

단일 Bare Metal Admin 클러스터의 세부정보를 가져옵니다.

list

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

patch

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

queryVersionConfig

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