ネットワーク・ロード・バランサ

Oracle Private Cloud Appliance上のネットワーク・ロード・バランサ(NLB)は、仮想クラウド・ネットワーク(VCN)からアクセス可能な複数のサーバーに、1つのエントリ・ポイントから自動化されたトラフィック分散を提供します。 LBなどのNLBでは、パブリックIPアドレスまたはプライベートIPアドレスと様々なロード・バランシング・ポリシーを選択できます。

NLBの詳細は、「Oracle Private Cloud Appliance概要ガイド」の「ネットワーク・ロード・バランシングの概要」の章を参照してください。

ネットワーク・ロード・バランサの管理

この項では、ネットワーク・ロード・バランサ(NLB)を作成、更新、詳細の表示および削除する方法について説明します。

ネットワーク・ロード・バランサの作成

このトピックでは、ネットワーク・ロード・バランサ(NLB)を作成する方法について説明します。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開き、「ネットワーキング」を選択して、「ネットワーク・ロード・バランサ」を選択します。

  2. 「ネットワーク・ロード・バランサの作成」ボタンを選択して、「ネットワーク・ロード・バランサの作成」ダイアログを開きます。

  3. 次の情報を入力します。

    • 名前: NLBのわかりやすい名前を入力します。 名前は一意である必要はなく、変更できます。

    • コンパートメントに作成: NLBを作成するコンパートメントを選択します。

    • 表示タイプ: パブリック・ロード・バランサまたはプライベート・ロード・バランサのいずれかを選択します。

      • 「プライベート・ロード・バランサ」を選択した場合、NLBは選択したサブネットからプライベートIPアドレスを受信します。

      • 「パブリック・ロード・バランサ」を選択すると、「パブリックIPの選択」メニューが表示されます。 リストからパブリックIPを選択します。 メニューの上にあるコンパートメントの変更が必要になる場合があります。 メニューに「None Available」と表示されている場合、またはリストからパブリックIPを選択しない場合は、構成されたパブリックIP範囲からパブリックIPが自動的に割り当てられます。

      プライベート・ロード・バランサおよびパブリック・ロード・バランサの詳細は、「ロード・バランシング」を参照してください。

    • サブネット: NLBのVCNおよびサブネットの名前を選択します。 メニューの上にあるコンパートメントの変更が必要になる場合があります。

    • ネットワーク・セキュリティ・グループ: (オプション)デフォルトでは、NLBはどのNSGにもアタッチされません。 「ネットワーク・セキュリティ・グループの有効化」というラベルのボックスを選択して、このNLBを1つ以上のNSGに追加します。

      1. ドロップダウン・リストからNSGを選択します。 必要なNSGを見つけるためにコンパートメントを変更する必要がある場合があります。

      2. 別のNSGにアタッチする場合は、別のNSGの追加ボタンをクリックします。

      3. リストからNSGを削除するには、そのNSGの右側にあるごみ箱をクリックします。 最後のNSGまたはすべてのNSGを削除するには、ネットワーク・セキュリティ・グループの有効化ボックスの選択を解除します。

  4. タグ付け: (オプション) リソース作成時のタグの追加の説明に従って、このNLBに定義済タグまたはフリーフォーム・タグを追加します。 タグは後で適用することもできます。

  5. ダイアログで「ネットワーク・ロード・バランサの作成」ボタンを選択します。 新しいNLBの詳細ページが表示されます。

次のステップ: 「NLB詳細」ページで、「リソース」セクションまでスクロール・ダウンし、作成するリソースを選択して構成を完了します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list)

    • 少なくとも1つのサブネットOCID (oci network subnet list)

  2. create NLBコマンドを入力します。

    構文:

    次に、必須パラメータのみを示します。 oci nlb network-load-balancer create -hを使用して、バックエンド・セットやリスナーなどのオプション・パラメータに関する情報を取得します。 

    oci nlb network-load-balancer create --compartment-id compartment_OCID \
--display-name name-of-network-load-balancer \ 
--subnet-id subnet_OCID

    例:

    次の例では、プライベートNLBを作成し(--is-privateオプション値はデフォルトでtrue)、プライベートIPアドレスは指定されたサブネットから割り当てられます。 プライベート・ロード・バランサおよびパブリック・ロード・バランサの詳細は、「ロード・バランシング」を参照してください。 

    $ oci nlb network-load-balancer create --compartment-id ocid1.compartment.unique_ID \
  --display-name Private_NLB1 --subnet-id ocid1.subnet.unique_ID

{
  "data": {
    "backend-sets": {},
    "compartment-id": "ocid1.tenancy.unique_ID",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "auser",
        "CreatedOn": "2025-01-28T23:12:58.28Z"
      },
    "display-name": "Private_NLB1",
    "freeform-tags": null,
    "hostnames": {},
    "id": "ocid1.networkloadbalancer.unique_ID",
    "ip-addresses": [
    {
      "ip-address": 10.10.1.16,
      "is-public"; false,
      "reserved-ip": null
    }
    ],
    "is-preserve-source-destination": false,
    "is-private": true,
    "lifecycle-details": null,
    "lifecycle-state": "ACTIVE",
    "listeners": {},
    "network-security-group-ids": null,
    "nlb-ip-version": "IPV4",
    "subnet-id":"ocid1.subnet.unique_ID",
    "system-tags": null,
    "time-created": "2025-01-28T23:12:58.000001+00:00",
    "time-updated": null
  },
"etag": "00c648d7-b654-4583-dbdb-k5oed55"
}

    この出力は、oci nlb network-load-balancer getコマンドの出力と同じです。

    次のステップ: oci nlb listener createなどの個別のコマンドを使用してリソースを追加して、NLB構成を完了します。 コマンドの一覧については、oci nlb -hを参照してください。

ネットワーク・ロード・バランサの編集

ネットワーク・ロード・バランサ(NLB)の名前およびタグを変更できます。

「コンピュートWeb UI」の使用

バックエンド・セットやリスナーなどの関連リソースを追加または更新するには、NLBの詳細ページに移動し、「リソース」セクションまでスクロール・ダウンして、追加または編集するリソースを選択します。

  1. ナビゲーション・メニューを開き、「ネットワーキング」を選択して、「ネットワーク・ロード・バランサ」を選択します。

  2. 編集するNLBについて、「アクション」メニューを選択し、「編集」オプションを選択して「ネットワーク・ロード・バランサの編集」ダイアログを開きます。

  3. NLBプロパティを更新するには、変更を行い、「ネットワーク・ロード・バランサの更新」ボタンを選択します。

OCI CLIの使用

NLBの作成時にバックエンド・セットやリスナーなどのリソースを追加しなかった場合は、oci nlb listener createなどの個別のコマンドを使用して追加します。 NLBの作成時にリソースを追加した場合は、oci nlb listener updateなどの個別のコマンドを使用してリソースを更新します。

  1. NLB OCIDの取得(oci nlb network-load-balancer list)

  2. NLBの更新コマンドを実行します。

    例:

    $ oci nlb network-load-balancer update \
 --network-load-balancer-id ocid1.networkloadbalancer.unique_ID \
 --display-name new_nlb_name

ネットワーク・ロード・バランサの詳細の表示

既存のネットワーク・ロード・バランサのリストを表示し、その詳細を表示できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開き、「ネットワーキング」を選択して、「ネットワーク・ロード・バランサ」を選択します。

  2. 必要に応じて、NLBリストの上にあるコンパートメント・メニューから別のコンパートメントを選択します。

  3. 詳細ページに移動するNLBの名前を選択します。

    または、詳細を表示するNLBに対して、「アクション」メニューを選択し、「詳細の表示」オプションを選択します。

OCI CLIの使用

  1. NLB OCIDの取得(oci nlb network-load-balancer list)

  2. get NLBコマンドを実行します。

    構文:

    oci nlb network-load-balancer get --network-load-balancer-id networkloadbalancer_OCID

    バックエンド・セット、証明書、リスナーなど、作成されたすべてのリソースの詳細が出力に含まれます。

ネットワーク・ロード・バランサの削除

ネットワーク・ロード・バランサ(NLB)を削除して、サービスから削除できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開き、「ネットワーキング」を選択して、「ネットワーク・ロード・バランサ」を選択します。

  2. 削除するNLBに対して、「アクション」メニューを選択し、「終了」オプションを選択します。

  3. プロンプトが表示されたら、操作を確認します。

OCI CLIの使用

  1. NLB OCIDの取得(oci nlb network-load-balancer list)

  2. NLBの削除コマンドを実行します。

    構文:

    $ oci nlb network-load-balancer delete --force \
--network-load-balancer-id networkloadbalancer_OCID

ネットワーク・ロード・バランサ・バックエンド・セット

この項では、バックエンド・セットを使用して、ネットワーク・ロード・バランシング・ポリシー、ヘルス・チェック・ポリシー、およびネットワーク・ロード・バランサ・リソースのバックエンド・サーバーのリストで構成される論理エンティティを作成する方法について説明します。

ネットワーク・ロード・バランサ・バックエンド・セットの作成

既存のネットワーク・ロード・バランサに対してバックエンド・セットを作成できます。 バックエンド・セットは、ネットワーク・トラフィックがロード・バランシングされるサーバーのグループです。 バックエンド・サーバーは、バックエンド・セットの作成後、または同時に作成できます。 このトピックでは、バックエンド・セットのみを作成します。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. ネットワーク・ロード・バランサ・バックエンド・セットを作成するネットワーク・ロード・バランサの名前をクリックします。

  3. 「リソース」の下の「バックエンド・セット」をクリックします。
  4. 既存のバックエンド・セットがリストされます。リストには「データがありません」と表示されます。 バックエンド・セットを作成するには、「バックエンド・セットの作成」をクリックします。

  5. 次のように入力します。

    • 名前: バックエンド・セットのわかりやすい名前を指定します。 ネットワーク・ロード・バランサ内で一意である必要があり、変更できません。 有効なバックエンド・セット名には、英数字、ダッシュおよびアンダースコアのみが含まれます。 バックエンド・セット名にスペースを含めることはできません。 機密情報は入力しないでください。

    • ロード・バランシング・ポリシー: IPハッシュ・ポリシーは、受信リクエストのソースIPアドレスをハッシュ・キーとして使用して、スティッキーではないトラフィックを同じバックエンド・サーバーにルーティングします。 ロード・バランサは、そのサーバーが使用可能であるかぎり、同じクライアントから同じバックエンド・サーバーにリクエストをルーティングします。 このポリシーは、初期接続を確立する際のサーバーの重み設定に従います。 次のロード・バランシング・ポリシーのいずれかを選択します:
      • 5タプル・ハッシュ: このポリシーは、受信トラフィックを5タプル(ソースIPとポート、宛先IPとポート、プロトコル)のIPハッシュに基づいて分散します。
      • 3タプル・ハッシュ: このポリシーにより、特定のクライアントからのリクエストが、3タプル(ソースIP、宛先IP、プロトコル)のIPハッシュに基づいて常に同じバックエンド・サーバーに転送されます。
      • 2タプル・ハッシュ: このポリシーは、2タプル(ソース/宛先)のIPハッシュに基づいて、受信トラフィックを同じバックエンド・サーバーにルーティングします。
    • ソース・ヘッダーの保持: デフォルト値は変更できません。

    • IPプロトコル・バージョン: ネットワーク・ロード・バランサ・リスナーとバックエンド・セットでは、同じIPプロトコル・バージョンを使用する必要があります。 受け入れられる値は次のとおりです: IPV4.

    • ヘルス・チェック: パラメータを指定して、セット内のバックエンド・サーバーのヘルスを確認します:
      • プロトコル: プロトコルを入力してください: TCPまたはHTTP。 HTTPはNLBヘルス・チェックに有効です。 TCPをプロトコルとして使用する場合は、オプションでリクエスト・データとレスポンス・データを指定できます。
      • ポート: ヘルス・チェックを実行するバックエンド・サーバー・ポートを指定します。 ヘルス・チェックでバックエンド・サーバーのトラフィック・ポートを使用するように、値'0'を入力できます。
      • MSでの間隔: ヘルス・チェックを実行する頻度をミリ秒単位で指定します。 デフォルト値は10000 (10秒です。
      • タイムアウト(ミリ秒): ヘルス・チェックの応答を待機する最大時間をミリ秒単位で指定します。 ヘルス・チェックは、このタイムアウト期間内に応答が返された場合にのみ成功します。 デフォルトは3000(3秒)です。
      • 再試行回数: バックエンド・サーバーが異常とみなされるまでに試行する再試行回数を指定します。 この数値は、サーバーを正常な状態にリカバリする場合にも適用されます。 デフォルトは3です。
      • ステータス・コード: 正常なバックエンド・サーバーが返す必要のあるステータス・コードを指定します。
      • URLパス(URI): ヘルス・チェックを実行するURLエンドポイントを指定します。

  6. ダイアログの「バックエンド・セットの作成」ボタンをクリックします。 新しいバックエンド・セットの詳細を表示するには、バックエンド・セットを表示します。

OCI CLIの使用

  1. NLB OCIDの取得(oci nlb network-load-balancer list)

  2. バックエンド・セットの作成コマンドを実行します。

    構文:

    oci nlb backend-set create --health-checker health-checker-parameters \
  --name backend-set-name --network-load-balancer-id network-load-balancer_OCID \
   --policy network-load-balancer-policy

    説明:

    • health-checker-parametersは、このバックエンド・セットのヘルス・チェッカに関連付けられたパラメータのセットです。
    • プロトコル: プロトコルを入力してください: TCP. ヘルス・チェック・プロトコルをアプリケーションまたはサービスと一致するように構成してください。 TCPをプロトコルとして使用する場合は、オプションでリクエスト・データとレスポンス・データを指定できます。
    • ポート: ヘルス・チェックを実行するバックエンド・サーバー・ポートを指定します。 ヘルス・チェックでバックエンド・サーバーのトラフィック・ポートを使用するように、値'0'を入力できます。
    • MSでの間隔: ヘルス・チェックを実行する頻度をミリ秒単位で指定します。 デフォルト値は10000 (10秒です。
    • タイムアウト(ミリ秒): ヘルス・チェックの応答を待機する最大時間をミリ秒単位で指定します。 ヘルス・チェックは、このタイムアウト期間内に応答が返された場合にのみ成功します。 デフォルトは3000(3秒)です。
    • 再試行回数: バックエンド・サーバーが異常とみなされるまでに試行する再試行回数を指定します。 この数値は、サーバーを正常な状態にリカバリする場合にも適用されます。 デフォルトは3です。
    • ステータス・コード: 正常なバックエンド・サーバーが返す必要のあるステータス・コードを指定します。
    • URLパス(URI): ヘルス・チェックを実行するURLエンドポイントを指定します。

    • backend-set-nameは、バックエンド・セットに固有の名前です。

    • network-load-balancer_OCIDはNLBのOCIDです。

    • network-load-balancer-policyは、ロード・バランサに関連付けられたポリシーです。

    例:

    oci nlb backend-set create --health-checker '{"interval-in-milliseconds":10000,"port": 22,
"protocol": "TCP", "retries": 3, "timeoutInMillis": 3000}' --name PrivTCP_NLB1BESet 
--network-load-balancer-id ocid1.networkloadbalancer.unique_ID \
--policy "TWO_TUPLE"

{
  "opc-work-request-id": "ocid1.workrequest.unique_ID"
}

    このコマンドは、作業リクエストOCIDを返します。 バックエンド・セットの詳細を表示するには、NLB OCIDとともにoci nlb backend-set listを使用して、指定したNLBに関連付けられているすべてのバックエンド・セットをリストし、NLB OCIDおよびバックエンド・セット名とともにoci lb backend-set getを使用してバックエンド・セットの詳細を表示します。 

    $ oci nlb backend-set list --network-load-balancer-id ocid1.networkloadbalancer.unique_ID
$ oci nlb backend-set get --backend-set-name PrivTCP_NLB1BESet \
--network-load-balancer-id ocid1.networkloadbalancer.unique_ID

ネットワーク・ロード・バランサ・バックエンド・セット詳細の表示

既存のネットワーク・ロード・バランサのバックエンド・セットのリストを表示し、その詳細を表示できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. 既存のバックエンド・セットの詳細をリストするネットワーク・ロード・バランサ(NLB)の名前をクリックします。

  3. 「リソース」の下の「バックエンド・セット」をクリックして、使用可能なバックエンド・セットのリストを表示します。

  4. NLBバックエンド・セットが存在する場合は、バックエンド・セット名をクリックするか、「アクション」(3つの垂直ドット)プルダウン・メニューで詳細を表示できます。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. getコマンドを実行します。

    バックエンド・セット名とNLB OCIDを使用して、指定したコンパートメント内のNLBバックエンド・セットの詳細を表示します。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb backend-set get --backend-set-name backend_set_name \ 
  --network-load-balancer-id network-load-balancer_OCID

    説明:

    • backend-set-nameは、バックエンド・セットに固有の名前です。

    • network-load-balancer_OCIDは、バックエンド・セットに関連付けられたロード・バランサのOCIDです。

    例:

    $ oci nlb backend-set get --backend-set-name PrivTCP_NLB1BESet \ 
  --network-load-balancer-id ocid1.networkloadbalancer..….….uniqueID

{
  "data": {
    "items": [
    {
      "backends": [],
      "health-checker": {
        "interval-in-millis": 10000,
        "port": 22,
        "protocol": "TCP",
        "request-data": "123",
        "response-body-regex": ".*",
        "response-data": "123",
        "retries": 3,
        "return-code": 200,
        "timeout-in-millis": 3000,
        "url-path": "/"
      },
      "ip-version": "IPV4",
      "is-preserve-source": false,
      "name": "PrivTCP_NLB1BESet",
      "policy": "TWO_TUPLE"
      }
    ]
  }
}

ネットワーク・ロード・バランサ・バックエンド・セットの編集

使用されるヘルス・チェッカ・パラメータなど、ネットワーク・ロード・バランサ(NLB)バックエンド・セットのプロパティを変更できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. バックエンド・セット情報を編集するネットワーク・ロード・バランサ(NLB)の名前をクリックします。
  3. 「リソース」で、「バックエンド・セット」をクリックします。

  4. 編集するNLBバックエンド・セットの名前を選択します。

  5. 「アクション」リストで、「編集」をクリックして「ネットワーク・ロード・バランサ・バックエンド・セットの編集」ウィンドウを開きます。

  6. ポップアップ・ウィンドウで許容される変更を行います。

  7. 「ネットワーク・ロード・バランサ・バックエンド・セットの更新」をクリックして、NLBバックエンド・セットのプロパティを更新します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. 作業リクエストIDを返すupdateコマンドを実行します。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb backend-set update --health-checker health-checker-parameters \
  --name backend-set-name --network-load-balancer-id network-load-balancer_OCID \  
   --policy network-load-balancer-policy

    説明:

    • health-checker-parametersは、このバックエンド・セットのヘルス・チェッカに関連付けられたパラメータのセットです。
    • プロトコル: プロトコルを入力してください: TCP. ヘルス・チェック・プロトコルをアプリケーションまたはサービスと一致するように構成してください。 TCPをプロトコルとして使用する場合は、オプションでリクエスト・データとレスポンス・データを指定できます。
    • ポート: ヘルス・チェックを実行するバックエンド・サーバー・ポートを指定します。 ヘルス・チェックでバックエンド・サーバーのトラフィック・ポートを使用するように、値'0'を入力できます。
    • MSの内部: ヘルス・チェックを実行する頻度をミリ秒単位で指定します。 デフォルト値は10000 (10秒です。
    • タイムアウト(ミリ秒): ヘルス・チェックの応答を待機する最大時間をミリ秒単位で指定します。 ヘルス・チェックは、このタイムアウト期間内に応答が返された場合にのみ成功します。 デフォルトは3000(3秒)です。
    • 再試行回数: バックエンド・サーバーが異常とみなされるまでに試行する再試行回数を指定します。 この数値は、サーバーを正常な状態にリカバリする場合にも適用されます。 デフォルトは3です。
    • ステータス・コード: 正常なバックエンド・サーバーが返す必要のあるステータス・コードを指定します。
    • URLパス(URI): ヘルス・チェックを実行するURLエンドポイントを指定します。
    • レスポンス本文の正規表現: バックエンド・サーバーからのレスポンス本文を解析するための正規表現を指定します。

    • backend-set-nameは、バックエンド・セットに固有の名前です。

    • network-load-balancer_OCIDはNLBのOCIDです。

    • network-load-balancer-policyは、ロード・バランサに関連付けられたポリシーです。

    例(ポリシーをTWO_TUPLEに変更):

    $ oci nlb backend-set update --health-checker '{"intervalInMillis":10000,"port": 22, \ 
  "protocol": "TCP", "retries":3, "timeoutInMillis": 3000}' --backend-set-name PrivTCP_BackEndSet_1 \
  --network-load-balancer-id $Priv_NLB1 --policy "TWO_TUPLE"
WARNING: Updates to backends and health-checker and ssl-configuration and session-persistence-
  configuration and lb-cookie-session-persistence-configuration will replace any existing values. 
  Are you sure you want to continue? [y/N]: y

{
  "opc-work-request-id": "ocid1.workrequest.xxx.networkloadbalancer......unique_ID"
}

    ノート:

    このコマンドは、作業リクエストIDを返します。 バックエンド・セットの結果を表示するには、指定されたNLBに関連付けられたバックエンド・セットをリストし、バックエンド・セットのパラメータが変更されたことを確認する必要があります。 バックエンド・セットの詳細を表示するには、「oci nlbバックエンド・セットのリスト」コマンドを使用します。 
    oci nlb backend-set list --network-load-balancer-id ocid1.networkloadbalancer..….….uniqueID  

{
  "data": {
    "items": [
    {
      "backends": [],
      "health-checker": {
        "interval-in-millis": 10000,
        "port": 22,
        "protocol": "TCP",
        "request-data": "123",
        "response-body-regex": ".*",
        "response-data": "123",
        "retries": 3,
        "return-code": 200,
        "timeout-in-millis": 3000,
        "url-path": "/"
      },
      "ip-version": "IPV4",
      "is-preserve-source": false,
      "name": "PrivTCP_BackEndSet_1",
      "policy": "TWO_TUPLE"
      }
    ]
  }
}

ネットワーク・ロード・バランサ・バックエンド・セットの削除

ネットワーク・ロード・バランサ(NLB)バックエンド・セットを削除し、サービスから削除できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. バックエンド・セットを削除するネットワーク・ロード・バランサ(NLB)の名前をクリックします。
  3. 「リソース」で、「バックエンド・セット」をクリックします。

  4. 削除するNLBバックエンド・セットの名前を選択します。

  5. 「処理」列で、3ドットのプルダウン・メニューをクリックし、「削除」を選択します。

  6. プロンプトが表示されたら、操作を確認します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. 作業リクエストIDを返すdeleteコマンドを実行します。

    構文(1行に入力):

    $ oci nlb backend-set delete --backend-set-name HTTP_BckEndSet \ 
  --network-load-balancer-id ocid1.networkloadbalancer....….….….uniqueID 
Are you sure you want to delete this resource? [y/N]: y
{
  "opc-work-request-id": "ocid1.workrequest.xxx.networkloadbalancer-...….….….uniqueID"
}

    ノート:

    検証なしでLBバックエンド・セットを削除するには、--forceオプションを指定してコマンドを実行します。

ネットワーク・ロード・バランサ・バックエンド・サーバー

この項では、ネットワーク・ロード・バランサで使用するバックエンド・サーバーを管理する方法について説明します。

ネットワーク・ロード・バランサ・バックエンドの作成

既存のネットワーク・ロード・バランサのバックエンド・サーバー(コンピュート・インスタンス)を作成する必要があります。 バックエンドは、ネットワーク・トラフィックがロード・バランシングされるバックエンド・セット内のサーバーのグループの1つです。 バックエンドは、バックエンド・セットの作成後、または同時に作成できます。 このトピックでは、バックエンドのみを作成します。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. ネットワーク・ロード・バランサ・バックエンドを作成するネットワーク・ロード・バランサの名前をクリックします。

  3. 「リソース」の下の「バックエンド・セット」をクリックします。
  4. 既存のバックエンドがリストされます。リストには「データがありません」と表示されます。 バックエンド・サーバーを作成するには、BackendSetのハイパーリンクをクリックしてバックエンドを追加します。
  5. 「Create Backend」をクリックします。
  6. バックエンドの追加方法を選択します。 可能な値は次のとおりです。
    • 「計算されたインスタンス」バックエンドはインスタンスによって追加されます。
    • 「IPアドレス」バックエンドはIPアドレスによって追加されます。

  7. 計算されたインスタンスの場合:

    • インスタンス: バックエンドの名前を入力します。

    • ポート: 22 (TCP)と入力します。

    • 名前: デフォルト(ipaddress:port#)を使用する場合は、空白のままにします。
    • 重量: 1から100の範囲の重みを入力します。
    • セキュリティ・ルール: バックエンドのセキュリティ・ルールを選択します。 可能な値は次のとおりです。
      • 「手動構成」バックエンドのセキュリティ・ルールを手動で構成します。
      • 「自動構成」システムは、バックエンドのセキュリティ・ルールを自動的に構成します。

  8. IPアドレスの場合:

    • IPアドレス: バックエンドのIPアドレスを入力します。

    • ポート: ポート番号を入力します。

    • 名前: バックエンドの名前を入力します。
    • 重量: 1から100の範囲の重みを入力します。

  9. ダイアログの「送信」ボタンをクリックします。 新しいバックエンドの詳細を表示するには、バックエンドを表示します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb load-balancer list --compartment-id compartment_OCID)

  2. バックエンド作成コマンドを実行します。

    NLB OCIDおよびバックエンド・セット名を使用して、指定したコンパートメントにLBのバックエンド・セットを作成します。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb backend create --backend-set-name [backend-set-name] --ip-address [text]\ 
  --network-load-balancer-id [network-load-balancer_OCID] \ 
  --port [port-number-integer]

    説明:

    • backend-set-nameは、バックエンドが追加されるバックエンド・セットに固有の名前です。

    • ip-addressは、追加されるバックエンドのIPアドレスです。

    • network-load-balancer_OCIDは、バックエンド・セットおよびサーバーに関連付けられたロード・バランサのOCIDです。

    • port-number-integerは、バックエンドに関連付けられたポート番号です。

    例:

    oci nlb backend create --backend-set-name PrivTCP_NLB1BESet \ 
  --ip-address 10.10.1.13 \
  --network-load-balancer-id ocid1.networkloadbalancer..….….uniqueID \ 
  --port 22

{
  "opc-work-request-id": "ocid1.workrequest.....….….….uniqueID "
}

    ノート:

    このコマンドは、作業リクエストIDを返します。 バックエンド・セットの結果を表示するには、指定されたNLBに関連付けられたバックエンドをリストし、作成されたバックエンドがリストされていることを確認する必要があります。 バックエンドの詳細を表示するには、「oci nlbバックエンド・リスト」コマンドを使用します。 
    oci nlb backend list --network-load-balancer-id ocid1.networkloadbalancer.....….….….uniqueID  

{
  "data": {
    "items": [
    {
      "ip-address": "10.10.1.13",
      "is-backup": false,
      "is-drain": false,
      "is-offline": false,
      "name": "10.10.1.13:22",
      "port": 22,
      "target-id": "ocid",
      "weight": 1
      },
      {
      "ip-address": "10.10.1.14",    
      "is-backup": false,
      "is-drain": false,
      "is-offline": false,
      "name": "10.10.1.14:22",
      "port": 22,
      "target-id": "ocid",
      "weight": 3
      },
    ]
  }
}

ネットワーク・ロード・バランサ・バックエンドの詳細の表示

既存のネットワーク・ロード・バランサ・バックエンド・セット内のバックエンドのリストを表示し、その詳細を表示できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. 既存のバックエンドをリストするネットワーク・ロード・バランサ(NLB)の名前をクリックします。

  3. 「リソース」で、既存のバックエンド・セットの名前をクリックして、IPアドレス、ポート、重みなどの詳細を表示します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. listコマンドを実行します。

    NLB OCIDおよびバックエンド・セット名を使用して、バックエンド・セットのバックエンドの詳細をリストします。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb backend list --backend-set-name backend-set-name \
--load-balancer-id network-load-balancer_OCID

    説明:

    • backend-set-nameは、バックエンドが配置されているバックエンド・セットに固有の名前です。

    • network-load-balancer_OCIDは、バックエンドに関連付けられたロード・バランサのOCIDです。

    例:

    $ oci nlb backend list --backend-set-name PrivLB1_BckEndSet  \
--load-balancer-id ocid1.loadbalancer....….….….uniqueID

{
  "data": {
    "items": [
    {
      "ip-address": "10.10.1.13",
      "is-backup": false,
      "is-drain": false,
      "is-offline": false,
      "name": "10.10.1.13:22",
      "port": 22,
      "target-id": "ocid",
      "weight": 1
    },
    {
      "ip-address": "10.10.1.14",
      "is-backup": false,
      "is-drain": false,
      "is-offline": false,
      "name": "10.10.1.14:22",
      "port": 22,
      "target-id": "ocid",
      "weight": 3
    },
    {
      "ip-address": "10.10.1.2",
      "is-backup": false,
      "is-drain": false,
      "is-offline": false,
      "name": "10.10.1.2:22",
      "port": 22,
      "target-id": "ocid",
      "weight": 1
    },
    {
      "ip-address": "10.10.1.3",
      "is-backup": false,
      "is-drain": false,
      "is-offline": false,
      "name": "10.10.1.3:22",
      "port": 22,
      "target-id": "ocid",
      "weight": 1
    }
    ]
  }
}

ネットワーク・ロード・バランサ・バックエンドの編集

バックエンド・セットのメンバーであるネットワーク・ロード・バランサ(NLB)バックエンドの一部のプロパティを変更できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. バックエンド・プロパティを編集するネットワーク・ロード・バランサの名前をクリックします。
  3. 「リソース」で、「バックエンド・セット」をクリックします。
  4. 編集するバックエンドを含むバックエンド・セットの名前をクリックします。

  5. 編集するNLBバックエンドの名前を選択します。

  6. 「アクション」リストで、「編集」をクリックして「ネットワーク・ロード・バランサ・バックエンドの編集」ウィンドウを開きます。

  7. ポップアップ・ウィンドウで許容される変更を行います。

  8. 「ネットワーク・ロード・バランサ・バックエンドの更新」をクリックして、NLBバックエンドのプロパティを更新します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. 作業リクエストIDを返す更新コマンドを実行します。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb backend update --backend-name backend-name \ 
--backend-set-name backend-set-name \
--network-load-balancer-id networkloadbalancer_OCID [PARAMETERS TO CHANGE]

    ノート:

    is-drain、is-offlineおよびis-backupパラメータは無視されますが、falseに設定する必要があります。

    説明:

    • backend-nameは、編集するバックエンド・セットに関連付けられたバックエンドの名前です。

    • backend-set-nameは、編集するバックエンドに関連付けられているバックエンド・セットの名前です。

    • networkloadbalancer_OCIDは、バックエンド・セットおよびバックエンドに関連付けられたロード・バランサのOCIDです。

    オプション:

    • max-wait-seconds作業リクエストがwait-for-stateで定義された状態に達するまで待機する最大時間。 デフォルトは1200秒です。

    • wait-for-stateこの操作は、リソースを非同期で作成、変更または削除し、作業リクエストを使用して操作の進行状況を追跡します。 受け入れられる値は次のとおりです: ACCEPTED, CANCELED, CANCELING, FAILED, IN_PROGRESS, SUCCEEDED.

    • wait-interval-seconds --wait-interval-secondsごとに、作業リクエストが--wait-for-stateで定義された状態に達したかどうかを確認します。 デフォルトは30秒です。

    • 「重量」バックエンドに割り当てられたネットワーク・ロード・バランシング・ポリシーの重み。 バックエンド・サーバーの重みが大きいほど、受信トラフィックの割合も大きくなります。

    例(バックエンドの重みを3に変更します):

    $ oci nlb backend update --backend-name 10.0.0.3:8080 --backend-set-name example-backend-set \
  --network-load-balancer-id ocid1.networkloadbalancer....….….….uniqueID \
  --weight 3 

{ 
  "opc-work-request-id": "ocid1.workrequest.xxx....….….….uniqueID"
}

    ノート:

    バックエンドの更新結果を確認するには、そのバックエンドのバックエンドgetコマンドを使用します。 
    $ oci nlb backend get --backend-name 172.16.0.151:22 --backend-set-name example_backend_set \
--network-load-balancer-id ocid1.networkloadbalancer....….….….uniqueID 

{
  "data": {
    "ip-address": "172.16.0.151:222",
    "is-backup": false,
    "is-drain": false,
    "is-offline": false,
    "name": "172.16.0.151:222",
    "port": 22,
    "target-id": "ocid",
    "weight": 3
  },
}

ネットワーク・ロード・バランサ・バックエンドの削除

ネットワーク・ロード・バランサ(NLB)バックエンドをバックエンド・セットから削除し、サービスから削除できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. バックエンド・サーバーを削除するネットワーク・ロード・バランサの名前をクリックします。
  3. 「リソース」で、「バックエンド・セット」をクリックします。
  4. バックエンド・セットの詳細を表示するために、削除するバックエンドを含むバックエンド・セットの名前をクリックします。

  5. 削除するバックエンドの名前を選択します。

  6. 「処理」列で、3ドットのプルダウン・メニューをクリックし、「削除」を選択します。

  7. プロンプトが表示されたら、操作を確認します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. nlb backend deleteコマンドを実行します。

    構文(1行に入力):

    $ oci nlb backend delete --backend-name backend-name --backend-set-name backend-set-name \
--network-load-balancer-id network-load-balancer_OCID

    ノート:

    検証なしでNLBバックエンド・サーバーを削除するには、--forceオプションを指定してコマンドを実行します。

    説明:

    • backend-nameは、バックエンド・セットに関連付けられたバックエンドの名前です。

    • backend-set-nameは、削除されるバックエンドに関連付けられているバックエンド・セットの名前です。

    • network-load-balancer_OCIDは、バックエンド・セットおよびバックエンドに関連付けられたネットワーク・ロード・バランサのOCIDです。

    例:

    $ oci nlb backend delete --backend-name 172.16.0.154:80 --backend-set-name PubLB1_BckEndSet \
--network-load-balancer-id ocid1.networkloadbalancer....….….….uniqueID
Are you sure you want to delete this resource? [y/N]: y

ネットワーク・ロード・バランサ・リスナー

この項では、リスナーを使用して、ネットワーク・ロード・バランサのIPアドレスで受信トラフィックをチェックする方法について説明します。

ネットワーク・ロード・バランサ・リスナーの作成

リスナーは、トラフィックがIPアドレスに到達するのを待機し、そのトラフィックをNLBのバックエンド・セット・サーバーに分散します。 トラフィック・タイプごとに少なくとも1つのリスナーを構成します。 VCNのセキュリティ・ルールで、リスナーがトラフィックを受け入れることができることを確認します。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューで、「ネットワーキング」を選択し、「ネットワーク・ロード・バランサ」を選択します。

  2. リストで、リスナーを作成するネットワーク・ロード・バランサの名前を選択します。

  3. ネットワーク・ロード・バランサの詳細ページで、「リソース」セクションまでスクロールし、「リスナー」を選択します。

  4. 「リスナー」リストで、「リスナーの作成」ボタンを選択します。

  5. 次の情報を入力します。

    • 名前: リスナーの説明的な名前を入力します。

    • プロトコル: ドロップダウン・リストから「TCP」を選択します。

    • ポート: 使用するポートを入力します。 TCPでは、デフォルトのポート値22が事前選択されています。 上矢印または下矢印を使用してポート値を変更するか、1から65,535の値を入力します。

    • バックエンド・セット: プルダウン・リストからリスナーのバックエンド・セットを選択します。 値が「None Available」の場合、NLBバックエンド・セットをまだ作成していないため、このパラメータを構成する前に作成する必要があります。

    • IPバージョン: デフォルトのIPバージョン4が事前に選択されています。

  6. ダイアログの「リスナーの作成」ボタンをクリックします。 リスナーの詳細を表示するには、ネットワーク・ロード・バランサの詳細を表示する必要があります。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list)

    • NLB OCID (oci nlb network-load-balancer list)

    • NLBで受け入れられるプロトコル・リスト(oci nlb protocol list)

  2. リスナーの作成コマンドを実行します。

    構文:

    oci nlb listener create --default-backend-set-name backend-set-name \
--network-load-balancer-id network-load-balancer_OCID \  
--name listener-name --port listener-port \
--protocol listener-protocol

    説明:

    • backend-set-nameは、関連付けられたバックエンド・セットの名前です。

    • network-load-balancer_OCIDは、リスナーを追加するロード・バランサのOCIDです。

    • listener-nameは、リスナーのわかりやすい名前です。 一意である必要があり、変更できません。

    • listener-portは、リスナーの通信ポート整数です。

    • listener-protocolは、リスナーが接続リクエストを受け入れるプロトコルです。

    オプション・パラメータの詳細は、oci nlb listener create -hを使用します。

    例:

    $ oci nlb listener create --default-backend-set-name PublicNLB1-Backend-Set \
--network-load-balancer-id ocid1.networkloadbalancer.uniqueID \  
--name LB1-Listener --port 22 --protocol TCP  

{
 "opc-work-request-id": "ocid1.workrequest.oc1.pca.networkloadbalancer.uniqueID"
}

    リスナーの詳細を表示するには、oci nlb load-balancer getを使用します: 

    $ oci nlb listener get --listener-name PrivNLB_TCPListener \
--network-load-balancer-id ocid1.networkloadbalancer.uniqueID
{
  "data": {
    "default-backend-set-name": "PrivNLB_TCPListen",
    "ip-version": "IPV4",
    "name": "PrivNLB_TCPListener",
    "port": 22,
    "protocol": "TCP"
  },
}

ネットワーク・ロード・バランサ・リスナーの編集

一部のネットワーク・ロード・バランサ(NLB)リスナー・プロパティを変更できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. リスナーを表示するネットワーク・ロード・バランサをクリックします。
  3. 「リソース」で、「リスナー」をクリックします。

  4. 編集するNLBリスナーの名前を選択します。

  5. 「アクション」リストで、「編集」をクリックして「ネットワーク・ロード・バランサ・リスナーの編集」ウィンドウを開きます。

  6. ポップアップ・ウィンドウでリスナーに許容される変更を行います。

  7. 「ネットワーク・ロード・バランサ・リスナーの更新」をクリックして、NLBリスナーのプロパティを更新します。

OCI CLIの使用

  1. NLB OCIDの取得(oci nlb network-load-balancer list)

  2. リスナーの更新コマンドを実行します。

    構文:

    oci nlb listener update --default-backend-set-name default-backendset-name \ 
--listener-name listener-name --network-load-balancer-id networkloadbalancer_OCID\
--port port-integer --protocol protocol-text

    説明:

    • default-backendset-nameは、関連付けられたバックエンド・セットの名前です。

    • listener-nameは、更新するリスナーの名前です。 例: example_listener

    • networkloadbalancer_OCIDは、更新するリスナーに関連付けられたロード・バランサのOCIDです

    • port-integerは、リスナーの通信ポートです。 例: 22

    • protocol-textは、リスナーが接続リクエストを受け入れるプロトコルです。 例: TCP

    例(リスナー・ポートを222に変更):

    $ oci nlb listener update --default-backend-set-name PublicLB1-Backend-Set \ 
  --listener-name NLB1_Listener --network-load-balancer-id \ 
  ocid1.networkloadbalancer.unique_ID \
  --port 222 --protocol TCP

{
  "opc-work-request-id": "ocid1.workrequest.unique_ID"
}

    リスナーの詳細を表示するには、oci nlb listener getを使用します: 

    $ oci nlb listener get --listener-name NLB1_Listener \
--network-load-balancer-id  --network-load-balancer-id ocid1.networkloadbalancer.unique_ID
{
  "data": {
    "default-backend-set-name": "PrivNLB_TCPListen",
    "ip-version": "IPV4",
    "name": "PrivNLB_TCPListener",
    "port": 22,
    "protocol": "TCP"
  },
}

ネットワーク・ロード・バランサ・リスナーの削除

ネットワーク・ロード・バランサ(NLB)リスナーを削除し、サービスから削除できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. ネットワーク・ロード・バランサ(NLB)の名前または既存のリスナーをリストする名前をクリックします。
  3. 「リソース」で、「リスナー」をクリックします。

  4. 削除するNLBリスナーの名前を選択します。

  5. 「処理」列で、3ドットのプルダウン・メニューをクリックし、「削除」を選択します。

  6. プロンプトが表示されたら、操作を確認します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. deleteコマンドを実行します。

    構文(1行に入力):

    $ oci nlb listener delete --listener-name listener-name-text \
  --network-load-balancer-id ocid1.networkloadbalancer....….….….uniqueID 
Are you sure you want to delete this resource? [y/N]: y

    ノート:

    検証なしでNLBリスナーを削除するには、--forceオプションを指定してコマンドを実行します。

ネットワーク・ロード・バランサ・ヘルス・チェック

ネットワーク・ロード・バランサ(NLB)バックエンド・セットのヘルス・チェックは、NLBバックエンド・サーバーの可用性を確認するテストです。 ヘルス・チェックは、リクエストまたは接続試行です。 NLBは、構成された時間間隔に基づいてヘルス・チェック・ポリシーを適用し、バックエンド・サーバー・セットをモニターします。 サーバーがヘルス・チェックに失敗すると、NLBは一時的にそのサーバーをバランシング・ローテーションから除外します。 後でサーバーが後続のヘルス・チェックを通過すると、NLBはバックエンド・サーバーをバランシング・ローテーションに戻します。

指定したバックエンド・セット・サーバーのヘルス・ステータスは、プライマリおよびスタンバイのネットワーク・ロード・バランサによってレポートされます。

次のネットワーク・ロード・バランサ(NLB)ヘルス・チェックを実行できます:

NLBに関する一般的な情報については、「Oracle Private Cloud Appliance概要ガイド」を参照してください。

すべてのネットワーク・ロード・バランサのヘルス・チェッカ・ステータスの表示

ネットワーク・ロード・バランサ(NLB)バックエンド・セットのヘルス・ステータス・インジケータを表示して、ネットワーク・ロード・バランサとそのリソースの一般的なヘルスに関するレポートを作成できます。

NLBは、健全性検査ポリシーを使用して、NLBとそのコンポーネントの一般的な健全性を報告する健全性ステータス・インジケータを提供します。 ヘルス・ステータス・インジケータおよびサマリーは、NLB、バックエンド・セットおよびバックエンド・サーバーに表示されます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. ヘルス・チェッカ・ステータスを表示するNLBの名前をクリックします。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

  2. network-load-balancer listコマンドを実行します。このコマンドは、コンパートメント内のすべてのNLBのステータスをリストします。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb network-load-balancer-health list --compartment-id compartment_OCID \
[OPTIONS]

    [OPTIONS]は、次のとおりです:

    • --all結果のすべてのページをフェッチします。 このオプションを指定する場合、--limitオプションは指定できません。
    • --from-json [text] file://path-to/file構文を使用して、このコマンドへの入力をファイルからJSONドキュメントとして指定します。
    • --limit [integer]リストのページ区切り。 ページ区切り「リスト」コールでの1ページ当たりの結果または返されるアイテムの最大数。
    • --page [text]結果の取得を開始するページを表すページ・トークン。
    • --page-size [integer]結果をフェッチする場合、コールごとにフェッチする結果の数。 --allまたは--limitとともに使用した場合にのみ有効で、それ以外の場合は無視されます。
    • --sort-by [text]ソート基準となるフィールド。 指定できるソート順は1つのみです。 timeCreatedのデフォルトの順序は降順です。 displayNameのデフォルトの順序は昇順です。 値を指定しない場合、timeCreatedがデフォルトになります。 受け入れられる値は次のとおりです: displayName, timeCreated.
    • --sort-order [text]使用するソート順。'asc' (昇順)または'desc' (降順)のいずれか。 受け入れられる値は次のとおりです: ASC, DESC.

    例:

    $ oci nlb network-load-balancer-health list --compartment-id ocid1.tenancy....….….….uniqueID

{
  "data": {
    "items": [
    {
      "network-load-balancer-id": "ocid1.networkloadbalancer....….….….uniqueID2",
      "status": "UNKNOWN"
    },
    {
      "network-load-balancer-id": "ocid1.networkloadbalancer....….….….uniqueID1",
      "status": "OK"
    }
    ]
  }
}
    $ oci nlb network-load-balancer-health list --compartment-id ocid1.tenancy....….….….uniqueID \
    --sort-order ASC

{
  "data": {
    "items": [
    {
      "network-load-balancer-id": "ocid1.networkloadbalancer....….….….uniqueID1",
      "status": "OK"
    },
    {
      "network-load-balancer-id": "ocid1.networkloadbalancer....….….….uniqueID2",
      "status": "UNKNOWN"
    }
    ]
  }
}

ネットワーク・ロード・バランサのヘルス・チェッカ・ステータスの表示

既存のネットワーク・ロード・バランサ(NLB)内のバックエンド・サーバーのヘルスのステータス(OK、警告、クリティカル、不明)を表示できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. 既存のロード・バランサ・バックエンド・セットのヘルス・パラメータを表示するNLBの名前をクリックします。

  3. 「リソース」で、「バックエンド・セット」をクリックします。

  4. バックエンド・セットの名前をクリックして、「OK」や「クリティカル」などのヘルス・チェックの詳細を表示します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. network-load-balancer-health getコマンドを実行します。

    NLB OCIDを使用して、指定したコンパートメント内のNLBの詳細をリストします。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    $ oci nlb network-load-balancer-health get --network-load-balancer-id \
  network-load-balancer_OCID

    説明:

    • network-load-balancer_OCIDは、バックエンド・セットに関連付けられたネットワーク・ロード・バランサのOCIDです。

    例:

    $ oci nlb network-load-balancer-health get --network-load-balancer-id \
  ocid1.networkloadbalancer....….….….uniqueID

{
 "data": {
 "critical-state-backend-names": [],
 "status": "OK",
 "total-backend-count": 2,
 "unknown-state-backend-names": [],
 "warning-state-backend-names": []
 }
}

ネットワーク・ロード・バランサ・ヘルス・チェッカ・ポリシーの表示

ネットワーク・ロード・バランサ(NLB)によって使用されるヘルス・チェッカ・ポリシー・パラメータを表示して、バックエンド・セットのヘルスを確認できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. ヒース・チェック・ポリシーを表示するNLBの名前をクリックします。

  3. 「リソース」で、「バックエンド・セット」をクリックします。

  4. バックエンド・セットのヘルス・チェック・パラメータを表示するには、次を実行します:

    1. 「アクション」列(3つのドット)プルダウン・メニューの下の「詳細の表示」をクリックします。
    2. バックエンド・セットをクリックして、その詳細を確認します。

  5. 「バックエンド・セットの詳細」ページで、ヘルス・チェック・ポリシーを表示するバックエンド・セット名の下にある「バックエンド・セット構成」をクリックします。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. ヘルス・チェッカgetコマンドを実行し、health-checkerパラメータを表示します。

    NLB OCIDを使用して、指定したコンパートメントのバックエンド・セット・ヘルス・チェッカ・ポリシーの詳細をリストします。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb health-checker get --backend-set-name backend-set-name-text \
 --network-load-balancer-id network-load-balancer_OCID

    説明:

    • backend-set-nameは、バックエンド・セットに固有の名前です。

    • network-load-balancer_OCIDは、バックエンド・セットに関連付けられたロード・バランサのOCIDです。

    例:

    $ oci nlb health-checker get --backend-set-name BckEndSet \
  --network-load-balancer-id ocid1.networkloadbalancer.. . .unique-id

{
  "data": {
    "health-checker": {
      "interval-in-millis": 10000,
      "port": 22,
      "protocol": "TCP",
      "request-data": null,
      "response-body-regex": ".*",
      "response-data": null,
      "retries": 3,
      "return-code": 200,
      "timeout-in-millis": 3000,
      "url-path": "/"
      },
  },
}

ネットワーク・ロード・バランサのヘルス・チェック・パラメータの編集

ネットワーク・ロード・バランサ(NLB)バックエンド・サーバー・セットのヘルス・チェック・プロパティ(ヘルス・チェック間隔など)を変更できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. 既存のバックエンド・セットのヘルス・チェック・パラメータを編集するNLBの名前をクリックします。

  3. 「リソース」で、「バックエンド・セット」をクリック

  4. バックエンド・セットのヘルス・チェック・パラメータを編集するには:

    1. 「アクション」列(3つのドット)プルダウン・メニューの下の「編集」をクリックします。
    2. バックエンド・セットをクリックして詳細を表示し、「編集」をクリックして許容される変更を行います。

  5. 「保存」をクリックして、変更内容を保存します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. nlb health-checker updateコマンドを実行します。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb health-checker update --backend-set-name name-of-backend-set \
 --interval-in-millis integer-in-millis --max-wait-seconds wait-in-seconds \ 
 --network-load-balancer-id networkloadbalancer_OCID --port port-integer \
 --protocol protocol-text --response-body-regex expression-text \ 
 --retries retries-integer --return-code integer \ 
 --timeout-in-millis integer-in-millis --url-path text \
 --wait-for-state text --wait-interval-secondx integer

    ノート:

    「更新」コマンドは、作業リクエストIDを返します。 コマンド結果を表示するには、NLBバックエンド・セットのgetコマンドを使用します。

    説明:

    • name-of-backend-setは、編集するヘルス・チェック・ポリシーに関連付けられたバックエンド・セットの名前です。 例: example_backend_set.
    • networkloadbalancer_OCIDは、編集するバックエンド・セットのヘルス・ステータスに関連付けられたネットワーク・ロード・バランサのOCIDです。

    オプション:

    --from-json [text]は、file://path-to/file構文を使用して、ファイルからJSONドキュメントとしてこのコマンドへの入力を提供します。

    --if-match [text]オプティミスティック同時実行性制御は、リソースのPUTまたはDELETEコールで、if-matchパラメータを、そのリソースの以前のGETまたはPOSTレスポンスからのetagの値に設定します。

    --interval-in-millis [integer-in-millis]は、ヘルス・チェックの間隔(ミリ秒)です。 例: 10000 (10 seconds).

    --max-wait-seconds [wait-in-seconds]は、作業リクエストが--wait-for-stateで定義された状態に達するまで待機する最大時間です。 デフォルトは1200秒です。

    --port [port-integer]は、ヘルス・チェックを実行するバックエンド・サーバー・ポートです。 例: 22

    --protocol [protocol-text]は、ヘルス・チェックで使用する必要があるプロトコルです。 例: TCP.

    --response-body-regex [expression-text]は、バックエンド・サーバーからレスポンス本文を解析するための正規表現です。 例: ^((?!false).|\s)*$

    --retries [retries-integer]は、バックエンド・サーバーが異常とみなされるまでに試行する再試行回数です。 サーバーを正常なヘルスにリカバリするときにもこの数が適用されます。 例: 3

    --return-code [integer]は、正常なバックエンド・サーバーが戻す必要があるステータス・コードです。 例: 200

    --timeout-in-millis [integer-in-millis]は、ヘルス・チェックへの応答を待機する最大時間(ミリ秒)です。 ヘルス・チェックは、このタイムアウト期間内に応答が返された場合にのみ成功します。 例:3000

    --url-path [text]は、ヘルス・チェックを実行するパスです。 例: /healthcheck

    --wait-for-state [text]は、リソースを非同期で作成、変更または削除し、作業リクエストを使用して操作の進行状況を追跡します。 アクションを実行してから、作業リクエストが特定の状態になるまで待機するには、このオプションを指定します。 受け入れられる値は次のとおりです: ACCEPTED、CANCELED、CANCELING、FAILED、IN_PROGRESS、SUCCEEDED

    --wait-interval-seconds [integer]は、すべての--wait-interval-secondsをチェックして、作業リクエストが--wait-for-stateで定義された状態に達したかどうかを確認します。 デフォルトは30秒です。

    10000ミリ秒(10秒)の内部でヘルス・チェッカを更新する例:

    $ oci nlb health-checker update --backend-set-name PrivTCP_BackEndSet \
  --interval-in-millis 10000 --load-balancer-id ocid1.loadbalancer....….….….uniqueID  

{
"opc-work-request-id": "ocid1.workrequest.....….….….uniqueID"
}

    $ oci nlb backend-set get --backend-set-name PrivTCP_BackEndSet \
  --network-load-balancer-id ocid1.loadbalancer.. . .unique-id

{
  "data": {
    "backends": [
    {
      "ip-address": "10.10.1.2",
      "is-backup": false,
      "is-drain": false,
      "is-offline": false,
      "name": "nlbserver1",
      "port": 22,
      "target-id": "ocid",
      "weight": 1
    },
    {
      "ip-address": "10.10.2.3",
      "is-backup": false,
      "is-drain": false,
      "is-offline": false,
      "name": "nlbserver4",
      "port": 22,
      "target-id": "ocid",
      "weight": 1
    },
    ],
    "health-checker": {
      "interval-in-millis": 10000,
      "port": 22,
      "protocol": "TCP",
      "request-data": null,
      "response-body-regex": ".*",
      "response-data": null,
      "retries": 3,
      "return-code": 200,
      "timeout-in-millis": 3000,
      "url-path": "/"
      },
    "ip-version": "IPV4",
    "is-preserve-source": false,
    "name": "PrivTCP_BackEndSet",
    "policy": "THREE_TUPLE"
  },
}

ネットワーク・ロード・バランサ・バックエンド・セットのヘルスの表示

ネットワーク・ロード・バランサ(NLB)のバックエンド・セットのヘルス・ステータスを表示できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. バックエンド・セットのヘルス・ステータスを表示するNLBの名前をクリックします。

  3. 「リソース」で、「バックエンド・セット」をクリック

  4. バックエンド・セットをクリックして、NLBのバックエンド・セットのヘルス・ステータスを表示します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. backend-set-health getコマンドを実行します。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb backend-set-health get --backend-set-name backend_set_name \
  --network-load-balancer-id network-load-balancer_OCID [OPTIONS]

    説明:

    • backend-set-nameは、バックエンド・セットに固有の名前です。

    • network-load-balancer_OCIDは、バックエンド・セットに関連付けられたネットワーク・ロード・バランサのOCIDです。

    [OPTIONS]は、次のとおりです:

    • --from-json [text] file://path-to/file構文を使用して、このコマンドへの入力をファイルからのJSONドキュメントとして指定します。

    例:

    $ oci nlb backend-set-health get --backend-set-name PubTCP_BackEndSet_1 \
    --network-load-balancer-id ocid1.networkloadbalancer.. . .unique-id

{
  "data": {
    "critical-state-backend-names": [],
    "status": "OK",
    "total-backend-count": 4,
    "unknown-state-backend-names": [],
    "warning-state-backend-names": []
  },
}

ネットワーク・ロード・バランサ・バックエンド・サーバーのヘルスの表示

ネットワーク・ロード・バランサ(NLB)内のバックエンドのバックエンド・サーバー・ヘルス・ステータスを表示できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. バックエンド・セットのヘルス・ステータスを表示するNLBの名前をクリックします。

  3. 「リソース」で、「バックエンド・セット」をクリック

  4. バックエンド・セットをクリックして、NLBのバックエンドのバックエンド・ヘルス・ステータスを表示します。

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

    • NLB OCID (oci nlb network-load-balancer list --compartment-id compartment_OCID)

  2. backend-health getコマンドを実行します。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb backend-health get --backend-name backend_name \
  --backend-set-name backend_set_name \
  --network-load-balancer-id network-load-balancer_OCID [OPTIONS]

    説明:

    • backend-nameは、バックエンド固有の名前(10.10.1.13:22など)です。

    • backend-set-nameは、バックエンド・セットに固有の名前です。

    • network-load-balancer_OCIDは、バックエンド・セットに関連付けられたネットワーク・ロード・バランサのOCIDです。

    [OPTIONS]は、次のとおりです:

    • --from-json [text] file://path-to/file構文を使用して、このコマンドへの入力をファイルからのJSONドキュメントとして指定します。

    例:

    $ oci nlb backend-health get --backend-name 10.10.1.13:22 \ 
    --backend-set-name PubTCP_BackEndSet_1 \
    --network-load-balancer-id ocid1.networkloadbalancer.. . .unique-id

{
  "data": {
    "health-check-results": [
    {
      "health-check-status": "OK",
      "timestamp": "2023-10-04T12:37:54.934773+00:00"
    },
    {
      "health-check-status": "OK",
      "timestamp": "2023-10-04T12:37:54.934777+00:00"
    }
    ],
  "status": "OK"
}

ネットワーク・ロード・バランサの作業リクエスト・エラーの表示

ネットワーク・ロード・バランサ(NLB)操作の作成および構成に使用される構成ステップの多くは、すぐには有効になりません。 このような場合、リクエストは、操作を実行するための作業リクエストと呼ばれる非同期ワークフローを開始します。

作業リクエスト・フルフィルメントの非同期的な性質のため、構成ステップがエラーで失敗したことは必ずしも明らかではありません。 失敗したステップは、最初の成功に依存する次のステップが試みられるまで、しばしば明らかにされない。

NLB作業リクエスト・ステータス・インジケータを表示して、作業リクエストがエラーで失敗したかどうかを確認できます。 これらのメソッドを使用すると、各操作の進行状況、失敗状態になったかどうか、失敗したステップ、および失敗の理由を確認できます。

「コンピュートWeb UI」の使用

  1. ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。

  2. 作業リクエスト・エラーを表示するNLBの名前をクリックします。

  3. 「リソース」リストで、「作業リクエスト」をクリックします。
  4. 作業リクエストのリストから、各作業リクエストについて次を表示できます:
    • 作業リクエストのタイプ
    • 作業リクエストの状態(成功、失敗など)
    • 開始および終了タイムスタンプ
  5. 各作業リクエストの「詳細の表示」ページから、次を表示できます:
    • 作業リクエストに関する一般情報(タイプなど)
    • 作業リクエストのOCID
    • 作業リクエストのエラー詳細に失敗しました(失敗ステータスには何も表示されません)
    • 開始および終了タイムスタンプ

OCI CLIの使用

  1. コマンドを実行するために必要な情報を収集します:

    • コンパートメントOCID (oci iam compartment list --compartment-id-in-subtree true)

  2. nlb work-request listコマンドを実行します。このコマンドは、コンパートメント内のすべてのNLBに対するすべての作業リクエストのOCIDsをリストします。

    ノート:

    オプションのパラメータについては、--helpオプションを指定してコマンドを実行します。

    構文(1行に入力):

    oci nlb work-request-errors list --work-request-id workrequest_OCID \
  --compartment-id tenancy _OCID [OPTIONS]

    [OPTIONS]は、次のとおりです:

    • --all結果のすべてのページをフェッチします。 このオプションを指定する場合、--limitオプションは指定できません。
    • --from-json [text] file://path-to/file構文を使用して、このコマンドへの入力をファイルからJSONドキュメントとして指定します。
    • --limit [integer]リストのページ区切り。 ページ区切り「リスト」コールでの1ページ当たりの結果または返されるアイテムの最大数。
    • --page [text]結果の取得を開始するページを表すページ・トークン。
    • --page-size [integer]結果をフェッチする場合、コールごとにフェッチする結果の数。 --allまたは--limitとともに使用した場合にのみ有効で、それ以外の場合は無視されます。

    例: (無効なサブネットIDでNLBを作成しようとして、作業リクエストが失敗したことを確認し、エラーの詳細を表示します):

    $ oci nlb network-load-balancer create --display-name Priv_NLB1  \
  --compartment-id ocid1.tenancy....….….….uniqueID --subnet-id ocid1.subnet....….….….uniqueID \
  --is-private true

{
  "data": {
    "backend-sets": {},
    "compartment-id": "ocid1.tenancy.1....….….….uniqueID",
    "defined-tags": {},
    "display-name": "Priv_NLB1",
    "freeform-tags": {},
    "id": "ocid1.networkloadbalancer.....….….….uniqueID",
    "ip-addresses": null,
    "is-preserve-source-destination": false,
    "is-private": true,
    "lifecycle-details": null,
    "lifecycle-state": "CREATING",
    "listeners": {},
    "network-security-group-ids": null,
    "nlb-ip-version": "IPV4",
    "subnet-id": "ocid1.subnet.....….….….uniqueID",
    "system-tags": null,
    "time-created": "2023-10-18T12:58:34.000001+00:00",
    "time-updated": null
    },
  "opc-work-request-id": "ocid1.workrequest.....….….….uniqueID"
}
    $ oci nlb work-request get --work-request-id ocid1.workrequest.....….….….uniqueID

{
  "data": {
    "compartment-id": "ocid1.tenancy.....….….….uniqueID",
    "id": "ocid1.workrequest.1.....….….….uniqueID",
    "operation-type": "CREATE_NETWORK_LOAD_BALANCER",
    "percent-complete": 100.0,
    "resources": [
    {
      "action-type": "CREATED",
      "entity-type": "NetworkLoadbalancer",
      "entity-uri": null,
      "identifier": "ocid1.networkloadbalancer.1.....….….….uniqueID"
    }
    ],
    "status": "FAILED",
    "time-accepted": "2023-10-18T12:58:34.701224+00:00",
    "time-finished": "2023-10-18T12:58:34.977166+00:00",
    "time-started": "2023-10-18T12:58:34.715807+00:00"
  }
}

    $ oci nlb work-request-error list --compartment-id ocid1.tenancy....….….….uniqueID \
  --work-request-id ocid1.workrequest....….….….uniqueID

{
  "data": {
    "items": [
    {
      "code": "INTERNAL_ERROR",
      "message": "Error occurred. Network response code: 404.Error Message: 
        'No Subnet was found'",
      "timestamp": "2023-10-18T12:58:34.948927+00:00"
    }
    ]
  }
}