デフォルトでは、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 が割り当てられています。
Apigee mTLS で使用されるポートのカスタマイズ
Apigee mTLS で使用されるポートをカスタマイズするには:
apigee-mtlsがすでにインストールされている場合は、次のようにアンインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
詳細については、Apigee mTLS をアンインストールするをご覧ください。
各ノードで、サイレント構成ファイルを開きます。このファイルの一般的な情報については、構成ファイルの作成をご覧ください。
必要に応じて、apigee-mtls の設定が完了する前に、 ポートの使用状況に関するレポートの生成に示されているコマンドを実行して、サイレント構成ファイルが生成する内容を確認できます。
ポートを設定するプロパティの値を追加または変更します。
次の表に、ポートと、Apigee mTLS でコンポーネントが使用するポートをカスタマイズするために使用するプロパティの名前を示します。
ノード デフォルトの範囲 説明 Apigee mTLS 10700 ～ 10799 apigee-mtlsがインストールされている各ホストには、指定された範囲内の単一のポートが必要です。ポートを定義するには、次のプロパティを使用して、ポート番号の最小値と最大値を同じ値に設定します。
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 10200 ～ 10299 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 10400 ～ 10499 apigee-qpidがインストールされている各ホストには、指定された範囲の 2 つのポートが必要です。カスタム範囲を定義するには、次のプロパティを使用してポート番号の最小値と最大値を設定します。
SMI_PROXY_MINIMUM_QPID_PROXY_PORT SMI_PROXY_MAXIMUM_QPID_PROXY_PORT
ルーター 10600 ～ 10699 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
- クラスタ内のノードごとにこの手順を繰り返して、すべてのノードで構成ファイルが同じになるようにします。