リスナー

ロード・バランサ・リスナーの作成

既存のロード・バランサ(LB)のリスナーを作成できます。リスナーはトラフィックの到着を待機し、サーバーのバックエンド・サーバー・セット・コレクションに配布されます。リスナーを作成する前に、LBが受け入れるトラフィック・プロトコルをリストする必要があります。

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

ナビゲーション・メニューを開きます。「ネットワーキング」で、「ロード・バランサ」をクリックします。
リスナーを作成するロード・バランサの名前をクリックします。
既存のリスナーは「Load Balancer Information」の下にリストされます。それ以外の場合、リストには「データがありません」と表示されます。リスナーを作成するには、「リスナーの作成」をクリックします。
次の情報を入力します。
- 名前: リスナーの説明的な名前を入力します。
- プロトコル: ドロップダウン・リストから、リスニングするプロトコル(HTTP、TCP)を選択します。
- ポート: リスナーのデフォルトのポート値80が事前選択されています。上矢印または下矢印を使用してポート値を変更するか、1から65,535の値を入力します。
- ホスト名: プルダウン・リストからリスナーのホスト名を選択します。値が「使用不可」の場合は、まだLBホスト名を作成していないため、このパラメータを構成する前に作成する必要があります。
- バックエンド・セット: プルダウン・リストからリスナーのバックエンド・セットを選択します。値が「使用不可」の場合は、まだLBバックエンド・セットを作成していないため、このパラメータを構成する前に作成する必要があります。
- アイドル・タイムアウト(秒): リスナーのデフォルト値60秒が事前選択されています。上矢印または下矢印を使用して、アイドル・タイムアウト値を変更するか、1以上の値を入力します。
ダイアログの「リスナーの作成」ボタンをクリックします。リスナーの詳細を表示するには、ロード・バランサ全体の詳細を表示する必要があります。

OCI CLIの使用

コマンドを実行するために必要な情報を収集します:
- コンパートメントOCID ( oci iam compartment list --compartment-id-in-subtree true)
- LB OCID (oci lb load-balancer list --compartment-id compartment_OCID)
- LBで受け入れられるプロトコル・リスト(oci lb protocol list --compartment-id compartment_OCID)

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

LB OCID、バックエンド・セット名、受け入れられたプロトコルおよびその他の詳細を使用して、指定したコンパートメントにLBバックエンド・サーバー・セットのリスナーを作成します。

ノート:

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

構文(1行に入力):

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

説明:

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

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

• listener_nameは、リスナーのわかりやすい名前です。一意である必要があり、変更できません。例: example_listener.

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

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

例:

$ oci lb listener create --default-backend-set-name PublicLB1-Backend-Set \
--load-balancer-id ocid1.loadbalancer....â¦.â¦.â¦.uniqueID  \  
--name LB1-Listener --port 80 --protocol HTTP  

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

ノート:

リスナーの結果を表示するには、getコマンドを使用してロード・バランサ全体の詳細をリストする必要があります。リスナー・プロパティを単独でリストすることはできません。

$ oci lb load-balancer get --load-balancer-id ocid1.loadbalancer....â¦.â¦.â¦.uniqueID 

{
  "data": {
    "backend-sets": {
      "PubLB1_BckEndSet": {
        "backends": [],
        "health-checker": {
          "interval-in-millis": 10000,
          "port": 80,
          "protocol": "HTTP",
          "response-body-regex": "HEALTH",
          "retries": 3,
          "return-code": 200,
          "timeout-in-millis": 3000,
          "url-path": "/"
          },
        "lb-cookie-session-persistence-configuration": null,
        "name": "PubLB1_BckEndSet",
        "policy": "LEAST_CONNECTIONS",
        "session-persistence-configuration": null,
        "ssl-configuration": null
        }
      },
    "certificates": {},
    "compartment-id": "ocid1.tenancy.â¦ â¦ ...unique_ID",
    "defined-tags": null,
    "display-name": "Pub_LB1",
    "freeform-tags": null,
    "hostnames": {
      "matchhostname1": {
        "hostname": "www.matchhost101.ie.oracle.com",
        "name": "matchhostname1"
        },
      "prehostname2": {
        "hostname": "*host1.ie.oracle.com",
        "name": "prehostname2"
        }
      },
    "id": "ocid1.loadbalancer.oc1.pca..â¦ â¦ ...unique_ID",
    "ip-addresses": null,
    "is-private": false,
    "lifecycle-state": "UNKNOWN_ENUM_VALUE",
    "listeners": {
      "LB1_Listener": {
        "connection-configuration": {
          "backend-tcp-proxy-protocol-version": null,
          "idle-timeout": 60
          },
        "default-backend-set-name": "PublicLB1-Backend-Set",
        "hostname-names": null,
        "name": "LB1_Listener",
        "path-route-set-name": null,
        "port": 80,
        "protocol": "HTTP",
        "routing-policy-name": null,
        "rule-set-names": null,
        "ssl-configuration": null
        }
      },
    "network-security-group-ids": null,
    "path-route-sets": {},
    "routing-policies": null,
    "rule-sets": {},
    "shape-details": null,
    "shape-name": "IGNORE",
    "ssl-cipher-suites": {},
    "subnet-ids": [
      "ocid1.subnet..â¦ â¦ ...unique_ID1"",
      "ocid1.subnet..â¦ â¦ ...unique_ID2""
      ],
    "system-tags": null,
    "time-created": "2022-08-30T18:25:31+00:00"
    },
  "etag": "9326dbb5-d842-4975-9cfb-ced7717e92d6"
}

ロード・バランサ・リスナーの編集

使用されるリスナー通信ポートなど、ロード・バランサ(LB)のリスナー・プロパティを変更できます。

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

ナビゲーション・メニューを開きます。「ネットワーキング」で、「ロード・バランサ」をクリックします。
「リソース」で、「リスナー」をクリックします。
編集するLBリスナーの名前を選択します。
「アクション」リストで、「編集」をクリックして「ロード・バランサ・リスナーの編集」ウィンドウを開きます。
ポップアップ・ウィンドウでリスナーに許容される変更を行います。
「Load Balancer Listenerの更新」をクリックして、LBリスナーのプロパティを更新します。

OCI CLIの使用

コマンドを実行するために必要な情報を収集します:
- コンパートメントOCID ( oci iam compartment list --compartment-id-in-subtree true)
- LB OCID (oci lb load-balancer list --compartment-id compartment_OCID)

updateコマンドを実行します。

ノート:

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

構文(1行に入力):

oci lb listener update --default-backend-set-name [default-backendset-name] \ 
--listener-name [listener-name] --load-balancer-id [loadbalancer_OCID]\
--port [port-integer] --protocol [protocol-text]

説明:

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

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

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

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

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

例:

$ oci lb listener update --default-backend-set-name PublicLB1-Backend-Set \ 
--listener-name LB1_Listener --load-balancer-id ocid1.loadbalancer....â¦.â¦.â¦.uniqueID \
--port 80 --protocol HTTP

ノート:

リスナーの結果を表示するには、getコマンドを使用してロード・バランサ全体の詳細をリストする必要があります。リスナー・プロパティを単独でリストすることはできません。

$ oci lb load-balancer get --load-balancer-id ocid1.loadbalancer....â¦.â¦.â¦.uniqueID 

{
  "data": {
    "backend-sets": {
      "PubLB1_BckEndSet": {
        "backends": [],
        "health-checker": {
          "interval-in-millis": 10000,
          "port": 80,
          "protocol": "HTTP",
          "response-body-regex": "HEALTH",
          "retries": 3,
          "return-code": 200,
          "timeout-in-millis": 3000,
          "url-path": "/"
          },
        "lb-cookie-session-persistence-configuration": null,
        "name": "PubLB1_BckEndSet",
        "policy": "LEAST_CONNECTIONS",
        "session-persistence-configuration": null,
        "ssl-configuration": null
        }
      },
    "certificates": {},
    "compartment-id": "ocid1.tenancy.â¦ â¦ ...unique_ID",
    "defined-tags": null,
    "display-name": "Pub_LB1",
    "freeform-tags": null,
    "hostnames": {
      "matchhostname1": {
        "hostname": "www.matchhost101.ie.oracle.com",
        "name": "matchhostname1"
        },
      "prehostname2": {
        "hostname": "*host1.ie.oracle.com",
        "name": "prehostname2"
        }
      },
    "id": "ocid1.loadbalancer.oc1.pca..â¦ â¦ ...unique_ID",
    "ip-addresses": null,
    "is-private": false,
    "lifecycle-state": "UNKNOWN_ENUM_VALUE",
    "listeners": {
      "LB1_Listener": {
        "connection-configuration": {
          "backend-tcp-proxy-protocol-version": null,
          "idle-timeout": 60
          },
        "default-backend-set-name": "PublicLB1-Backend-Set",
        "hostname-names": null,
        "name": "LB1_Listener",
        "path-route-set-name": null,
        "port": 80,
        "protocol": "HTTP",
        "routing-policy-name": null,
        "rule-set-names": null,
        "ssl-configuration": null
        }
      },
    "network-security-group-ids": null,
    "path-route-sets": {},
    "routing-policies": null,
    "rule-sets": {},
    "shape-details": null,
    "shape-name": "IGNORE",
    "ssl-cipher-suites": {},
    "subnet-ids": [
      "ocid1.subnet..â¦ â¦ ...unique_ID1"",
      "ocid1.subnet..â¦ â¦ ...unique_ID2""
      ],
    "system-tags": null,
    "time-created": "2022-08-30T18:25:31+00:00"
    },
  "etag": "9326dbb5-d842-4975-9cfb-ced7717e92d6"
}

ロード・バランサ・リスナーの削除

ロード・バランサ(LB)リスナーを削除し、サービスから削除できます。

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

ナビゲーション・メニューを開きます。「ネットワーキング」で、「ロード・バランサ」をクリックします。
「リソース」で、「リスナー」をクリックします。
削除するLBリスナーの名前を選択します。
「アクション」列で、3ドットのプルダウン・メニューをクリックし、「終了」を選択します。
プロンプトが表示されたら、操作を確認します。

OCI CLIの使用

コマンドを実行するために必要な情報を収集します:
- コンパートメントOCID ( oci iam compartment list --compartment-id-in-subtree true)
- LB OCID (oci lb load-balancer list --compartment-id compartment_OCID)
deleteコマンドを実行します。

構文(1行に入力):
```
$ oci lb listener delete --listener-name listener-name-text \
 --load-balancer-id ocid1.loadbalancer....â¦.â¦.â¦.uniqueID 
Are you sure you want to delete this resource? [y/N]: y
```
ノート:

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