クラスタ・アドオンのインストール

• コンソール
• CLI
• API

• クラスタ作成時のクラスタ・アドオンのデプロイおよび構成

  1. コンソールを使用した、カスタム作成ワークフローでの明示的に定義された設定によるクラスタの作成の手順に従って、クラスタを作成します。
  2. 「クラスタの作成」ページの「クラスタ・アドオンの構成」セクションを表示して、有効化されている使用可能なクラスタ・アドオンを表示します。

     デフォルトでは、新しいクラスタを作成する場合:

     • 重要なクラスタ・アドオン(CoreDNSやkube-proxyなど)は有効として表示され、自動的に更新されます。
     • オプションのクラスタ・アドオン(Kubernetes Dashboardなど)は無効として表示されます。

     「ネットワーク設定」ページでポッド・ネットワーキングのCNIプラグインを選択すると、クラスタの作成時に「クラスタ・アドオンの構成」セクションにCNIプラグインが表示されないことに注意してください。

  3. デプロイおよび構成するアドオンの名前をクリックします。

  4. クラスタの作成時にクラスタ・アドオンをデプロイおよび有効化するには、「<add-on name>の有効化」オプションを選択します。

     クラスタの作成時に重要なアドオンを無効にすることはできません。

  5. 次の詳細を指定して、クラスタ・アドオンを構成します。
     • 自動更新:新しいバージョンが使用可能になったときにOracleでアドオンを自動的に更新する場合は、このオプションを選択します。
     • バージョンの選択: Oracleがクラスタにデプロイするアドオンのバージョンを制御する場合は、このオプションを選択します。警告は、あなたがアドオンの更新に責任を負ったことを示します。このオプションを選択した場合は、「バージョン」リストからクラスタにデプロイするアドオンのバージョンを選択します。「クラスタ・アドオンのサポート・バージョン」を参照してください。
     • オプション:および 値: (オプション)クラスタ・アドオンに引数として渡すキー/値ペアを1つ以上指定します。たとえば、Kubernetes Dashboardの場合、numOfReplicasオプションを選択し、3の値を指定できます。Cluster Add-on Configuration Argumentsを参照してください。

  既存の拡張クラスタのクラスタ・アドオンのデプロイおよび構成

  1. ナビゲーション・メニューを開き、「開発者サービス」をクリックします。「コンテナとアーティファクト」で、「Kubernetesクラスタ(OKE)」をクリックします。
  2. クラスタを含むコンパートメントを選択します。
  3. 「クラスタ」ページで、変更するクラスタの名前をクリックします。
  4. 「リソース」で、「アドオン」をクリックします。
  5. 「アドオンの管理」をクリックし、デプロイおよび構成するクラスタ・アドオンをクリックします。

  6. 「<add-on name>の有効化」オプションを選択して、以前にこのクラスタで有効になっていないクラスタ・アドオンをデプロイおよび有効化するか、以前にデプロイされたが現在無効になっているクラスタを有効にします。

  7. 次の詳細を指定して、クラスタ・アドオンを構成します。
     • 自動更新:新しいバージョンが利用可能になったときに Oracleがアドオンを自動的に更新する場合は、このオプションを選択します。
     • バージョンの選択: Oracleがクラスタにデプロイするアドオンのバージョンを制御する場合は、このオプションを選択します。警告は、あなたがアドオンの更新に責任を負ったことを示します。このオプションを選択した場合は、「バージョン」リストからクラスタにデプロイするアドオンのバージョンを選択します。「クラスタ・アドオンのサポート・バージョン」を参照してください。
     • オプション:および 値: (オプション)クラスタ・アドオンに引数として渡すキー/値ペアを1つ以上指定します。たとえば、Kubernetes Dashboardの場合、numOfReplicasオプションを選択し、3の値を指定できます。Cluster Add-on Configuration Argumentsを参照してください。
  8. 「変更の保存」をクリックします

• クラスタ・アドオンをデプロイするには、oci ce cluster install-addonコマンドと必要なパラメータを使用します:

  oci ce cluster install-addon --cluster-id <cluster-ocid> --addon-name <addon-name> [OPTIONS]

  例:

  oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2

  --configurationsパラメータを使用して、クラスタ・アドオンに引数として渡す1つ以上のキー/値ペアをJSON形式で指定します。JSON内の二重引用符は、1つのバックスラッシュを使用してエスケープする必要があります。例:

  oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations "[{\"key\": \"numOfReplicas\", \"value\": \"3\"}]"

  JSON形式でキーの値自体が必要な場合は、3つのバックスラッシュを使用して、ネストされたJSON内の二重引用符をエスケープする必要があります。例:

  oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations "[{\"key\": \"tolerations\", \"value\": \"[{\\\"key\\\":\\\"special\\\", \\\"value\\\":\\\"true\\\", \\\"effect\\\":\\\"noSchedule\\\",\\\"operator\\\":\\\"exists\\\"}]\"}]"

  --configurationsパラメータを扱いにくくするには、キー/値のペアを一重引用符で囲みます(二重引用符ではなく)。キー/値ペアを一重引用符で囲む場合、JSONの二重引用符を一重バックスラッシュでエスケープする必要はありません。また、キー自体の値にJSONが含まれている場合は、(3つのバックスラッシュではなく)1つのバックスラッシュでネストされたJSONの二重引用符のみをエスケープする必要があります。例:

  oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations '[{"key": "numOfReplicas", "value": "3"}]'

  oci ce cluster install-addon --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --addon-name KubernetesDashboard --addon-version v2.7.0-multiarch-1.25-2 --configurations '[{"key": "tolerations", "value": "[{\"key\":\"special\", \"value\":\"true\", \"effect\":\"noSchedule\",\"operator\":\"exists\"}]"}]'

• InstallAddon操作を実行して、クラスタ・アドオンをインストールします。