Zum Apigee Ingress-Gateway migrieren

Mit diesem Verfahren können Sie vorhandene Apigee Hybrid v1.8-Installationen von der Verwendung von Anthos Service Mesh für eingehenden Traffic zur Verwendung des Apigee Ingress-Gateways migrieren.

Apigee Ingress-Gateway in der Apigee Hybrid-Version 1.8

Ab Version 1.8 bietet Apigee Hybrid ein neues Feature zum Verwalten des Ingress-Gateways für die Hybridinstallation: Apigee Ingress-Gateway. Anthos Service Mesh ist keine Voraussetzung für die Hybridinstallation mehr und Apigee stellt die Routingkonfiguration an Anthos Service Mesh ein. Nach dem Upgrade müssen Sie den Traffic zum neuen Apigee Ingress-Gateway-Gateway migrieren.

Es gibt zwei Migrationsszenarien:

  • Multi-Cluster- oder Multi-Region-Migration (empfohlen):

    Bevor Sie zu einem neuen Ingress für Apigee wechseln, leeren Sie den gesamten Traffic von dem zu migrierenden Cluster zu einem anderen Cluster oder einer anderen Region. Dadurch haben Sie Zeit, zu testen, ob das neue Apigee-Ingress-Gateway wie erwartet funktioniert. Verschieben Sie dann den Traffic zurück zum aktualisierten Cluster.

  • Direktes Upgrade (nicht in Produktionsumgebungen empfohlen):

    Während des Upgrades ruft Apigee das neue Ingress-Gateway mit einer neuen IP-Adresse auf. Sie können dann testen, ob das neue Apigee-Ingress-Gateway wie erwartet funktioniert, und dann den Traffic auf das neue Ingress-Gateway verschieben. Während dieses Upgrades kann es zu Ausfallzeiten kommen.

Apigee Ingress-Gateway installieren

  1. Zum Installieren des Apigee Ingress-Gateways müssen Sie der Überschreibungsdatei das Attribut ingressGateways hinzufügen.

    Syntax

    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. See Known issue 243599452.
    SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
  svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional

    Beispiel

    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 ist der Name des Ingress-Deployments. Dies kann ein beliebiger Name sein, der die folgenden Anforderungen erfüllt:
      • Darf maximal 17 Zeichen lang sein
      • Darf nur kleingeschriebene, alphanumerische Zeichen enthalten, "-" oder ".".
      • Muss mit einem alphanumerischen Zeichen beginnen.
      • Muss mit einem alphanumerischen Zeichen enden.
      Siehe ingressGateways[].name in der Referenz zu Konfigurationsattributen.
    • REPLICAS_MIN und REPLICAS_MAX sind die minimalen und maximalen Replikatzahlen für das Apigee-Ingress-Gateway in Ihrer Installation. Weitere Informationen und Standardeinstellungen finden Sie unter ingressGateways[].replicaCountMin und ingressGateways[].replicaCountMax in der Referenz zu Konfigurationsattributen.
    • CPU_COUNT_REQ und MEMORY_REQ sind die CPU- und Speicheranforderung für jedes Replikat des Apigee Ingress-Gateways in Ihrer Installation.

      Weitere Informationen und Standardeinstellungen finden Sie unter ingressGateways[].resources.requests.cpu und ingressGateways[].resources.requests.memory in der Referenz zu Konfigurationsattributen.

    • CPU_COUNT_LIMIT und MEMORY_LIMIT: die maximalen CPU- und Arbeitsspeicherlimits für jedes Replikat des Apigee Ingress-Gateways in Ihrer Installation.

      Weitere Informationen und Standardeinstellungen finden Sie unter ingressGateways[].resources.limits.cpu und ingressGateways[].resources.limits.memory in der Referenz zu Konfigurationsattributen.

    • SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (optional):

      Dies ist ein Schlüssel/Wert-Paar, das Annotationen für Ihren Standarddienst für eingehenden Traffic bereitstellt. Annotationen werden von Ihrer Cloud Platform verwendet, um Ihre Hybridinstallation zu konfigurieren, z. B. um den Load-Balancer-Typ auf intern oder extern festzulegen. Beispiel: 

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

      Annotationen variieren je nach Plattform. Erforderliche und vorgeschlagene Annotationen finden Sie in der Dokumentation Ihrer Plattform.

      Siehe ingressGateways[].svcAnnotations in der Referenz zu Konfigurationsattributen.
    • SVC_LOAD_BALANCER_IP (optional): Ermöglicht das Zuweisen einer statischen IP-Adresse für Ihren Load-Balancer. Auf Plattformen, die die Angabe der IP-Adresse des Load-Balancers unterstützen, wird der Load-Balancer mit dieser IP-Adresse erstellt. Auf Plattformen, auf denen Sie die IP-Adresse des Load-Balancers nicht angeben können, wird dieses Attribut ignoriert.

      Wenn Sie Ihrem Load-Balancer keine statische IP-Adresse zugewiesen haben, lassen Sie dieses Attribut in der Überschreibungsdatei weg.

      Siehe ingressGateways[].svcLoadBalancerIP in der Referenz zu Konfigurationsattributen.
  2. Wenden Sie mit den folgenden Befehlen die Änderungen an, um das Apigee Ingress-Gateway zu installieren: 
    $APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml

Traffic zum Apigee Ingress-Gateway umleiten

Führen Sie die Schritte unter Traffic von Anthos Service Mesh zum Apigee Ingress-Gateway umleiten im Thema zum Upgrade auf Apigee Hybrid v1.8 aus, um Traffic von Anthos Service Mesh zum Apigee Ingress-Gateway zu migrieren.