- 리소스: BareMetalCluster
- 상태
- BareMetalNetworkConfig
- BareMetalIslandModeCidrConfig
- BareMetalMultipleNetworkInterfacesConfig
- BareMetalSrIovConfig
- BareMetalControlPlaneConfig
- BareMetalControlPlaneNodePoolConfig
- BareMetalApiServerArgument
- BareMetalLoadBalancerConfig
- BareMetalVipConfig
- BareMetalPortConfig
- BareMetalMetalLbConfig
- BareMetalLoadBalancerAddressPool
- BareMetalLoadBalancerNodePoolConfig
- BareMetalManualLbConfig
- BareMetalBgpLbConfig
- BareMetalBgpPeerConfig
- BareMetalStorageConfig
- BareMetalProxyConfig
- BareMetalClusterOperationsConfig
- BareMetalMaintenanceConfig
- BareMetalWorkloadNodeConfig
- ContainerRuntime
- BareMetalSecurityConfig
- BareMetalMaintenanceStatus
- BareMetalMachineDrainStatus
- BareMetalDrainingMachine
- BareMetalDrainedMachine
- BareMetalNodeAccessConfig
- BareMetalOsEnvironmentConfig
- BareMetalClusterUpgradePolicy
- NodePoolPolicy
- 메서드
리소스: BareMetalCluster
베어메탈 사용자 클러스터를 나타내는 리소스입니다.
JSON 표현 |
---|
{ "name": string, "adminClusterMembership": string, "description": string, "bareMetalVersion": string, "uid": string, "state": enum ( |
필드 | |
---|---|
name |
변경할 수 없습니다. 베어메탈 사용자 클러스터 리소스 이름입니다. |
admin |
필수 입력란입니다. 이 베어메탈 사용자 클러스터가 속한 관리자 클러스터입니다. 관리자 클러스터의 Fleet 멤버십의 전체 리소스 이름입니다. |
description |
이 베어메탈 사용자 클러스터에 대한 인간이 읽을 수 있는 설명입니다. |
bare |
필수 입력란입니다. 사용자 클러스터의 베어메탈용 Anthos 클러스터 버전입니다. |
uid |
출력 전용입니다. 베어메탈 사용자 클러스터의 고유 식별자입니다. |
state |
출력 전용입니다. 베어메탈 사용자 클러스터의 현재 상태입니다. |
endpoint |
출력 전용입니다. 베어메탈 사용자 클러스터의 API 서버 IP 주소입니다. |
reconciling |
출력 전용입니다. 설정된 경우 베어메탈 사용자 클러스터에 현재 실행 중인 변경사항이 있습니다. |
create |
출력 전용입니다. 베어메탈 사용자 클러스터가 생성된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다.예: |
update |
출력 전용입니다. 베어메탈 사용자 클러스터가 마지막으로 업데이트된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다.예: |
delete |
출력 전용입니다. 베어 메탈 사용자 클러스터가 삭제된 시간입니다. 리소스가 삭제되지 않은 경우 비어 있어야 합니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다.예: |
local |
출력 전용입니다. 연결된 관리 클러스터의 베어메탈 사용자 클러스터 커스텀 리소스의 객체 이름입니다. 이 필드는 기존 클러스터를 API에 등록할 때 충돌하는 이름을 지원하는 데 사용됩니다. 클러스터 등록의 일부로 사용되는 경우 이 필드는 리소스 이름의 이름과 다릅니다. 새 클러스터의 경우 이 필드는 사용자가 제공한 클러스터 이름과 일치하며 리소스 이름의 마지막 구성요소에 표시됩니다. 수정할 수 없습니다. 로컬 이름과 클러스터 이름이 다른 경우 관리 클러스터 컨트롤러 로그에는 로컬 이름이 사용됩니다. bmctl 및 kubectl을 사용하여 클러스터에 액세스할 때 클러스터 이름을 사용합니다. |
etag |
출력 전용입니다. 이 체크섬은 다른 필드의 값을 기준으로 서버에서 계산되며, 처리 전 클라이언트에 최신 값이 적용되도록 업데이트 및 삭제 요청이 있을 때 전송될 수 있습니다. 클라이언트가 낙관적 동시 실행 제어를 통해 일관적인 읽기-수정-쓰기를 수행하도록 허용합니다. |
annotations |
베어메탈 사용자 클러스터의 주석입니다. 이 필드에는 Kubernetes 주석과 동일한 제한사항이 있습니다. 결합된 모든 키와 값의 총 크기는 256k로 제한됩니다. 키에는 슬래시(/)로 구분된 프리픽스(선택사항)와 이름(필수)의 두 가지 세그먼트가 포함될 수 있습니다. 프리픽스는 DNS 하위 도메인이어야 합니다. 이름은 63자 이하여야 하고, 영숫자로 시작해서 영숫자로 끝나야 하고, 그 사이에 대시(-), 밑줄(_), 점(.), 영숫자가 포함되어야 합니다.
|
network |
필수 입력란입니다. 네트워크 구성 |
control |
필수 입력란입니다. 제어 영역 구성 |
load |
필수 입력란입니다. 부하 분산기 구성 |
storage |
필수 입력란입니다. 스토리지 구성 |
proxy |
프록시 구성 |
cluster |
클러스터 작업 구성 |
maintenance |
유지보수 구성 |
node |
워크로드 노드 구성 |
fleet |
출력 전용입니다. 클러스터의 Fleet 구성입니다. |
status |
출력 전용입니다. 클러스터 상태 세부정보 |
validation |
출력 전용입니다. 프리플라이트 검사의 결과입니다. |
security |
보안 관련 설정 구성입니다. |
maintenance |
출력 전용입니다. 진행 중인 유지보수 작업의 상태입니다. |
admin |
출력 전용입니다. 이 사용자 클러스터를 관리하는 베어메탈 관리 클러스터의 리소스 이름입니다. |
node |
노드 액세스 관련 구성 |
os |
OS 환경 관련 구성 |
binary |
Binary Authorization 관련 구성입니다. |
upgrade |
클러스터 업그레이드 정책 |
주
베어메탈 사용자 클러스터의 수명 주기 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
설정되지 않았습니다. |
PROVISIONING |
PROVISIONING 상태는 클러스터가 생성 중임을 나타냅니다. |
RUNNING |
RUNNING 상태는 클러스터가 생성되었고 완전히 사용 가능한 상태임을 나타냅니다. |
RECONCILING |
RECONCILING 상태는 클러스터가 업데이트 중임을 나타냅니다. 계속 사용할 수 있지만 성능이 저하될 수 있습니다. |
STOPPING |
STOPPING 상태는 클러스터가 삭제 중임을 나타냅니다. |
ERROR |
ERROR 상태는 클러스터가 손상되어 복구 불가 상태임을 나타냅니다. |
DEGRADED |
DEGRADED 상태는 전체 기능을 복원하려면 클러스터에 사용자 작업이 필요함을 나타냅니다. |
BareMetalNetworkConfig
클러스터 네트워크 구성을 지정합니다.
JSON 표현 |
---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
필드 | |
---|---|
advanced |
BGP 또는 이그레스 NAT 게이트웨이를 사용하는 번들 부하 분산과 같은 고급 Anthos 네트워킹 기능을 사용 설정합니다. 고급 네트워킹 기능의 구성을 설정하면 이 플래그가 자동으로 설정됩니다. |
multiple |
다중 네트워크 인터페이스 구성 |
sr |
SR-IOV 구성 |
통합 필드 cluster_cidr_configuration . 베어메탈 사용자 클러스터에서 사용할 CIDR 구성입니다. cluster_cidr_configuration 은 다음 중 하나여야 합니다. |
|
island |
섬 모드 CIDR 구성 섬(island) 모드 네트워크에서는 노드에 고유한 IP 주소가 있지만 포드에는 클러스터 전체에서 고유한 주소가 없습니다. 한 클러스터의 포드가 다른 클러스터의 포드와 직접 통신하지 않으므로 문제가 발생하지는 않습니다. 대신 한 클러스터의 포드와 다른 클러스터의 포드를 중재하는 게이트웨이가 있습니다. |
BareMetalIslandModeCidrConfig
섬 모드에서 실행하는 동안 클러스터 CIDR 구성을 지정합니다.
JSON 표현 |
---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
필드 | |
---|---|
service |
필수 입력란입니다. 클러스터의 모든 서비스에 이 범위의 RFC1918 IPv4 주소가 할당됩니다. 이 필드는 버전 1.15부터 생성 후 변경할 수 있습니다. |
pod |
필수 입력란입니다. 클러스터의 모든 포드에 이 범위의 RFC1918 IPv4 주소가 할당됩니다. 이 필드는 생성 후 변경할 수 없습니다. |
BareMetalMultipleNetworkInterfacesConfig
다중 네트워킹 인터페이스 클러스터 구성을 지정합니다.
JSON 표현 |
---|
{ "enabled": boolean } |
필드 | |
---|---|
enabled |
포드에 여러 네트워크 인터페이스를 사용 설정할지 여부입니다. 설정하면 networkConfig.advanced_networking이 자동으로 true로 설정됩니다. |
BareMetalSrIovConfig
SR-IOV 네트워킹 연산자 구성을 지정합니다.
JSON 표현 |
---|
{ "enabled": boolean } |
필드 | |
---|---|
enabled |
SR-IOV 연산자를 설치할지 여부입니다. |
BareMetalControlPlaneConfig
제어 평면 구성을 지정합니다.
JSON 표현 |
---|
{ "controlPlaneNodePoolConfig": { object ( |
필드 | |
---|---|
control |
필수 입력란입니다. 제어 영역을 실행하는 노드 풀을 구성합니다. |
api |
기본 API 서버 args를 맞춤설정합니다. 맞춤설정된 플래그의 하위 집합만 지원됩니다. 정확한 형식은 API 서버 문서를 참고하세요. |
BareMetalControlPlaneNodePoolConfig
제어 영역 노드 풀 구성을 지정합니다.
JSON 표현 |
---|
{
"nodePoolConfig": {
object ( |
필드 | |
---|---|
node |
필수 입력란입니다. 제어 영역을 실행하는 노드 풀의 일반 구성입니다. |
BareMetalApiServerArgument
인수 이름 -> 값 쌍을 나타냅니다. 맞춤설정된 플래그의 하위 집합만 지원됩니다. 정확한 형식은 API 서버 문서를 참고하세요.
JSON 표현 |
---|
{ "argument": string, "value": string } |
필드 | |
---|---|
argument |
필수 입력란입니다. API 서버 명령줄에 표시되는 인수 이름입니다. 선행 대시를 삭제해야 합니다. |
value |
필수 입력란입니다. API 서버 명령줄에 전달될 arg 값입니다. |
BareMetalLoadBalancerConfig
부하 분산기 구성을 지정합니다.
JSON 표현 |
---|
{ "vipConfig": { object ( |
필드 | |
---|---|
vip |
부하 분산기에서 사용하는 VIP입니다. |
port |
부하 분산기가 수신 대기할 포트를 구성합니다. |
통합 필드 load_balancer_configuration . Bare Metal 사용자 클러스터의 부하 분산기 구성입니다. load_balancer_configuration 은 다음 중 하나여야 합니다. |
|
metal |
MetalLB 부하 분산기 구성입니다. |
manual |
수동으로 구성된 부하 분산기 |
bgp |
BGP 유형 부하 분산기의 구성입니다. 설정하면 networkConfig.advanced_networking이 자동으로 true로 설정됩니다. |
BareMetalVipConfig
베어메탈 부하 분산기의 VIP 구성을 지정합니다.
JSON 표현 |
---|
{ "controlPlaneVip": string, "ingressVip": string } |
필드 | |
---|---|
control |
이전에 이 베어 메탈 사용자 클러스터의 Kubernetes API에 대해 별도로 설정한 VIP입니다. |
ingress |
이전에 이 베어메탈 사용자 클러스터로의 인그레스 트래픽을 위해 별도로 설정한 VIP입니다. |
BareMetalPortConfig
베어메탈 사용자 클러스터의 부하 분산기 포트를 지정합니다.
JSON 표현 |
---|
{ "controlPlaneLoadBalancerPort": integer } |
필드 | |
---|---|
control |
제어 영역 호스팅 부하 분산기가 리슨하는 포트입니다. |
BareMetalMetalLbConfig
MetalLB 부하 분산기의 구성 매개변수를 나타냅니다.
JSON 표현 |
---|
{ "addressPools": [ { object ( |
필드 | |
---|---|
address |
필수 입력란입니다. AddressPools는 부하 분산기 유형 서비스에서 사용하는 겹치지 않는 IP 풀 목록입니다. 모든 주소는 부하 분산기 노드로 라우팅할 수 있어야 합니다. IngressVIP가 풀에 포함되어야 합니다. |
load |
부하 분산기를 실행하는 노드 풀을 지정합니다. 이 풀의 노드 간에 L2 연결이 필요합니다. 누락된 경우 컨트롤 플레인 노드 풀이 부하 분산기 풀로 사용됩니다. |
BareMetalLoadBalancerAddressPool
부하 분산기에서 사용하는 IP 풀을 나타냅니다.
JSON 표현 |
---|
{ "pool": string, "addresses": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
필드 | |
---|---|
pool |
필수 입력란입니다. 주소 풀의 이름입니다. |
addresses[] |
필수 입력란입니다. 이 풀에 포함된 주소입니다. 각 주소는 CIDR 형식 (1.2.3.0/24) 또는 범위 형식 (1.2.3.1~1.2.3.5)이어야 합니다. |
avoid |
true인 경우 .0 또는 .255로 끝나는 IP를 사용하지 마세요. 이렇게 하면 버그가 있는 소비자 기기가 특수한 IP 주소의 IPv4 트래픽을 실수로 차단하는 문제를 방지할 수 있습니다. |
manual |
이 값이 true이면 IP 주소가 자동으로 할당되지 않습니다. |
BareMetalLoadBalancerNodePoolConfig
부하 분산기의 노드 풀 구성을 지정합니다.
JSON 표현 |
---|
{
"nodePoolConfig": {
object ( |
필드 | |
---|---|
node |
부하 분산기를 실행하는 노드 풀의 일반 구성입니다. |
BareMetalManualLbConfig
수동 부하 분산기의 구성 매개변수를 나타냅니다.
JSON 표현 |
---|
{ "enabled": boolean } |
필드 | |
---|---|
enabled |
수동 부하 분산을 사용 설정했는지 여부입니다. |
BareMetalBgpLbConfig
BareMetalBgpLbConfig는 경계 게이트웨이 프로토콜 (BGP) 부하 분산기의 구성 매개변수를 나타냅니다.
JSON 표현 |
---|
{ "asn": string, "bgpPeerConfigs": [ { object ( |
필드 | |
---|---|
asn |
필수 입력란입니다. 클러스터의 BGP 자율 시스템 번호 (ASN)입니다. 이 필드는 클러스터를 만든 후 업데이트할 수 있습니다. |
bgp |
필수 입력란입니다. 클러스터가 연결될 BGP 피어 목록입니다. 각 제어 영역 노드에 피어를 하나 이상 구성해야 합니다. 제어 영역 노드는 이러한 피어에 연결하여 제어 영역 VIP를 공지합니다. 서비스 부하 분산기도 기본적으로 이러한 피어를 사용합니다. 이 필드는 클러스터를 만든 후 업데이트할 수 있습니다. |
address |
필수 입력란입니다. AddressPools는 부하 분산기 유형 서비스에서 사용하는 겹치지 않는 IP 풀 목록입니다. 모든 주소는 부하 분산기 노드로 라우팅할 수 있어야 합니다. IngressVIP가 풀에 포함되어야 합니다. |
load |
데이터 영역 부하 분산을 실행하는 노드 풀을 지정합니다. 이 풀의 노드 간에 L2 연결이 필요합니다. 누락된 경우 데이터 영역 부하 분산에 제어 영역 노드 풀이 사용됩니다. |
BareMetalBgpPeerConfig
BareMetalBgpPeerConfig는 경계 게이트웨이 프로토콜 (BGP) 피어의 구성 매개변수를 나타냅니다.
JSON 표현 |
---|
{ "asn": string, "ipAddress": string, "controlPlaneNodes": [ string ] } |
필드 | |
---|---|
asn |
필수 입력란입니다. 외부 피어 기기가 포함된 네트워크의 BGP 자율 시스템 번호 (ASN)입니다. |
ip |
필수 입력란입니다. 외부 피어 기기의 IP 주소입니다. |
control |
외부 피어에 연결되는 제어 영역 노드의 IP 주소입니다. 제어 영역 노드를 지정하지 않으면 모든 제어 영역 노드가 외부 피어에 연결할 수 있습니다. IP 주소를 하나 이상 지정하면 지정된 노드만 피어링 세션에 참가합니다. |
BareMetalStorageConfig
BareMetalStorageConfig는 클러스터 스토리지 구성을 지정합니다.
JSON 표현 |
---|
{ "lvpShareConfig": { object ( |
필드 | |
---|---|
lvp |
필수 입력란입니다. 공유 파일 시스템의 하위 디렉터리가 지원하는 로컬 PersistentVolumes의 구성을 지정합니다. 이러한 하위 디렉터리는 클러스터 생성 중에 자동으로 생성됩니다. |
lvp |
필수 입력란입니다. 마운트된 노드 디스크가 지원하는 로컬 PersistentVolumes의 구성을 지정합니다. 이러한 디스크는 클러스터 생성 전이나 후에 사용자가 포맷하고 마운트해야 합니다. |
BareMetalProxyConfig
클러스터 프록시 구성을 지정합니다.
JSON 표현 |
---|
{ "uri": string, "noProxy": [ string ] } |
필드 | |
---|---|
uri |
필수 입력란입니다. 프록시 서버의 주소를 지정합니다. 예:
|
no |
프록시를 건너뛰어야 하는 IP, 호스트 이름, 도메인의 목록입니다. 예: ["127.0.0.1", "example.com", ".corp", "localhost"]. |
BareMetalClusterOperationsConfig
베어메탈 사용자 클러스터의 관측 가능성 인프라를 지정합니다.
JSON 표현 |
---|
{ "enableApplicationLogs": boolean } |
필드 | |
---|---|
enable |
시스템 로그/측정항목 외에 애플리케이션 로그/측정항목 수집을 사용 설정해야 하는지 여부입니다. |
BareMetalMaintenanceConfig
베어메탈 노드를 유지보수 모드로 전환하거나 유지보수 모드에서 해제하는 구성을 지정합니다.
JSON 표현 |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
필드 | |
---|---|
maintenance |
필수 입력란입니다. 이 범위의 모든 IPv4 주소가 유지보수 모드로 전환됩니다. 유지보수 모드의 노드는 차단되고 배출됩니다. 이 두 가지가 모두 true인 경우 노드 리소스에 'baremetal.cluster.gke.io/maintenance' 주석이 설정됩니다. |
BareMetalWorkloadNodeConfig
워크로드 노드 구성을 지정합니다.
JSON 표현 |
---|
{
"maxPodsPerNode": string,
"containerRuntime": enum ( |
필드 | |
---|---|
max |
노드에서 실행할 수 있는 최대 포드 수입니다. 노드에 할당된 CIDR 범위의 크기는 이 매개변수에서 파생됩니다. |
container |
사용할 컨테이너 런타임을 지정합니다. |
ContainerRuntime
이 사용자 클러스터에서 컨테이너를 실행하는 데 사용되는 런타임입니다.
열거형 | |
---|---|
CONTAINER_RUNTIME_UNSPECIFIED |
선택한 컨테이너 런타임이 없습니다. |
CONTAINERD |
Containerd 런타임 |
BareMetalSecurityConfig
베어메탈 사용자 클러스터의 보안 관련 설정을 지정합니다.
JSON 표현 |
---|
{
"authorization": {
object ( |
필드 | |
---|---|
authorization |
사용자 클러스터에 대한 사용자 액세스를 구성합니다. |
BareMetalMaintenanceStatus
베어메탈 사용자 클러스터의 유지보수 상태를 나타냅니다.
JSON 표현 |
---|
{
"machineDrainStatus": {
object ( |
필드 | |
---|---|
machine |
노드 머신의 유지보수 상태입니다. |
BareMetalMachineDrainStatus
드레인 작업을 진행 중인 노드 머신의 상태를 나타냅니다.
JSON 표현 |
---|
{ "drainingMachines": [ { object ( |
필드 | |
---|---|
draining |
배수 머신 목록입니다. |
drained |
배출된 머신 목록입니다. |
BareMetalDrainingMachine
현재 배출 중인 머신을 나타냅니다.
JSON 표현 |
---|
{ "nodeIp": string, "podCount": integer } |
필드 | |
---|---|
node |
머신 IP 주소 드레이닝 |
pod |
아직 배출되지 않은 포드의 수입니다. |
BareMetalDrainedMachine
현재 전원이 소모되고 있는 머신을 나타냅니다.
JSON 표현 |
---|
{ "nodeIp": string } |
필드 | |
---|---|
node |
소모된 머신 IP 주소입니다. |
BareMetalNodeAccessConfig
베어메탈 사용자 클러스터의 노드 액세스 관련 설정을 지정합니다.
JSON 표현 |
---|
{ "loginUser": string } |
필드 | |
---|---|
login |
LoginUser는 노드 머신에 액세스하는 데 사용되는 사용자 이름입니다. 설정하지 않으면 기본값은 'root'입니다. |
BareMetalOsEnvironmentConfig
클러스터 프로비저닝의 운영체제 설정을 지정합니다.
JSON 표현 |
---|
{ "packageRepoExcluded": boolean } |
필드 | |
---|---|
package |
베어메탈 머신을 초기화할 때 패키지 저장소를 포함하지 않아야 하는지 여부입니다. |
BareMetalClusterUpgradePolicy
BareMetalClusterUpgradePolicy는 클러스터 업그레이드 정책을 정의합니다.
JSON 표현 |
---|
{
"policy": enum ( |
필드 | |
---|---|
policy |
사용할 업그레이드 정책을 지정합니다. |
pause |
출력 전용입니다. 일시중지는 업그레이드 일시중지 상태를 표시하는 데 사용됩니다. 지금은 보기 전용입니다. |
NodePoolPolicy
워커 노드 풀의 업그레이드 정책을 지정합니다.
열거형 | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
선택한 업그레이드 정책이 없습니다. |
SERIAL |
워커 노드 풀을 순차적으로 업그레이드합니다. |
CONCURRENT |
모든 워커 노드 풀을 동시에 업그레이드합니다. |
메서드 |
|
---|---|
|
특정 프로젝트 및 위치에 새 베어 메탈 클러스터를 만듭니다. |
|
단일 베어메탈 클러스터를 삭제합니다. |
|
지정된 프로젝트 및 위치 내에서 기존 베어메탈 사용자 클러스터와 노드 풀을 Anthos On-Prem API에 등록합니다. |
|
단일 베어 메탈 클러스터의 세부정보를 가져옵니다. |
|
특정 프로젝트 및 위치의 베어 메탈 클러스터를 나열합니다. |
|
단일 베어메탈 클러스터의 매개변수를 업데이트합니다. |
|
베어메탈 사용자 클러스터 버전 구성을 쿼리합니다. |