為 Apigee mTLS 設定多個資料中心

Apigee mTLS 支援多個資料中心,因此您可以擴充設定,納入更複雜的拓撲結構,例如 12 個節點的叢集安裝程序

在多資料中心拓撲中,mTLS 的安裝程序與簡單拓撲相同。不過,您必須確保安裝作業符合必要條件,並按照後續各節所述變更設定檔。

必要條件

如要搭配多個資料中心使用 Apigee mTLS,您必須:

  • 請解除安裝 apigee-mtls,並使用多個資料中心設定重新安裝。您無法修改現有設定。詳情請參閱變更現有的 apigee-mtls
  • 在執行 mTLS 的每個主機上開啟通訊埠 8302。
  • 請確認所有 mTLS 叢集成員都有專屬的 IP 位址,且叢集的所有成員都一致。
  • 指定設定檔時,請在可能含有歧義的指令中使用絕對路徑。
  • 按照多個資料中心的設定檔所述,新增多資料中心設定屬性。

多個資料中心的設定檔

如要將 Apigee mTLS 與多個資料中心搭配使用,請為每個資料中心建立個別的設定檔。

在每個設定檔中:

  1. 變更 ALL_IP 設定屬性的值,納入所有區域中的主機 IP 位址。
  2. 確認 REGION 屬性的值是目前區域或資料中心的名稱。例如「dc-1」。
  3. 新增下列屬性:
    屬性 說明
    APIGEE_MTLS_MULTI_DC_ENABLE 您是否使用多資料中心設定。如要設定多個資料中心,請設為「y」。否則請省略或設為「n」。預設值會省略。
    MTLS_LOCAL_REGION_IP 以空格分隔的清單,列出您目前設定的區域所使用的所有 IP 位址。例如「10.0.0.1 10.0.0.2 10.0.0.3」。

    如要使用設定中的第二個區域,請使用 MTLP_REMOTE_REGION_1_IP 屬性。

    MTLS_REMOTE_REGION_1_NAME 多資料中心設定中的「第二個」區域名稱。例如「dc-2」。

    第二個區域的設定檔中,您會使用「dc-2」做為 REGION,而「dc-1」則用於 MTLS_REMOTE_REGION_1_NAME.

    MTLS_REMOTE_REGION_1_IP 以空格分隔的清單,當中列出在多資料中心設定中,第二個區域使用的所有 IP 位址。例如「10.0.0.4 10.0.0.5 10.0.0.6」。

以下範例顯示兩個資料中心 (「dc-1」和「dc-2」) 的設定檔。系統會醒目顯示多資料中心設定專屬的屬性):

dc-1 設定檔

ALL_IP="10.126.0.114 10.126.0.113 10.126.0.96 10.126.0.132 10.126.0.133 10.126.0.104 10.126.0.106 10.126.0.105 10.126.0.95 10.126.0.102 10.126.0.100 10.126.0.112"
LDAP_MTLS_HOSTS="10.126.0.114 10.126.0.106"
ZK_MTLS_HOSTS="10.126.0.114 10.126.0.113 10.126.0.96 10.126.0.106 10.126.0.105 10.126.0.95"
CASS_MTLS_HOSTS="10.126.0.114 10.126.0.113 10.126.0.96 10.126.0.106 10.126.0.105 10.126.0.95"
PG_MTLS_HOSTS="10.126.0.104 10.126.0.112"
RT_MTLS_HOSTS="10.126.0.113 10.126.0.96 10.126.0.105 10.126.0.95"
MS_MTLS_HOSTS="10.126.0.114 10.126.0.106"
MP_MTLS_HOSTS="10.126.0.113 10.126.0.96 10.126.0.105 10.126.0.95"
QP_MTLS_HOSTS="10.126.0.132 10.126.0.133 10.126.0.102 10.126.0.100"
ENABLE_SIDECAR_PROXY="y"
ENCRYPT_DATA="zRNQ9lhRySNTfegiLLLfIQ=="
PATH_TO_CA_CERT="/opt/consul-agent-ca.pem"
PATH_TO_CA_KEY="/opt/consul-agent-ca-key.pem"

APIGEE_MTLS_MULTI_DC_ENABLE="y"
REGION="dc-1"
MTLS_LOCAL_REGION_IP="10.126.0.114 10.126.0.113 10.126.0.96 10.126.0.132 10.126.0.133 10.126.0.104"
MTLS_REMOTE_REGION_1_NAME="dc-2"
MTLS_REMOTE_REGION_1_IP="10.126.0.106 10.126.0.105 10.126.0.95 10.126.0.102 10.126.0.100 10.126.0.112"

dc-2 設定檔

ALL_IP="10.126.0.114 10.126.0.113 10.126.0.96 10.126.0.132 10.126.0.133 10.126.0.104 10.126.0.106 10.126.0.105 10.126.0.95 10.126.0.102 10.126.0.100 10.126.0.112"
LDAP_MTLS_HOSTS="10.126.0.114 10.126.0.106"
ZK_MTLS_HOSTS="10.126.0.114 10.126.0.113 10.126.0.96 10.126.0.106 10.126.0.105 10.126.0.95"
CASS_MTLS_HOSTS="10.126.0.114 10.126.0.113 10.126.0.96 10.126.0.106 10.126.0.105 10.126.0.95"
PG_MTLS_HOSTS="10.126.0.104 10.126.0.112"
RT_MTLS_HOSTS="10.126.0.113 10.126.0.96 10.126.0.105 10.126.0.95"
MS_MTLS_HOSTS="10.126.0.114 10.126.0.106"
MP_MTLS_HOSTS="10.126.0.113 10.126.0.96 10.126.0.105 10.126.0.95"
QP_MTLS_HOSTS="10.126.0.132 10.126.0.133 10.126.0.102 10.126.0.100"
ENABLE_SIDECAR_PROXY="y"
ENCRYPT_DATA="zRNQ9lhRySNTfegiLLLfIQ=="
PATH_TO_CA_CERT="/opt/consul-agent-ca.pem"
PATH_TO_CA_KEY="/opt/consul-agent-ca-key.pem"

APIGEE_MTLS_MULTI_DC_ENABLE="y"
REGION="dc-2"
MTLS_LOCAL_REGION_IP="10.126.0.106 10.126.0.105 10.126.0.95 10.126.0.102 10.126.0.100 10.126.0.112"
MTLS_REMOTE_REGION_1_NAME="dc-1"
MTLS_REMOTE_REGION_1_IP="10.126.0.114 10.126.0.113 10.126.0.96 10.126.0.132 10.126.0.133 10.126.0.104"

如要瞭解標準設定屬性,請參閱「步驟 1:更新設定檔」。

測試多資料中心設定

raft list-peers 指令會顯示 MTLS_LOCAL_REGION_IP 中定義的 IP 位址清單,這代表這些位址位於同一個資料中心內。

以下範例顯示 raft list-peers 指令的輸出內容範例:

[ec2-user]# consul operator raft list-peers

Node              ID                Address            State     Voter  RaftProtocol
prc-test-1-2119   d1361917-b244-42  10.126.0.151:8300  leader    true   3
prc-test-0-2119   fad66fc3-22a0-43  10.126.0.155:8300  follower  true   3
prc-test-2-2119   78847b12-dd83-44  10.126.0.159:8300  follower  true   3
prc-test-6-2119   60bb50ac-37b6-52  10.126.0.152:8300  leader    true   3
prc-test-7-2119   515bbdfd-e968-53  10.126.0.147:8300  follower  true   3
prc-test-8-2119   d869c9a5-b4f6-54  10.126.0.158:8300  follower  true   3

Apigee mTLS 已在兩個資料中心進行測試,且僅支援兩個資料中心。不過,您可以使用下列屬性指定最多八個資料中心的設定:

  • MTLS_REMOTE_REGION_[2-8]_IP
  • MTLS_REMOTE_REGION_[2-8]_NAME

如先前所述,系統不支援設定超過兩個資料中心。