Oracle Cloud Infrastructureドキュメント

Kubernetesメトリック・サーバーのクラスタ・アドオンとしての作業

Container Engine for Kubernetes (OKE)を使用して作成した管理対象ノード・プールがあるクラスタで、Kubernetesメトリック・サーバーをクラスタ・アドオンとして使用する方法を確認します。

Kubernetes Metrics Serverをスタンドアロン・プログラムとしてではなくクラスタ・アドオンとして使用すると、構成と継続的なメンテナンスが簡素化されます。より単純に:

  • Kubernetesメトリック・サーバーを有効または無効にします。
  • Oracleによる自動更新のオプト・インおよびオプト・アウト。
  • Kubernetesメトリック・サーバー・アドオンのバージョンを選択します。
  • 承認されたキー/値ペアの構成引数を使用して、アドオン固有のカスタマイズを管理します。

次の項では、Kubernetesメトリック・サーバー・アドオンの操作方法について説明します:

Kubernetesメトリック・サーバーのクラスタ・アドオンとしてのデプロイ

kubectlを使用して、Container Engine for Kubernetes (OKE)を使用して作成した管理対象ノード・プールのあるクラスタに、Kubernetesメトリック・サーバーをクラスタ・アドオンとしてデプロイする方法をご紹介します。

次の手順では、Kubernetesメトリック・サーバーをクラスタ・アドオンとしてデプロイする方法について説明します:

ステップ1: Kubernetesメトリック・サーバー・アドオン構成ファイルの作成

ノート

次の手順では、CLIを使用してKubernetesメトリック・サーバー・アドオンをデプロイできるようにするKubernetesメトリック・サーバー・アドオン構成ファイルを作成する方法について説明します。構成ファイルには、承認されたキー/値ペアの構成引数が含まれています。CLI (またはAPI)を使用してアドオンをデプロイする場合は、構成ファイルを作成する必要があります。コンソールを使用してKubernetesメトリック・サーバー・アドオンをデプロイすることもできます。その場合は、UIで構成引数を指定します。コンソールを使用したKubernetesメトリック・サーバー・アドオンのデプロイの詳細は、クラスタ・アドオンのインストールを参照してください。

  1. 適切なエディタで、選択した名前でJSONファイルを作成します(これらの手順は、ファイルがenablemetrics-server.jsonという名前であると想定しています)。これには、次のものが含まれます。

    {
  "addonName": "KubernetesMetricsServer",
  "configurations": [
  ]
}

    このコンテンツは、Kubernetesメトリック・サーバー・アドオンを有効にするのに十分です。

  2. (オプション)作成したenablemetrics-server.jsonファイルで、他の構成引数を指定してKubernetesメトリック・サーバー・アドオンをカスタマイズします。設定できる構成引数の詳細は、Kubernetesメトリック・サーバーのアドオン構成引数を参照してください。

  3. enablemetrics-server.jsonファイルを保存して閉じます。

ステップ2: Kubernetes Metrics Serverアドオンをクラスタにデプロイし、デプロイメントが成功したことを確認します

ノート

次の手順では、CLIおよび構成ファイルを使用して、管理対象ノード・プールのあるクラスタにKubernetesメトリック・サーバー・アドオンをデプロイする方法について説明します。コンソールおよびAPIを使用してアドオンをデプロイすることもできます。詳細は、クラスタ・アドオンのインストールを参照してください。

  1. まだ実行していない場合は、ステップに従って、クラスタのkubeconfig構成ファイルを設定し、(必要に応じて)そのファイルを指すようにKUBECONFIG環境変数を設定します。自分のkubeconfigファイルを設定する必要があります。別のユーザーが設定したkubeconfigファイルを使用してクラスタにアクセスすることはできません。クラスタ・アクセスの設定を参照してください。
  2. 次のように入力して、Kubernetesメトリック・サーバー・アドオンがまだクラスタにインストールされていないことを確認します:
    oci ce cluster list-addons --cluster-id <cluster-ocid>

    <cluster-ocid>は、Kubernetesメトリック・サーバー・アドオンをデプロイするクラスタのOCIDです。

  3. Oracle Cloud Infrastructureユーザーがテナンシ管理者またはクラスタ管理者である場合は、次のステップをスキップしてその次のステップに進みます。
  4. Oracle Cloud Infrastructureユーザーがテナンシ管理者またはクラスタ管理者でない場合は、次のように入力してクラスタのKubernetes RBAC cluster-admin clusterroleをユーザーに付与するようテナンシ管理者またはクラスタ管理者に依頼します:
    
kubectl create clusterrolebinding <my-cluster-admin-binding> --clusterrole=cluster-admin --user=<user-OCID>

    アクセス制御およびContainer Engine for Kubernetesについてを参照してください。

  5. 次のように入力して、Kubernetesメトリック・サーバー・アドオンをクラスタにデプロイします:

    oci ce cluster install-addon --addon-name KubernetesMetricsServer --cluster-id <cluster-ocid> --from-json file://./<path-to-config-file>

    ここでは:

    • --cluster-id <cluster-ocid>は、Kubernetesメトリック・サーバー・アドオンをデプロイするクラスタのOCIDです。
    • --from-json file://<path-to-config-file>は、前に作成したKubernetesメトリック・サーバー・アドオン構成ファイルの場所を指定します。たとえば、--from-json file://./enablemetrics-server.jsonです。

    例:

    oci ce cluster install-addon --addon-name KubernetesMetricsServer --from-json file://./enablemetrics-server.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

    Kubernetesメトリック・サーバー・アドオンをデプロイするための作業リクエストが作成されます。

  6. 次のように入力して、Kubernetesメトリック・サーバーが正常にデプロイされ、使用可能であることを確認します:

    kubectl get deployment metrics-server -n kube-system

Kubernetesメトリック・サーバー・アドオンの更新

ノート

次の手順では、CLIおよび構成ファイルを使用してKubernetesメトリック・サーバー・アドオンを更新する方法について説明します。コンソールおよびAPIを使用してアドオンを更新することもできます。詳細は、「クラスタ・アドオンの更新」を参照してください。

  1. 適切なエディタでKubernetesメトリック・サーバー・アドオン構成ファイルを開きます

  2. 必要に応じて、構成ファイルの構成パラメータを追加、削除または変更します。設定できるパラメータの詳細は、Kubernetesメトリック・サーバーのアドオン構成引数を参照してください。

  3. oci ce cluster update-addonコマンドを使用して、次のように入力してKubernetesメトリック・サーバー・アドオンを更新します:
    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://<path-to-config-file> --cluster-id <cluster-ocid>

    ここでは:

    • --cluster-id <cluster-ocid>は、Kubernetesメトリック・サーバー・アドオンを更新するクラスタのOCIDです。
    • --from-json file://<path-to-config-file>は、アドオンの更新時に使用するKubernetesメトリック・サーバー・アドオン構成ファイルの場所を指定します。たとえば、--from-json file://./enablemetrics-server.jsonです。

    例:

    oci ce cluster update-addon --addon-name KubernetesMetricsServer --from-json file://./enablemetrics-server.json.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

    Kubernetesメトリック・サーバーに必要なKubernetesリソースを更新するための作業リクエストが作成されます。

  4. オプション:次のように入力して、Kubernetesメトリック・サーバー・ポッドのステータスを表示し、進捗を確認します:
    kubectl get pods -n kube-system | grep metrics-server

Kubernetesメトリック・サーバー・アドオンの無効化(および削除)

ノート

次の手順では、CLIおよび構成ファイルを使用してKubernetesメトリック・サーバー・アドオンを無効化および削除する方法について説明します。コンソールおよびAPIを使用してアドオンを更新することもできます。詳細は、クラスタ・アドオンの無効化(および削除)を参照してください。

  1. 次のように入力して、oci ce cluster disable-addonコマンドを使用してKubernetesメトリック・サーバー・アドオンを無効化(およびオプションで削除)します:

    oci ce cluster disable-addon --addon-name KubernetesMetricsServer --cluster-id <cluster-ocid> --is-remove-existing-add-on <true|false>

    ここでは:

    • --cluster-id <cluster-ocid>は、Kubernetesメトリック・サーバー・アドオンを無効にする(およびオプションで削除する)クラスタのOCIDです。
    • --is-remove-existing-add-on <true|false>は、Kubernetesメトリック・サーバー・アドオンを完全に削除するか(trueに設定されている場合)、アドオンを削除せずに、単に無効にして使用しないか(falseに設定されている場合)を指定します。アドオンを無効にすると、新しいバージョンが使用可能になったときに Oracleによって自動的に更新されなくなります。

    例:

    oci ce cluster disable-addon --addon-name KubernetesMetricsServer --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr --is-remove-existing-add-on true

    Kubernetesメトリック・サーバーを無効にする(およびオプションで削除する)作業リクエストが作成されます。

  2. オプション:次のように入力して、Kubernetesメトリック・サーバー・ポッドのステータスを表示し、進捗を確認します:
    kubectl get pods -n kube-system | grep metrics-server