クラスタ・アドオンとしてのOCIネイティブ・イングレス・コントローラのインストール

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

{
  "addonName": "NativeIngressController",
  "configurations": [
    {
      "key": "compartmentId",
      "value": "<compartment-ocid>"
    },
    {
      "key": "loadBalancerSubnetId",
      "value": "<load-balancer-subnet-ocid>"
    }    
  ]
}

ここでは:

• <compartment-id>は、OCIネイティブ・イングレス・コントローラがOCIロード・バランサおよび証明書を作成するコンパートメントのOCIDです。
• <load-balancer-subnet-ocid>は、ロード・バランサのサブネットのOCIDです。

例:

{
  "addonName": "NativeIngressController",
  "configurations": [
    {
      "key": "compartmentId",
      "value": "ocid1.compartment.oc1..aaaaaaaa______ddq"
    },
    {
      "key": "loadBalancerSubnetId",
      "value": "ocid1.subnet.oc1.iad.aaaaaaaa______dba"
    }    
  ]
}

• OCIネイティブ・イングレス・コントローラがOCIサービスおよびリソースにアクセスできるようにインスタンス・プリンシパルを設定した場合は、authTypeパラメータをinstanceに設定します。
• OCIネイティブ・イングレス・コントローラがOCIサービスおよびリソースにアクセスできるようにワークロード・アイデンティティ・プリンシパルを設定した場合は、authTypeパラメータをworkloadに設定します。
• OCIネイティブ・イングレス・コントローラがOCIサービスおよびリソースにアクセスできるようにユーザー・プリンシパルを設定した場合は、authTypeパラメータをuserに設定します。

例:

      "key": "authType",
      "value": "workload"

instanceはauthTypeパラメータのデフォルト値であるため、authTypeの値を明示的に指定しない場合、OCIネイティブ・イングレス・コントローラは、OCIサービスおよびリソースにアクセスするために実行されているインスタンスのアイデンティティを使用します。詳細は、OCIサービスおよびリソースへのアクセスを有効にするためのInstance Principal、User PrincipalまたはWorkload Identity Principalの設定を参照してください。

例:

{
  "addonName": "NativeIngressController",
  "configurations": [
    {
      "key": "compartmentId",
      "value": "ocid1.compartment.oc1..aaaaaaaa______ddq"
    },
    {
      "key": "loadBalancerSubnetId",
      "value": "ocid1.subnet.oc1.iad.aaaaaaaa______dba"
    },
    {
      "key": "authType",
      "value": "workload"
    },
    {
      "key": "logVerbosity",
      "value": "2"
    }        
  ]
}

oci ce cluster list-addons --cluster-id <cluster-ocid>

<cluster-ocid>は、OCIネイティブ・イングレス・コントローラ・アドオンをデプロイするクラスタのOCIDです。

次のように入力して、OCIネイティブ・イングレス・コントローラ・アドオンをクラスタにデプロイします:

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

ここでは:

• --cluster-id <cluster-ocid>は、OCIネイティブ・イングレス・コントローラ・アドオンをデプロイするクラスタのOCIDです。
• --from-json file://<path-to-config-file>は、前に作成したOCIネイティブ・イングレス・コントローラ・アドオン構成ファイルの場所を指定します。たとえば、--from-json file://./native-ingress-controller-addon.jsonです。

例:

oci ce cluster install-addon --addon-name NativeIngressController --from-json file://./native-ingress-controller-addon.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr

OCIネイティブ・イングレス・コントローラ・アドオンをデプロイするための作業リクエストが作成されます。

次のように入力して、OCIネイティブ・イングレス・コントローラ・アドオンの正常なデプロイメントを確認します:

oci ce cluster list-addons --cluster-id <cluster-ocid>

デプロイメントが成功すると、ACTIVEのライフサイクル状態を持つOCIネイティブ・イングレス・コントローラ・アドオンが出力に表示されます。例:

{
  "data": [
    {
      "addon-error": null,
      "current-installed-version": "v1.19.0",
      "lifecycle-state": "ACTIVE",
      "name": "NativeIngressController",
      "time-created": "2023-11-06T11:21:11+00:00",
      "version": null
    }
  ]
}