プロキシポート範囲のカスタマイズ

デフォルトでは、Consul はプロキシが使用するポートを、10001 ~ 10800 のまばらに使用されているブロックから選択します。

これらのポートは変更できますが、次の点に注意してください。

  • apigee-mtls をアンインストールし、新しい値で再インストールする必要があります。
  • Consul プロキシは Apigee サービスと同じポートでリッスンできません。
  • Consul のポートアドレス空間は 1 つだけです。つまり、ホスト A のプロキシ A がポート 15000 でリッスンする場合、ホスト B のプロキシ B はポート 15000 でリッスンできません。
  • Apigee ポートの要件を確認して、競合が発生しないようにしてください。

特定の構成に合わせて、プロキシで使用されるポートをカスタマイズできます。

ポートの使用状況に関するレポートの生成

プロキシポート範囲をカスタマイズする場合、現在のポート割り当てに関するレポートを生成すると役立つ場合があります。これを行うには、次のコマンドを入力します。

apigee-service apigee-mtls report -f silent.conf > port_report.json

これにより、各ホストの現在のポート使用状況に関する情報を含む port_report.json という名前の JSON ファイルが生成されます。ファイル名は自由に指定できます。

レポートの構造

以下は、生成されるレポートの構造を示すサンプルです。

{
    "192.168.1.1": {
          "datacenter_member": "dc-1",
     "daemons": {
         "zookeeper-ingress": {
            "ingress": true,
            "name": "zk-2888-192-168-1-1",
            "listeners": [
                {
                   "purpose": "terminate service mesh for zk port 2888",
                   "ip_address": "192.168.1.1",
                   "port": 10001,
                }
            ]
         },
         "consul-server": {
             .
             .
             .
         }
     }
    },
    "192.168.1.2": { }
     .
     .
     .
}

上記の例では、ホスト "zk-2888-192-168-1-1" にポート 10001 が割り当てられています。

API mTLS で使用されるポートのカスタマイズ

Apigee mTLS で使用されるポートをカスタマイズするには:

  1. apigee-mtls がすでにインストールされている場合は、以下に示すようにアンインストールします。
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall

    詳細については、Apigee mTLS をアンインストールするをご覧ください。

  2. 各ノードでサイレント構成ファイルを開きます。このファイルの一般的な情報については、構成ファイルの作成をご覧ください。

    必要に応じて、apigee-mtls の設定が完了する前に ポート使用状況に関するレポートの生成に示すコマンドを実行して、サイレント構成ファイルが生成するものを確認できます。

  3. ポートを設定するプロパティの値を追加または変更します。

    次の表に、Apigee mTLS でコンポーネントで使用されるポートのカスタマイズに使用するポートとプロパティ名を示します。

    ノード デフォルトの範囲 説明
    Apigee mTLS 10,700 ~ 10,799 apigee-mtls がインストールされている各ホストには、指定した範囲内のポートが 1 つ必要です。

    ポートを定義するには、次のプロパティを使用して最小ポート番号と最大ポート番号を同じ値に設定します。

    SMI_PROXY_MINIMUM_EGRESS_PROXY_PORT
    SMI_PROXY_MAXIMUM_EGRESS_PROXY_PORT
    Cassandra 10100 ~ 10199 apigee-cassandra がインストールされている各ホストには、指定された範囲内のポートが 2 つ必要です。

    カスタム範囲を定義するには、次のプロパティを使用して最小ポート番号と最大ポート番号を設定します。

    SMI_PROXY_MINIMUM_CASSANDRA_PROXY_PORT
    SMI_PROXY_MAXIMUM_CASSANDRA_PROXY_PORT

    Message Processor 10500 ~ 10599 apigee-message-processor がインストールされている各ホストには、指定された範囲内のポートが 2 つ必要です。

    カスタム範囲を定義するには、次のプロパティを使用して最小ポート番号と最大ポート番号を設定します。

    SMI_PROXY_MINIMUM_MESSAGEPROCESSOR_PROXY_PORT
    SMI_PROXY_MAXIMUM_MESSAGEPROCESSOR_PROXY_PORT

    OpenLDAP 10,200 ~ 10,299 apigee-ldap がインストールされている各ホストには、指定された範囲内のポートが 1 つ必要です。

    ポートを定義するには、次のプロパティを使用して最小ポート番号と最大ポート番号を同じ値に設定します。

    SMI_PROXY_MINIMUM_LDAP_PROXY_PORT
    SMI_PROXY_MAXIMUM_LDAP_PROXY_PORT

    Postgres 10300 ~ 10399 apigee-postgres がインストールされている各ホストには、指定された範囲内のポートが 3 つ必要です。

    カスタム範囲を定義するには、次のプロパティを使用して最小ポート番号と最大ポート番号を設定します。

    SMI_PROXY_MINIMUM_POSTGRES_PROXY_PORT
    SMI_PROXY_MAXIMUM_POSTGRES_PROXY_PORT
    QPID 10,400 ~ 10,499 apigee-qpid がインストールされている各ホストには、指定された範囲内のポートが 2 つ必要です。

    カスタム範囲を定義するには、次のプロパティを使用して最小ポート番号と最大ポート番号を設定します。

    SMI_PROXY_MINIMUM_QPID_PROXY_PORT
    SMI_PROXY_MAXIMUM_QPID_PROXY_PORT
    ルーター 10,600 ~ 10,699 apigee-router がインストールされている各ホストには、指定された範囲内のポートが 2 つ必要です。

    カスタム範囲を定義するには、次のプロパティを使用して最小ポート番号と最大ポート番号を設定します。

    RT_PROXY_PORT_MIN
    RT_PROXY_PORT_MAX

    ZooKeeper 10001 ~ 10099 apigee-zookeeper がインストールされている各ホストには、指定された範囲内のポートが 3 つ必要です。

    カスタム範囲を定義するには、次のプロパティを使用して最小ポート番号と最大ポート番号を設定します。

    SMI_PROXY_MINIMUM_ZOOKEEPER_PROXY_PORT
    SMI_PROXY_MAXIMUM_ZOOKEEPER_PROXY_PORT

    次の例では、Cassandra ポートのカスタム値を定義します。

        SMI_PROXY_MINIMUM_CASSANDRA_PROXY_PORT=10142
        SMI_PROXY_MAXIMUM_CASSANDRA_PROXY_PORT=10143
  4. 構成ファイルを保存します。
  5. Apigee mTLS をインストールするの説明に従って apigee-mtls をインストールします。
  6. 次のコマンドを使用して apigee-mtls コンポーネントを構成します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f config_file
  7. クラスタ内のノードごとにこの手順を繰り返して、すべての構成ファイルがすべてのノードで同じになるようにします。