このページでは、追加のユーザー クラスタを作成する方法について説明します。追加のユーザー クラスタを作成するには、クラスタのデプロイに使用する Anthos clusters on VMware(GKE On-Prem)の構成ファイルのコピーを作成します。コピーしたファイルを新しいユーザー クラスタの想定に合わせて変更し、そのファイルを使用してクラスタを作成します。
作成するユーザー クラスタごとに Anthos clusters on VMware 構成ファイルをコピーして変更する必要があります。
始める前に
- 管理クラスタが実行中であることを確認します。管理クラスタは、Anthos clusters on VMware をインストールしたときに作成しています。
- インストール中に
gkectl
で生成されたconfig.yaml
ファイルを見つけます。このファイルでは、管理クラスタとユーザー クラスタの仕様を定義します。このファイルをコピーして変更し、追加のユーザー クラスタを作成します。 - 管理クラスタの
kubeconfig
ファイルを見つけます。このファイルは、config.yaml
をコピーして変更するときに参照します。
制限事項
制限 | 説明 |
---|---|
クラスタとノードの上限と下限 | 割り当てと上限をご覧ください。環境のパフォーマンスがこれらの上限に影響することがあります。 |
ユーザー クラスタ名の一意性 | 同じ Google Cloud プロジェクトに登録されているすべてのユーザー クラスタに一意の名前を付ける必要があります。 |
複数の vCenter / vSphere データセンターにはデプロイできない | 現時点では、管理クラスタと関連するユーザー クラスタのセットは、1 つの vCenter / vSphere データセンターにのみデプロイできます。同じ管理クラスタとユーザー クラスタを、複数の vCenter / vSphere データセンターにはデプロイできません。 |
作成後にクラスタ構成を宣言型の方法で変更できない | 追加のクラスタの作成と既存のクラスタのサイズ変更はできますが、既存のクラスタを構成ファイルで変更することはできません。 |
十分な IP アドレスが使用可能であることを確認する
新しいユーザー クラスタに十分な IP アドレスが割り振られていることを確認します。十分な IP アドレスがあることを確認する方法は、DHCP サーバーを使用しているか静的 IP かによって異なります。
また、管理クラスタに十分な IP アドレスが割り振られていることを確認します。管理クラスタには、ユーザー クラスタごとに 1 つまたは 3 つのコントロール プレーン ノードがあります。作成するユーザー クラスタには、追加のコントロール プレーンノードが 1 つまたは 3 つ必要です。これらのすべてのコントロール プレーンノードに十分な IP アドレスが必要です。
管理クラスタをアップグレードして IP アドレスを増やすには、アップグレード -- 十分な IP アドレスが使用可能であることを確認するをご覧ください。
DHCP
クラスタが作成されるネットワーク内の DHCP サーバーに十分な IP アドレスがあることを確認します。ユーザー クラスタで実行されるノードよりも多くの IP アドレスが必要です。
静的 IP
ロードバランサに十分な IP アドレスが割り振られていることを確認し、クラスタの作成時にこれらの IP アドレスを指定します。
構成ファイルをコピーする
gkectl create-config
を使用して生成し、環境に合わせて変更した Anthos clusters on VMware 構成ファイルをコピーします。コピーの名前を変更し、別のファイル名を使用します。
cp [CONFIG_FILE] [NEW_USER_CLUSTER_CONFIG]
ここで、[NEW_USER_CLUSTER_CONFIG] は構成ファイルのコピーに選択した名前です。この手順では、このファイルを create-user-cluster.yaml
とします。
create-user-cluster.yaml
で、次のフィールドを変更する必要があります。
admincluster
: 管理クラスタの仕様。ファイルからadmincluster
の仕様を完全に削除します。usercluster
: ユーザー クラスタの仕様。
次のセクションでは、create-user-cluster.yaml
の admincluster
フィールドと usercluster
フィールドを変更し、そのファイルを使用して追加のユーザー クラスタを作成します。
admincluster
の仕様を削除する
既存の管理クラスタから追加のユーザー クラスタを作成する場合は、admincluster
仕様全体を削除する必要があります。
そのためには、仕様とそのすべてのサブフィールドを削除します。
usercluster
の仕様やそのサブフィールドは削除しないでください。
usercluster
の仕様を変更する
次のセクションで説明するように、usercluster
フィールドを変更します。
ユーザー クラスタの名前を変更する
usercluster.clustername
フィールドのユーザー クラスタ名を変更します。新しいユーザー クラスタには、既存のユーザー クラスタと異なる名前を付けます。
ユーザー クラスタのノードに IP アドレスを予約する
DHCP を使用している場合は、ノードの作成に十分な IP があることを確認します。
静的 IP の場合、ユーザー クラスタに事前定義された IP アドレスを含む usercluster.ipblockfilepath
に指定されたファイルを変更します。または、必要な IP を含む別の静的 IP YAML ファイルを指定します。
ロードバランサに IP アドレスを予約する
F5 BIG-IP ロードバランサを使用している場合は、ユーザー クラスタのロードバランサ コントロール プレーンと受信用の 2 つの IP アドレスを予約します。対応するフィールドは usercluster.vips.controlplanevip
と usercluster.vips.ingressvip
です。
マシンの要件を変更する(省略可)
このユーザー クラスタのコントロール プレーン ノードまたはワーカーノードで異なる量の CPU またはメモリを使用する場合や、クラスタで追加または少数のノードを実行する場合は、次のフィールドに値を設定します。
usercluster.masternode
usercluster.masternode.cpus
: 使用する CPU コアの数。usercluster.masternode.memorymb
: 使用するメモリ容量(MB)usercluster.masternode.replicas
: 実行するこのタイプのノードの数。値は1
または3
にする必要があります。
usercluster.workernode
usercluster.workernode.cpus
: 使用する CPU コアの数。usercluster.workernode.memorymd
: 使用するメモリ容量(MB)usercluster.workernode.replicas
: 実行するこのタイプのノードの数。
vcenter
の仕様の更新
新しいクラスタの特定の vSphere 環境を変更する場合は、vcenter
の次のフィールドを変更します。
credentials.username
credentials.password
datastore
network
resourcepool
次のフィールドは変更しないでください。
credentials.address
datacenter
cluster
ユーザー クラスタを作成する
これまでの手順で create-user-cluster.yaml
ファイルが作成されました。次に、このファイルを使用して、もう 1 つユーザー クラスタを作成します。
次のコマンドを実行します。
gkectl create cluster --config create-user-cluster.yaml --kubeconfig [ADMIN_CLUSTER_KUBECONFIG]
ここで
- create-user-cluster.yaml は、作成した構成ファイルです。このファイルに別の名前を付けている可能性があります。
- [ADMIN_CLUSTER_KUBECONFIG] は、既存の管理クラスタの
kubeconfig
を指します。
トラブルシューティング
クラスタの作成とアップグレードに対するトラブルシューティングをご覧ください。