kind: Cluster

gpt-5.icon

公式の Kubernetes API には kind: Cluster というオブジェクトは定義されていません。

kind: Cluster が出てくるのは “kubernetes-sigs/kind” や “Cluster API” の世界

🧩 パターン① kind (Kubernetes IN Docker)

kind コマンド（kind.sigs.k8s.io）を使ってローカルにクラスターを作るツールがあります。

このツールでは、クラスター定義ファイルに kind: Cluster を書きます。

これは kind専用の設定ファイル形式です。

code:yaml

# kind 用のクラスター構成ファイルの例

kind: Cluster

apiVersion: kind.x-k8s.io/v1alpha4

nodes:

- role: control-plane

- role: worker

これを使って、Dockerコンテナ上にミニKubernetesクラスタを作ることができます👇

$ kind create cluster --config kind-cluster.yml

👉 この Cluster は Kubernetesの中のリソースではなく、Kubernetes自体を構築するための設定。

🧩 パターン② Cluster API (CAPI)

もう一つ、Cluster API という上位レイヤーのプロジェクトでも kind: Cluster が登場します。

code:yaml

apiVersion: cluster.x-k8s.io/v1beta1

kind: Cluster

metadata:

spec:

controlPlaneRef:

apiVersion: controlplane.cluster.x-k8s.io/v1beta1

kind: KubeadmControlPlane

infrastructureRef:

apiVersion: infrastructure.cluster.x-k8s.io/v1beta1

kind: DockerCluster

こちらは「別のクラスターを作るためのKubernetes上の管理レイヤー」（Cluster API）です。

つまり、「メタKubernetes」のような仕組みで、KubernetesをKubernetesで管理する世界観。