Anypoint Datagraph の専用ロードバランサの URL の設定

CloudHub 共有ロードバランサのポート 8082 を使用できない場合は、専用ロードバランサ (DLB) を使用するための URL を Anypoint DataGraph に設定する必要があります。

URL を設定するには、Anypoint DataGraph 設定に DLB のマッピングルールを追加します。

DLB URL のマッピングルールの例

DLB のマッピングルールをどのように機能させるかに基づいて、​入力パス​ (入力 URI) と​出力パス​ (アプリケーション URI) を設定し、最終的な DLB URL が Anypoint DataGraph アプリケーションのエンドポイント (​/graphql​) にアクセスできるようにする必要があります。

たとえば、​入力パス​の値と Datagraph アプリケーション名 (​datagraph-xz082edx-1585-901xe374-d0x0​) に基づく ​examplelb.lb.anypointdns.net​ のマッピングルールについて検討します。

インデックス 入力 URI (入力パス) アプリケーション名 アプリケーション URI (出力パス) プロトコル

0

/graphql

datagraph-xz082edx-1585-901xe374-d0x0

/graphql

HTTPS

1

/datagraph/

datagraph-xz082edx-1585-901xe374-d0x0

/graphql

HTTPS

2

/datagraph/

datagraph-xz082edx-1585-901xe374-d0x0

/

HTTPS

3

/{app}/

{app}

/

HTTPS

各インデックスの適切な DLB URL は次のとおりです。

  • インデックス 0: examplelb.lb.anypointdns.net/graphql

  • インデックス 1: examplelb.lb.anypointdns.net/datagraph/

  • インデックス 2: examplelb.lb.anypointdns.net/datagraph/graphql

  • インデックス 3: examplelb.lb.anypointdns.net/datagraph-xz082edx-1585-901xe374-d0x0/graphql

前提条件

このタスクを実行する手順は、次のとおりです。

  1. Anypoint CLI を使用して、DLB と Anypoint DataGraph に関する詳細を収集します。

  2. Anypoint Runtime Manager を使用して DLB のマッピングルールを作成します。

  3. Anypoint CLI を使用して DLB 設定を Anypoint DataGraph に追加します。

DLB と Anypoint DataGraph に関する詳細を収集する

DLB の名前と Anypoint DataGraph のアプリケーション名を収集します。

  1. Anypoint Platform のユーザ名とパスワードを使用して、Anypoint CLI に接続します。

  2. 環境をまだ設定していない場合は、次のコマンドを使用して設定します。

    • Anypoint CLI v3.x の使用:

      use environment <environment name>

    • Anypoint CLI v4.x の使用:

      conf environment <environment name>

  3. DLB の名前を取得します。

    • Anypoint CLI v3.x の使用:

      cloudhub load-balancer describe <dlb name>

    • Anypoint CLI v4.x の使用:

      cloudhub:load-balancer:describe <dlb name>

      出力は次のようになります。

      Name | examplelb

  4. Anypoint DataGraph アプリケーション名の CloudHub ドメインを取得します。

    • Anypoint CLI v3.x の使用:

      datagraph load-balancer-config describe

    • Anypoint CLI v4.x の使用:

      datagraph:load-balancer-config:describe

      値は次のようになります。

      Domain | datagraph-xz082edx-1585-901xe374-d0x0

      DataGraph アプリケーション名には、各自の組織 ID と環境 ID の要素が含まれます。

  5. 手順 3 ~ 4 の値を書き留めます。

DLB のマッピングルールを作成する

Runtime Manager でマッピングルールをセットアップします。

  1. Anypoint Platform の ​[Runtime Manager]​ を選択します。

  2. ナビゲーションメニューから、​[Load Balancers (ロードバランサ)]​ を選択します。

  3. ロードバランサ名をクリックして、証明書名をクリックします。

    ロードバランサに有効な CA 署名証明書があることを確認します。ない場合は、ブラウザが Anypoint DataGraph に接続されません。

  4. [URL Mapping Rules (URL マッピングルール)]​ セクションで ​[Add New Rule (新規ルールを追加)]​ をクリックします。

  5. 項目に次の値を入力します。

    • Input Path (入力パス)​ (​inputUri​): クライアントが要求する URI (例: /{app}/​)

    • Target App (対象アプリケーション)​ (​appName​): ステップ 4 の詳細の収集タスクで確認した Anypoint DataGraph アプリケーションのドメインです。

    • Output Path (出力パス)​ (​appURI​): Anypoint DataGraph に渡す URI 文字列 (例: /​、​/graphql​)

    • Protocol (プロトコル)​ (​upstreamProtocol​): https

      Anypoint DataGraph では HTTPS のみをサポートしています。

DLB 設定を Anypoint DataGraph に追加する

マッピングルールを追加したら、Anypoint Datagraph で使用する DLB を設定します。

  1. Anypoint DataGraph の DLB URL を確認します。

    • Anypoint CLI v3.x の使用:

      datagraph load-balancer-config describe
    • Anypoint CLI v4.x の使用:

      datagraph:load-balancer-config:describe

      デフォルトで、この Anypoint DataGraph 環境に DLB を設定したことがない場合は、​dlbUrl​ の値が返されません。

  2. 新しい DLB URL を追加します。

    • Anypoint CLI v3.x の使用:

      datagraph load-balancer-config add <url>
    • Anypoint CLI v4.x の使用:

      datagraph:load-balancer-config:add <url>

      <url>​ を、DLB 名と DataGraph アプリケーション名 (手順 3 ~ 4 の詳細の収集タスクで確認) とマッピングルールの​入力パス​を含む有効な URL に置換します。次に例を示します。

    • Anypoint CLI v3.x の使用:

      datagraph load-balancer-config add examplelb.lb.anypointdns.net/datagraph/graphql
    • Anypoint CLI v4.x の使用:

      datagraph:load-balancer-config:add examplelb.lb.anypointdns.net/datagraph/graphql

      必要に応じて、​「DLB URL のマッピングルールの例」​を参照してください。

  3. 更新された値を検証します。

    • Anypoint CLI v3.x の使用:

      datagraph load-balancer-config describe
    • Anypoint CLI v4.x の使用:

      datagraph:load-balancer-config:describe

      CLI で、Anypoint DataGraph ロードバランサのアプリケーション名と DLB の完全ドメイン名を含む詳細が返されます。

この変更を追加すると、Anypoint DataGraph が再デプロイされるため、Anypoint DataGraph が最新の状態であることが状況インジケータに示されるまで待機します。

Anypoint DataGraph から DLB 設定を削除する

次のコマンドを使用して、Anypoint DataGraph から DLB 設定を削除できます。

  • Anypoint CLI v3.x の使用:

    datagraph load-balancer-config remove
  • Anypoint CLI v4.x の使用:

    datagraph:load-balancer-config:remove

    設定を削除すると、Anypoint DataGraph が再デプロイされます。