クラスタ・アドオンとしての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パラメータをworkloadIdentityに設定します。
• OCIネイティブ・イングレス・コントローラがOCIサービスおよびリソースにアクセスできるようにユーザー・プリンシパルを設定した場合は、authTypeパラメータをuserに設定します。

例:

      "key": "authType",
      "value": "workloadIdentity"

instanceはauthTypeパラメータのデフォルト値であるため、authTypeの値を明示的に指定しない場合、OCIネイティブ・イングレス・コントローラは、OCIサービスおよびリソースにアクセスするために実行されているインスタンスのIDを使用します。詳細は、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": "workloadIdentity"
    },
    {
      "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
    }
  ]
}