デフォルトでは、Consul プロキシが使用するポートは、10001 ~ 10800 のまばらに使用されている範囲から選択されます。
これらのポートは変更できますが、次の点に注意してください。
apigee-mtls
をアンインストールし、新しい値で再インストールする必要があります。- Consul プロキシは、Apigee サービスと同じポートでリッスンできません。
- ポートアドレス空間は 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 10,100 ~ 10,199 apigee-cassandra
がインストールされている各ホストには、指定された範囲内のポートが 2 つ必要です。カスタム範囲を定義するには、次のプロパティを使用して、ポート番号の最小値と最大値を設定します。
SMI_PROXY_MINIMUM_CASSANDRA_PROXY_PORT SMI_PROXY_MAXIMUM_CASSANDRA_PROXY_PORT
Message Processor 10,500 ~ 10,599 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 10,300 ~ 10,399 apigee-postgres
がインストールされている各ホストには、指定された範囲内のポートが 3 つ必要です。カスタム範囲を定義するには、次のプロパティで最小値と最大値を設定します。
SMI_PROXY_MINIMUM_POSTGRES_PROXY_PORT SMI_PROXY_MAXIMUM_POSTGRES_PROXY_PORT
QID 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
- クラスタ内のすべての構成ファイルがすべてのノードで同じになるように、これらの手順をクラスタ内のノードごとに繰り返します。