デフォルトでは、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 で使用されるポートをカスタマイズするには:
apigee-mtls
がすでにインストールされている場合は、以下に示すようにアンインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
詳細については、Apigee mTLS をアンインストールするをご覧ください。
各ノードでサイレント構成ファイルを開きます。このファイルの一般的な情報については、構成ファイルの作成をご覧ください。
必要に応じて、apigee-mtls の設定が完了する前に ポート使用状況に関するレポートの生成に示すコマンドを実行して、サイレント構成ファイルが生成するものを確認できます。
ポートを設定するプロパティの値を追加または変更します。
次の表に、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
- 構成ファイルを保存します。
- Apigee mTLS をインストールするの説明に従って
apigee-mtls
をインストールします。 - 次のコマンドを使用して
apigee-mtls
コンポーネントを構成します。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f config_file
- クラスタ内のノードごとにこの手順を繰り返して、すべての構成ファイルがすべてのノードで同じになるようにします。