ワークロードクラスタの作成

このトピックでは、Tanzu CLI を使用してワークロードクラスタを作成する方法について説明します。

前提条件

「クラスタ展開の前提条件」の前提条件に従っている。
「構成ファイルとオブジェクト仕様」を確認し、インフラストラクチャの構成に関するトピックの説明に従ってワークロードクラスタを構成している。

（推奨）構成ファイルからのクラスタの作成

下記の手順では、クラスタ構成ファイルからワークロードクラスタを展開する方法について説明します。クラスタ構成ファイルから、次のタイプのクラスタを作成できます。

クラスベースのクラスタ：ワークロードクラスタを次の環境に展開する場合は、「クラスベースのクラスタの作成」の手順に従います。
- スタンドアローン管理クラスタを使用する vSphere
- AWS
- Azure
スーパーバイザーを使用する vSphere 8 にクラスベースのワークロードを展開する場合は、「スーパーバイザーで展開されたクラスベースのクラスタの構成」の説明に従って、オブジェクト仕様から展開する必要があります。クラスタ構成ファイルとオブジェクト仕様の詳細については、「構成ファイル」を参照してください。
（レガシー）プランベースのクラスタおよび TKC クラスタ：下記の「（レガシー）プランベースまたは TKC クラスタの作成」の手順に従います。

これらのクラスタタイプの詳細については、「Tanzu Kubernetes Grid について」の「ワークロードクラスタタイプ」を参照してください。

クラスベースのクラスタを作成する

下記の手順では、クラスタ構成ファイルからクラスベースのワークロードクラスタを展開する方法について説明します。展開により作成されたクラスタは、Kubernetes の Cluster オブジェクトで表されます。

重要
VMware では、展開するすべてのクラスタに専用の構成ファイルを使用して保持することを推奨しています。

上記の「前提条件」の一部として準備した構成ファイルを見つけます。
クラスタを作成します。クラスタは、オブジェクトが作成される前に、そのオブジェクト仕様を確認するか編集するかに応じて、1 段階または 2 段階の手順で作成できます。
- （推奨）1 段階でクラスタを作成する場合は、クラスタ構成ファイルを tanzu cluster create の –fileオプションに渡します。これにより、コマンドによって自動的に適用されます。
- 2 段階でクラスタを作成する場合は、クラスタ構成ファイルを tanzu cluster create の –file オプションに渡します。これにより、コマンドによってそのファイルが Cluster オブジェクト仕様に変換され、コマンドはクラスタを作成せずに終了します。仕様を確認または編集したら、tanzu cluster create を再実行してクラスタを作成します。
注
Tanzu Kubernetes Grid v2.1 では、2 段階でクラスタを作成する際に、tanzu cluster create が「Error: workload cluster configuration validation failed...」というエラーで失敗する場合があります。詳細については、『VMware Tanzu Kubernetes Grid v2.1 リリースノート』の「tanzu cluster create の実行中に検証エラーが発生する」を参照してください。
1 段階のプロセス（推奨）
1 段階のプロセスを実行するには、次の手順を実行します。
1. auto-apply-generated-clusterclass-based-configuration を true に設定します（まだ設定されていない場合）。これにより、常に 1 段階のプロセスでクラスベースのクラスタを作成するように Tanzu CLI が構成されます。auto-apply-generated-clusterclass-based-configuration の詳細については、『Tanzu CLI のアーキテクチャと構成』の「機能」を参照してください。
  
  tanzu config set features.cluster.auto-apply-generated-clusterclass-based-configuration true
2. --file オプションにクラスタの構成ファイルへのパスを指定して、tanzu cluster create を実行します。たとえば、構成ファイル my-workload-cluster.yaml をデフォルトの clusterconfigs フォルダに保存した場合は、次のコマンドを実行して、構成ファイルで指定した名前のクラスタを作成します。
  
  tanzu cluster create --file ~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster.yaml
  
  クラスタ構成ファイルに名前を指定しなかった場合、または指定した名前とは異なる名前のクラスタを作成する場合は、tanzu cluster create コマンドでクラスタ名を指定します。たとえば、構成ファイル my-workload-cluster.yaml から another-workload-cluster という名前のクラスタを作成するには、次のコマンドを実行します。
  
  tanzu cluster create another-workload-cluster --file ~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster.yaml
2 段階のプロセス（常時）
作成するすべてのクラスタで 2 段階のプロセスを実行するには、次の手順を実行します。
1. auto-apply-generated-clusterclass-based-configuration 機能を false に設定します（まだ設定されていない場合）。これにより、常に 2 段階のプロセスでクラスベースのクラスタを作成するように Tanzu CLI が構成されます。false がデフォルト設定です。デフォルト設定を変更した後で false に設定を戻すには、次のコマンドを実行します。
  
  tanzu config set features.cluster.auto-apply-generated-clusterclass-based-configuration false
  
  auto-apply-generated-clusterclass-based-configuration の詳細については、『Tanzu CLI のアーキテクチャと構成』の「機能」を参照してください。
2. オブジェクト仕様を生成するには、--file オプションにクラスタ構成ファイルへのパスを指定して、tanzu cluster create を実行します。コマンドは、結果のオブジェクト仕様を ~/.config/tanzu/tkg/clusterconfigs フォルダに保存し、その場所を出力してから終了します。
  
  たとえば、クラスタ構成ファイル my-workload-cluster.yaml をデフォルトの clusterconfigs フォルダに保存した場合は、次のコマンドを実行してオブジェクト仕様を生成します。
  
  tanzu cluster create --file ~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster.yaml
  
  構成ファイルにクラスタの名前を指定しなかった場合、または指定した名前とは異なる名前のクラスタを作成する場合は、tanzu cluster create コマンドでクラスタ名を指定します。例：
  
  tanzu cluster create another-workload-cluster --file ~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster.yaml
3. tanzu cluster create で生成されたオブジェクト仕様ファイルを確認するか、編集します。
4. --file オプションにオブジェクト仕様へのパスを指定して、tanzu cluster create コマンドを再実行します。例：
  
  tanzu cluster create --file ~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster-spec.yaml
  
  管理クラスタとは異なる Kubernetes バージョンを実行するクラスタを作成する場合は、--tkr フラグなど、最初の手順で使用したのと同じフラグをすべて含めます。例：
  
  tanzu cluster create --file ~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster-spec.yaml -v 6 --tkr v1.23.16---vmware.1-tkg.2
2 段階のプロセス（1 回）
単一クラスタに対して 2 段階のプロセスを実行するには、次の手順を実行します。
1. オブジェクト仕様を生成するには、--dry-run オプションを指定して tanzu cluster create を実行します。--dry-run オプションは、auto-apply-generated-clusterclass-based-configuration 設定をオーバーライドします。
  
  tanzu cluster create CLUSTER-NAME --dry-run --file PATH-TO-CLUSTER-CONFIG-FILE.yaml > PATH-TO-OBJECT-SPEC-FILE.yaml
  
  ここで、
  
  CLUSTER-NAME はクラスタの名前です。CLUSTER-NAME は、クラスタ構成ファイルで指定済みであれば省略できます。
  
  PATH-TO-CLUSTER-CONFIG-FILE は、手順 1 で特定したクラスタ構成ファイルへのパスです。
  
  PATH-TO-OBJECT-SPEC-FILE は、結果のオブジェクト仕様ファイルを保存する場所です。
  
  たとえば、結果のオブジェクト仕様を my-workload-cluster-spec.yaml という名前のファイルに保存するには、次を実行します。
  
  tanzu cluster create my-cluster --dry-run --file ~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster.yaml > my-workload-cluster-spec.yaml
2. 前の手順の --dry-run オプションによって生成されたオブジェクト仕様ファイルを確認または編集します。上記の例では、仕様ファイルの名前は my-workload-cluster-spec.yaml です。
3. オブジェクト仕様ファイルを確認または編集したら、--dry-run オプションを指定せずに tanzu cluster create を再実行します。--file オプションで、オブジェクト仕様ファイルへのパスを指定します。例：
  
  tanzu cluster create my-cluster --file my-workload-cluster-spec.yaml
  
  管理クラスタとは異なる Kubernetes バージョンを実行するクラスタを作成する場合は、--tkr フラグなど、最初の手順で使用したのと同じフラグをすべて含めます。例：
  
  tanzu cluster create --file my-workload-cluster-spec.yaml -v 6 --tkr v1.23.16---vmware.1-tkg.2
注
クラスベースのクラスタを作成する場合、Tanzu CLI では、「ytt を使用したレガシークラスタ構成」で説明されている ytt カスタマイズを使用しません。CLI がマシン上でそれらを検出すると、「It seems like you have done some customizations to the template overlays.」というエラーを出力します。
クラスタが作成されたら、tanzu cluster get コマンドを実行して、クラスタに関する情報を表示します。
```
tanzu cluster get CLUSTER-NAME
```
出力には、制御プレーンノードとワーカーノードのステータス、クラスタが実行されている Kubernetes のバージョン、ノードの名前に関する情報が一覧表示されます。

（レガシー）プランベースまたは TKC クラスタの作成

下記の手順では、構成ファイルからプランベースのクラスタまたは TKC クラスタを展開する方法について説明します。

プランベースのクラスタ：結果のクラスタは、ターゲットとするインフラストラクチャプラットフォームに応じて、Kubernetes の AWSCluster、AzureCluster、または VSphereCluster オブジェクトによって表されます。
TKC クラスタ：展開により作成されたクラスタは、Kubernetes の TanzuKubernetesCluster オブジェクトで表されます。

クラスタを作成するには、次の手順を実行します。

Tanzu CLI で allow-legacy-cluster 機能を true に設定します。
```
tanzu config set features.cluster.allow-legacy-cluster true
```
クラスタを作成します。
プランベースのクラスタ
プランベースのクラスタを作成する場合は、次の手順を実行します。
1. 上記の「前提条件」の一部として準備した構成ファイルを見つけます。
2. tanzu cluster create コマンドを実行し、--file オプションで構成ファイルへのパスを指定します。たとえば、ワークロード構成ファイル my-workload-cluster.yaml をデフォルトの clusterconfigs フォルダに保存した場合は、次のコマンドを実行して、構成ファイルで指定した名前のクラスタを作成します。
  
  tanzu cluster create --file ~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster.yaml
  
  構成ファイルに名前を指定しなかった場合、または指定した名前とは異なる名前のクラスタを作成する場合は、tanzu cluster create コマンドでクラスタ名を指定します。たとえば、構成ファイル my-workload-cluster.yaml から another-workload-cluster という名前のクラスタを作成するには、次のコマンドを実行します。
  
  tanzu cluster create another-workload-cluster --file ~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster.yaml
3. クラスタが作成されたら、tanzu cluster get コマンドを実行して、クラスタに関する情報を表示します。
  
  tanzu cluster get CLUSTER-NAME
  
  出力には、制御プレーンノードとワーカーノードのステータス、クラスタが実行されている Kubernetes のバージョン、ノードの名前に関する情報が一覧表示されます。
TKC クラスタ
TKC クラスタを作成する場合は、次の手順を実行します。
1. 「スーパーバイザーで展開された TKC クラスタの構成（レガシー）」の説明に従って、ワークロードクラスタの構成ファイルを作成またはコピーします。
2. Tanzu CLI をスーパーバイザーに接続したら、ターゲットの vSphere 名前空間を取得します。
  
  tanzu namespaces get
3. クラスタのバージョン管理された Tanzu Kubernetes リリース (TKr) を特定します。
  
  スーパーバイザークラスタで使用可能な TKr のリストを取得します。
  
  tanzu kubernetes-release get
  
  コマンド出力から、NAME にリストされている目的の値を記録します（例：v1.22.5---vmware.1-tkg.1）。tkr の NAME 値は VERSION 値と同じですが、NAME 値が + で VERSION 値が --- の場合を除きます。
4. TKR-NAME 値と構成ファイル名を指定し、tanzu cluster create を実行してクラスタを展開します。
  
  tanzu cluster create CLUSTER-NAME --file CONFIGURATION-FILE --tkr=TKR-NAME
  
  ここで、
  
  CLUSTER-NAME は、クラスタに指定する任意の名前です。このコマンドライン値は、構成ファイルの CLUSTER_NAME 設定をオーバーライドします。
  
  CONFIGURATION-FILE は、クラスタ構成ファイルへのローカルパスです（例：~/.config/tanzu/tkg/clusterconfigs/my-workload-cluster.yaml）。
  
  TKR-NAME は、上の手順で取得した TKr の名前です。
5. クラスタが作成されたら、tanzu cluster get を実行して、クラスタの現在のステータスを確認します。
  
  tanzu cluster get CLUSTER-NAME
6. 「ノードの DHCP 予約とエンドポイント DNS レコードの構成（vSphere のみ）」の説明に従って、制御プレーンノードとエンドポイントの IP アドレスを固定に構成します。

オブジェクト仕様からのクラスタの作成

下記の手順では、Kubernetes スタイルのオブジェクト仕様を使用してクラスベースのワークロードクラスタを作成する方法について説明します。

以下の「オブジェクト仕様の作成」の説明に従って、クラスタオブジェクト仕様を作成します。
以下の「オブジェクト仕様からのクラスベースのクラスタの作成」の説明に従って、オブジェクト仕様からクラスタを展開します。

注
Tanzu Kubernetes Grid v2.1 では、オブジェクト仕様からクラスタを作成する際に、tanzu cluster create が「Error: workload cluster configuration validation failed...」というエラーで失敗する場合があります。詳細については、『VMware Tanzu Kubernetes Grid v2.1 リリースノート』の「tanzu cluster create の実行中に検証エラーが発生する」を参照してください。

オブジェクト仕様の作成

クラスベースのワークロードクラスタについて Kubernetes スタイルのオブジェクト仕様ファイルを作成するには、次の手順を実行します。

スタンドアローン管理クラスタ

スタンドアローン管理クラスタを使用する vSphere、AWS、または Azure にワークロードクラスタを展開する場合、Tanzu CLI を使用すると、クラスタを展開せずにクラスタ構成ファイルをクラスベースのワークロードクラスタ用の Kubernetes スタイルのオブジェクト仕様ファイルに変換できます。その後、その仕様を例として使用して、独自の仕様を作成できます。仕様ファイルを作成するには、次を行えます。

auto-apply-generated-clusterclass-based-configuration 機能のデフォルト構成を更新した場合は、false に設定を戻してから、--file フラグ付きで tanzu cluster create を実行します。auto-apply-generated-clusterclass-based-configuration を false に設定するには、次を実行します。
```
tanzu config set features.cluster.auto-apply-generated-clusterclass-based-configuration false
```
この機能が false に設定されている場合に、--file フラグを指定して tanzu cluster create を実行すると、クラスタ構成ファイルがオブジェクト仕様ファイルに変換され、クラスタを作成することなくコマンドが終了します。構成を確認したら、Tanzu CLI によって生成されたオブジェクト仕様ファイルを使用して tanzu cluster create を再実行します。
単一クラスタの仕様ファイルを作成するには、--dry-run オプションを tanzu cluster create に渡して、出力をファイルに保存します。クラスタを作成する場合に使用するのと同じオプションと構成 --file を使用します。例：
```
tanzu cluster create my-cluster --file my-cluster-config.yaml --dry-run > my-cluster-spec.yaml
```
--dry-run オプションは、auto-apply-generated-clusterclass-based-configuration 設定をオーバーライドします。

オブジェクト仕様ファイルの例については、「Cluster オブジェクトとその従属オブジェクトの例」を参照してください。

スーパーバイザー

スーパーバイザーを使用する vSphere 8 にワークロードクラスタを展開する場合は、「スーパーバイザーで展開されたクラスベースのクラスタの構成」の説明に従って、 Cluster オブジェクト仕様を作成または適用します。

vSphere 8 のドキュメントには、作業用のサンプルとして使用できる Cluster オブジェクト仕様があります。例：v1beta1 サンプル：デフォルトのクラスタ。
仕様ファイルの topology ブロックで、仮想マシンのタイプ、スケール、およびその他の基本的なクラスタ構成を設定します。
クラスタインフラストラクチャのコンテナインターフェイスのワンタイム設定など、Cluster オブジェクト自体で設定できない属性をカスタマイズするには、「インフラストラクチャのワンタイム設定の構成」を参照してください。

オブジェクト仕様からのクラスベースのクラスタの作成

オブジェクト仕様からクラスベースのワークロードクラスタを展開するには、オブジェクト仕様を tanzu cluster create の --file オプションに渡します。次に例を示します。

tanzu cluster create my-cluster --file my-cluster-spec.yaml

注
クラスベースのクラスタを作成する場合、Tanzu CLI では、「ytt を使用したレガシークラスタ構成」で説明されている ytt カスタマイズを使用しません。CLI がマシン上でそれらを検出すると、「It seems like you have done some customizations to the template overlays.」というエラーを出力します。

共有サービスクラスタの作成

vSphere with Tanzu スーパーバイザークラスタではなく、tanzu management-cluster create または tanzu mc create で作成された管理クラスタによって管理されるワークロードクラスタの場合、Harbor またはその他のサービスを展開すると、すべてのワークロードが単一のサービスインスタンスを共有できるようになります。

各 Tanzu Kubernetes Grid インスタンスには、1 つの共有サービスクラスタのみを含めることができます。

共有サービスクラスタに Harbor を展開すると、同じ管理クラスタで管理されているすべてのワークロードクラスタで、単一の Harbor インスタンスを共有できます。Harbor を展開する手順については、「サービスレジストリ用の Harbor のインストール」を参照してください。

共有サービスクラスタを作成するには、次の手順を実行します。

クラスタのクラスタ構成 YAML ファイルを作成します。dev プランではなく、prod クラスタプランを使用することをお勧めします。例：
```
INFRASTRUCTURE_PROVIDER: vsphere
CLUSTER_NAME: YOUR-CLUSTER-NAME
CLUSTER_PLAN: prod
```
YOUR-CLUSTER-NAME は、クラスタに対して選択する名前です。たとえば、tkg-services などです。
（vSphere のみ）クラスタの制御プレーン API に対してデフォルトの Kube-Vip ロードバランサを使用する場合は、VSPHERE_CONTROL_PLANE_ENDPOINT を設定してエンドポイントを指定する必要があります。この VIP アドレスが DHCP 範囲内ではなく、DHCP 範囲と同じサブネットにあることを確認します。完全修飾ドメイン名 (FQDN) を仮想 IP アドレスにマッピングした場合は、仮想 IP アドレスの代わりに FQDN を指定できます。
NSX Advanced Load Balancer (ALB) を使用している場合は、制御プレーンエンドポイントを特定のアドレスにする必要がない限り、VSPHERE_CONTROL_PLANE_ENDPOINT を設定しないでください。その場合は、固定 IP アドレスプールに手動で追加した NSX ALB IP アドレス管理プロファイルの仮想 IP アドレスネットワーク範囲内の固定アドレスを使用するか、固定アドレスにマッピングされた FQDN を使用します。

例：
```
VSPHERE_CONTROL_PLANE_ENDPOINT: 10.10.10.10
```
上記の「構成ファイルからのクラスタの作成」の説明に従って、共有サービスクラスタを作成します。
kubectl のコンテキストを管理クラスタのコンテキストに設定します。例：
```
kubectl config use-context mgmt-cluster-admin@mgmt-cluster
```
この例では、mgmt-cluster は管理クラスタの名前です。
tanzu-services ラベルをクラスタロールとして共有サービスクラスタに追加します。このラベルは、管理クラスタおよびワークロードクラスタに対する共有サービスクラスタを識別します。例：
```
kubectl label cluster.cluster.x-k8s.io/tkg-services cluster-role.tkg.tanzu.vmware.com/tanzu-services="" --overwrite=true
```
この例では、tkg-services は共有サービスクラスタの名前です。確認のための cluster.cluster.x-k8s.io/tkg-services labeled が表示されます。

次のコマンドを実行して、ラベルが正しく適用されていることを確認します。

tanzu cluster list --include-management-cluster

共有サービスクラスタに tanzu-services ロールが割り当てられていることが表示されます。例：

NAME              NAMESPACE   STATUS   CONTROLPLANE  WORKERS  KUBERNETES        ROLES           PLAN   TKR
another-cluster   default     running  1/1           1/1      v1.24.10+vmware.1  <none>          dev    v1.24.10---vmware.1-tkg
tkg-services      default     running  3/3           3/3      v1.24.10+vmware.1  tanzu-services  prod   v1.24.10---vmware.1-tkg
mgmt-cluster      tkg-system  running  1/1           1/1      v1.24.10+vmware.1  management      dev    v1.24.10---vmware.1-tkg

共有サービスクラスタの admin 認証情報を取得します。例：
```
tanzu cluster kubeconfig get tkg-services --admin
```
kubectl のコンテキストを共有サービスクラスタに設定します。例：
```
kubectl config use-context tkg-services-admin@tkg-services
```

次の手順

（vSphere のみ）「制御プレーンエンドポイントおよびすべてのノードの DHCP 予約の構成（vSphere のみ）」の説明に従って、クラスタの制御プレーンエンドポイントとそのノードの IP アドレスを固定に構成します。
ワークロードクラスタに接続するには、「ワークロードクラスタへの接続と確認」を参照してください。

ワークロード クラスタの作成