クラスタから構成ファイルを生成する

このドキュメントでは、既存のクラスタから一連の構成ファイルを生成する方法について説明します。

クラスタを作成する 1 つの方法は、gkectl コマンドライン ツールを使用することです。まず、クラスタの一連の構成ファイルを作成します。次に、次のいずれかのコマンドを実行します。

• gkectl create admin: 管理クラスタを作成します
• gkectl create cluster: ユーザー クラスタを作成します

時間の経過とともに、元の構成ファイルがクラスタの実際の状態と同期しなくなる可能性があります。たとえば、カスタム リソースを編集してクラスタを更新する場合、元の構成ファイルがクラスタの正確な表現にならない可能性があります。

クラスタを作成するもう 1 つの方法は、Google Cloud コンソールを使用することです。この場合、クラスタ構成ファイルがありません。後で、クラスタを更新するためにクラスタ構成ファイルが必要になる場合があります。

元の構成ファイルがクラスタと同期されていない可能性がある場合、または構成ファイルがない場合は、gkectl get-config コマンドを使用して、クラスタの現在の状態を正確に表す、新しい構成ファイルのセットを生成できます。

gkectl get-config は以下で使用できます。

• ユーザー クラスタ
• 管理クラスタ

設定ファイルを生成

ユーザー クラスタの新しい構成ファイル群を生成するには:

gkectl get-config cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --cluster-name USER_CLUSTER_NAME

次のように置き換えます。

• ADMIN_CLUSTER_KUBECONFIG: 管理クラスタの kubeconfig ファイルのパス。

• USER_CLUSTER_NAME: ユーザー クラスタの名前。

管理クラスタの新しい構成ファイル群を生成するには:

gkectl get-config admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --bundle-path BUNDLE

次のように置き換えます。

• ADMIN_CLUSTER_KUBECONFIG: 管理クラスタの kubeconfig ファイル。

• BUNDLE: Google Distributed Cloud バンドル ファイルのパス。バンドル ファイルは管理ワークステーション（通常は /var/lib/gke/bundles/gke-onprem-vsphere-VERSION-full.tgz）にあります。バンドル ファイルをまだ持っていない場合は、ここからダウンロードできます。

デフォルトでは、生成された構成ファイルは現在のディレクトリのサブディレクトリに書き込まれます。ユーザー クラスタの場合、出力ディレクトリの名前は user-cluster-config-output になります。管理クラスタの場合、出力ディレクトリの名前は admin-cluster-config-output になります。

生成されたファイルを別のディレクトリに置く場合は、--output-dir パラメータを使用して出力ディレクトリのパスを指定できます。例:

gkectl get-config cluster --kubeconfig my-kubeconfig \
    --cluster-name my-cluster \
    --output-dir /home/me/configuration/generated-files

デフォルトの出力ディレクトリまたは指定した出力ディレクトリにファイルがすでに存在する場合は、--force フラグを使用して、新しく生成されたファイルが既存のファイルと置換されますようにする必要があります。それ以外の場合、コマンドは失敗します。例:

gkectl get-config cluster --kubeconfig my-kubeconfig \
    --cluster-name my-cluster \
    --output-dir /home/me/configuration/generated-files
    --force

管理クラスタ用に生成されたファイル

ユーザー クラスタ用に生成されたファイル