KRM API cluster.gdc.goog/v1

cluster.gdc.goog/v1

클러스터 그룹의 API 스키마 정의를 포함합니다.

AcceleratorConfig

표시 위치: - NodePool

필드 설명
gpuPartitionScheme 문자열 GPUPartitionScheme은 GPU를 MIG로 파티셔닝하는 데 사용될 스키마를 나타냅니다. 이 스키마와 GPU DeviceModel이 공동으로 MIG 프로필을 결정합니다. 예를 들어 H100L 94GB의 mixed-1은 GPU가 4g.47gb 하나와 3g.47gb 하나로 파티셔닝되도록 결정합니다.

채널

기본 유형: string 특정 유형의 출시 채널을 나타냅니다.

표시 위치: - ReleaseChannel

클러스터

오프라인 구성에서 GDC 사용자 클러스터를 지정합니다.

표시 위치: - ClusterList

필드 설명
apiVersion 문자열 cluster.gdc.goog/v1
kind 문자열 Cluster
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ClusterSpec
status ClusterStatus

ClusterList

클러스터 컬렉션을 나타냅니다.

필드 설명
apiVersion 문자열 cluster.gdc.goog/v1
kind 문자열 ClusterList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items 클러스터 배열

ClusterNetwork

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

표시 위치: - ClusterSpec

필드 설명
podCIDRSize 정수 포드 가상 IP 주소가 할당되는 네트워크 범위의 크기입니다. 설정하지 않으면 기본값 21이 사용됩니다.
serviceCIDRSize 정수 서비스 가상 IP 주소가 할당되는 네트워크 범위의 크기입니다. 설정하지 않으면 기본값 23이 사용됩니다.

ClusterSpec

표시 위치: - 클러스터

필드 설명
initialVersion ClusterVersion 클러스터 생성 시 사용자 클러스터의 GDC 오프라인 버전 정보입니다. (선택사항) 기본적으로 최신 적용 가능 버전을 사용합니다. 변경할 수 없습니다.
releaseChannel ReleaseChannel 클러스터가 구독한 출시 채널입니다. 클러스터가 출시 채널을 구독하면 GDC에서 사용자용 클러스터 버전을 유지합니다. (선택사항) 변경 가능합니다.
clusterNetwork ClusterNetwork 클러스터 네트워크 구성입니다. 설정하지 않으면 포드 및 서비스 CIDR 크기가 있는 기본 구성이 사용됩니다. (선택사항) 변경 가능합니다.
loadBalancer LoadBalancer 부하 분산기 구성입니다. 설정하지 않으면 인그레스 서비스 IP 주소 크기가 있는 기본 구성이 사용됩니다. (선택사항) 변경 가능합니다.
nodePools NodePool 배열 클러스터 작업자 노드의 노드 풀 목록입니다. (선택사항) 변경 가능합니다.

ClusterState

기본 유형: string 클러스터의 상태를 나타냅니다.

표시 위치: - ClusterStatus

ClusterStatus

관찰된 클러스터 상태를 정의합니다.

표시 위치: - 클러스터

필드 설명
conditions Condition 배열 클러스터 상태에 대한 최신 관찰 결과입니다. ReconcilingStalled과 같은 조건은 마지막 클러스터 조정이 성공했는지 여부를 나타냅니다.
errorStatus ErrorStatus 관찰된 클러스터의 오류 상태입니다.
workerNodePoolStatuses NodePoolStatus 배열 관찰된 작업자 노드 풀의 상태 목록입니다.
controlPlaneConditions Condition 배열 컨트롤 플레인이 준비되었는지 여부입니다.
componentsConditions Condition 배열 사용자 클러스터 구성요소가 성공적으로 배포되었는지 여부입니다.
versionStatus VersionStatus 클러스터의 설치된 버전 정보입니다.
clusterState ClusterState 클러스터의 상태입니다. 다음 상태를 사용할 수 있습니다.
  • Running: 클러스터가 생성되어 사용할 수 있습니다.
  • Reconciling: 클러스터에서 일부 작업이 활발하게 진행되고 있습니다.
  • Deleting: 클러스터가 삭제되고 있습니다.
  • Error: 클러스터를 조정/프로비저닝하는 동안 일부 오류가 발생했습니다.

ClusterVersion

오프라인 구성에서 GDC 사용자 클러스터의 버전 정보를 지정합니다.

표시 위치: - ClusterSpec

필드 설명
kubernetesVersion 문자열 GDC 사용자 클러스터의 Kubernetes 버전입니다.

LoadBalancer

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

표시 위치: - ClusterSpec

필드 설명
ingressServiceIPSize 정수 부하 분산기 유형 서비스에서 사용하는 겹치지 않는 IP 풀의 크기입니다. 설정하지 않으면 기본값 20이 사용됩니다.

NodePool

NodePool 커스텀 리소스 구성을 지정합니다.

표시 위치: - ClusterSpec

필드 설명
name 문자열 노드 풀의 이름입니다.
nodeCount 정수 프로비저닝된 노드 풀의 원하는 노드 수입니다.
machineTypeName 문자열 노드를 프로비저닝하는 데 사용되는 머신 유형의 이름입니다.
taints Taint 배열 이 노드 풀의 노드에 할당된 taint입니다.
labels 객체 (키:문자열, 값:문자열) 이 노드 풀의 노드에 할당된 라벨입니다. 키-값 쌍 목록이 포함되어 있습니다.
acceleratorOptions AcceleratorConfig AcceleratorOptions는 NodePool 내에서 원하는 가속기 구성을 나타냅니다. 선택한 MachineType에 가속기가 포함된 경우에만 유효합니다.

NodePoolStatus

NodePool 리소스의 관찰된 상태를 정의합니다.

표시 위치: - ClusterStatus

필드 설명
name 문자열 노드 풀의 이름입니다.
conditions Condition 배열 노드 풀 상태에 대한 최근 관찰 결과입니다.
readyNodes 정수 게재 준비가 완료된 노드 수입니다.
reconcilingNodes 정수 조정 중인 노드 수입니다.
stalledNodes 정수 정체된 노드 수입니다.
unknownNodes 정수 상태를 알 수 없는 노드 수입니다.
readyTimestamp 시간 노드 풀이 ready 상태인 시간입니다. 이 값은 설정되면 변경되지 않습니다.
kubernetesVersion 문자열 이 노드 풀의 노드에서 실행되는 Kubernetes 버전입니다.

ReleaseChannel

클러스터가 구독한 출시 채널을 나타냅니다.

표시 위치: - ClusterSpec

필드 설명
channel 채널 설정되지 않은 경우 기본값은 UNSPECIFIED입니다.

UserClusterUpgradeRequest

클러스터 참조 및 타겟 Kubernetes 버전과 같은 사용자 클러스터 업그레이드 요청의 구성을 나타냅니다.

표시되는 위치: - UserClusterUpgradeRequestList

필드 설명
apiVersion 문자열 cluster.gdc.goog/v1
kind 문자열 UserClusterUpgradeRequest
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec UserClusterUpgradeRequestSpec
status UserClusterUpgradeRequestStatus

UserClusterUpgradeRequestList

UserClusterUpgradeRequest 리소스의 컬렉션을 나타냅니다.

필드 설명
apiVersion 문자열 cluster.gdc.goog/v1
kind 문자열 UserClusterUpgradeRequestList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items UserClusterUpgradeRequest 배열

UserClusterUpgradeRequestSpec

UserClusterUpgradeRequest 리소스의 사양(예: 원하는 상태)을 제공합니다.

표시 위치: - UserClusterUpgradeRequest

필드 설명
clusterRef LocalObjectReference 업그레이드가 적용되는 GDC 사용자 클러스터 객체에 대한 참조입니다.
targetVersion 문자열 타겟 Kubernetes 사용자 클러스터 버전입니다.

UserClusterUpgradeRequestStatus

표시 위치: - UserClusterUpgradeRequest

필드 설명
conditions Condition 배열 현재 업그레이드 상태입니다. 알려진 조건 유형: 성공했습니다.
startTime 시간 현재 업그레이드의 관찰된 시작 시간입니다.

VersionStatus

클러스터의 설치된 버전 정보를 정의합니다.

표시 위치: - ClusterStatus

필드 설명
componentVersion 문자열 클러스터의 구성요소 버전입니다.
kubernetesVersion 문자열 클러스터의 Kubernetes 버전.