遷移至 Apigee Ingress 閘道

請按照這個程序，將現有的 Apigee hybrid v1.8 安裝作業從使用 Anthos 服務網格進行入口，改為使用 Apigee 入口閘道。

Apigee Hybrid 1.8 中的 Apigee 入口網關

自 1.8 版起，Apigee Hybrid 提供一項新功能，可管理混合式安裝的入口網關，也就是 Apigee 入口網關。Anthos 服務網格不再是混合式安裝作業的必要條件，且 Apigee 將停止向 Anthos 服務網格提供路由設定。升級後，您必須將流量遷移至新的 Apigee 入口閘道。

遷移的兩種情況如下：

• 多叢集或多區域遷移 (建議)：

  切換至新的 Apigee Ingress 前，請先將要遷移的叢集中的所有流量，轉移至其他叢集或區域。這樣您就能有時間測試新的 Apigee 入口閘道是否正常運作。然後將流量轉移回升級後的叢集。

• 原地升級 (不建議在正式環境中使用)：

  升級期間，Apigee 會使用新的 IP 位址啟用新的入口網關。接著，您可以測試新的 Apigee 入口網關是否正常運作，然後將流量轉移至新的入口。升級期間可能會發生停機情形。

安裝 Apigee 入口閘道

1. 如要安裝 Apigee 入口網關，您必須在覆寫檔案中加入 ingressGateways 屬性。

   語法

   ingressGateways:
   - name: INGRESS_NAME
     replicaCountMin: REPLICAS_MIN
     replicaCountMax: REPLICAS_MAX
     resources:
       requests:
         cpu: CPU_COUNT_REQ
         memory: MEMORY_REQ
       limits:
         cpu: CPU_COUNT_LIMIT
         memory: MEMORY_LIMIT
     svcAnnotations:  # optional.
       SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
     svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional

   範例

   ingressGateways:
   - name: prod1
     replicaCountMin: 2
     replicaCountMax: 100
     resources:
       requests:
         cpu: 1
         memory: 1Gi
       limits:
         cpu: 2
         memory: 2Gi
     svcAnnotations:  # optional. See Known issue 243599452.
       networking.gke.io/load-balancer-type: "Internal"
     svcLoadBalancerIP: 198.252.0.123 

   • INGRESS_NAME 是入口部署作業的名稱。這個名稱可以是符合下列規定的任何名稱：
     • 長度上限為 17 個半形字元
     • 只能包含小寫英數字元、連字號 (-) 或「.」。
     • 開頭必須是英數字元
     • 結尾須為英數字元
     請參閱設定屬性參考資料中的 ingressGateways[].name。
   • REPLICAS_MIN 和 REPLICAS_MAX 分別是 Apigee 入口網關在安裝作業中的複本數量下限和上限。如需詳細資訊和預設設定，請參閱設定屬性參考資料中的 ingressGateways[].replicaCountMin 和 ingressGateways[].replicaCountMax。
   • CPU_COUNT_REQ 和 MEMORY_REQ 是安裝環境中 Apigee 入口網關每個副本的 CPU 和記憶體要求。

     如需詳細資訊和預設設定，請參閱設定屬性參考資料中的 ingressGateways[].resources.requests.cpu 和 ingressGateways[].resources.requests.memory。

   • CPU_COUNT_LIMIT 和 MEMORY_LIMIT 是安裝環境中 Apigee 入口網關每個副本的 CPU 和記憶體上限。

     如需詳細資訊和預設設定，請參閱設定資源參考資料中的 ingressGateways[].resources.limits.cpu 和 ingressGateways[].resources.limits.memory。

   • SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (選用)：

     這是一個鍵/值組合，可為預設入口服務提供註解。雲端平台會使用註解來協助設定混合式安裝作業，例如將負載平衡器類型設為內部或外部。例如：

     ingressGateways:
       svcAnnotations:
         networking.gke.io/load-balancer-type: "Internal"

     註解會因平台而異。請參閱平台說明文件，瞭解必要和建議的註解。

     請參閱設定屬性參考資料中的 ingressGateways[].svcAnnotations。
   • SVC_LOAD_BALANCER_IP (選用) 可讓您為負載平衡器指派靜態 IP 位址。在支援指定負載平衡器 IP 位址的平台上，負載平衡器會使用這個 IP 位址建立。如果平台不允許您指定負載平衡器 IP 位址，系統會忽略這個屬性。

     如果您沒有為負載平衡器分配靜態 IP 位址，請將這個屬性留在覆寫檔案中。

     請參閱設定屬性參考資料中的 ingressGateways[].svcLoadBalancerIP。
2. 套用變更，使用下列指令安裝 Apigee Ingress Gateway：

   $APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml

將流量切換至 Apigee 輸入閘道

如要將流量從 Anthos 服務網格遷移至 Apigee 入口閘道，請按照「將流量從 Anthos 服務網格切換至 Apigee 入口閘道」一節中的步驟，升級至 Apigee Hybrid 1.8。