クラスタ認証情報の更新

このページでは、Google Distributed Cloud の管理クラスタまたはユーザー クラスタの vCenter 認証情報と F5 BIG-IP 認証情報を更新する方法について説明します。

vSphere 認証情報を更新する

クラスタに追加する vCenter 認証情報はすでに存在している必要があります。vCenter のロールとユーザー権限について確認してください

管理クラスタと各ユーザー クラスタは、これらのクラスタの作成に使用した vCenter ユーザー名とパスワードを使用するように最初に構成されます。管理クラスタの構成ファイルには、各ユーザー クラスタの構成ファイルと同様に、認証情報ファイルへの参照が含まれます。これらの参照はクラスタごとに異なる場合があります。

クラスタの vCenter 認証情報は、次の手順で更新します。

  1. 管理ワークステーションで、エディタを使用して認証情報構成ファイルを開きます。

    認証情報構成ファイルの username 属性と password 属性を更新します。

  2. gkectl update credentials vsphere コマンドを実行して、変更をクラスタにデプロイします。

    gkectl update credentials vsphere \
      --config CLUSTER_CONFIG \
      --kubeconfig CLUSTER_KUBECONFIG \
      --admin-cluster

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

    • CLUSTER_CONFIG: 更新するクラスタに応じて、管理クラスタの構成ファイルか、ユーザー クラスタの構成ファイルを指定します。クラスタ構成ファイルには、クラスタにデプロイする vCenter 認証情報への参照が含まれます。
    • ADMIN_CLUSTER_KUBECONFIG: 管理クラスタの kubeconfig ファイルを指定します。例: kubeconfig

      管理クラスタの認証情報を更新する場合は、--admin-cluster フラグも含める必要があります。

    • --admin-cluster: 管理クラスタに変更をデプロイする場合は必須のフラグです。ユーザー クラスタに変更をデプロイする際は、このフラグを除外します。

    結果: 変更された vCenter 認証情報はサーバーに対して即座に検証され、「vsphere credentials updated successfully」という確認がターミナルに出力されます。新しい認証情報が vCenter Server へのログインに失敗した場合は、構成ファイルの usernamepassword を編集し、変更を再デプロイします。

    例:

    • ユーザー クラスタの例

      gkectl update credentials vsphere \
      --config USER_CLUSTER_CONFIG --kubeconfig ADMIN_CLUSTER_KUBECONFIG

      成功すると、vSphere 認証情報が正常に更新されたことを示す結果が出力されます。

    • 管理クラスタの例

      gkectl update credentials vsphere \
      --config ADMIN_CLUSTER_CONFIG --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
      --admin-cluster

      結果:

      validating new credentials against vcenter
      restarted "deployment/clusterapi-controllers" in namespace "kube-system"
      vsphere credentials updated successfully.

管理クラスタやユーザー クラスタの F5 BIG-IP 認証情報を更新する

F5 ウェブ インターフェースで F5 BIG-IP 認証情報を更新します。

管理クラスタやユーザー クラスタの F5 BIG-IP 認証情報は、管理ワークステーションで、次の手順を使用して更新します。

  1. F5 認証情報ファイルを編集して認証情報を変更します。

  2. ユーザー クラスタの F5 BIG-IP 認証情報を更新します。

    gkectl update credentials f5bigip --config CLUSTER_CONFIG \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG --admin-cluster
    

管理クラスタまたはユーザー クラスタの非公開レジストリの認証情報を更新する(プレビュー)

クラスタの非公開レジストリの認証情報と証明書を更新できます(サーバー更新はサポートされていません)。更新を行う際は、現在の認証情報と新しい認証情報の両方でプライベート レジストリに接続できる必要があります。

管理ワークステーションで、次の手順を使用して管理クラスタまたはユーザー クラスタの非公開レジストリの認証情報を更新します。

  1. 認証情報の構成ファイルで非公開レジストリの認証情報を更新します。

  2. 新しい非公開レジストリの認証情報を使用するようにクラスタを更新します。

    管理クラスタ:

    gkectl update credentials privateregistry --config CLUSTER_CONFIG \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG --admin-cluster
    

    ユーザー クラスタ:

    gkectl update credentials privateregistry --config CLUSTER_CONFIG \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    

その他の認証情報を更新する

Identity and Access Management サービス アカウントのキーを更新するには、サービス アカウント キーのローテーションをご覧ください。