Migrazione al gateway Apigee Ingress

Usa questa procedura per eseguire la migrazione delle installazioni Apigee hybrid v1.8 esistenti dall'utilizzo di Anthos Service Mesh per il traffico in entrata all'utilizzo del gateway Apigee in entrata.

Gateway Apigee in entrata in Apigee hybrid versione 1.8

A partire dalla versione 1.8, Apigee hybrid offre una nuova funzionalità per gestire il gateway in entrata per la tua installazione ibrida, il gateway Apigee Ingress. Anthos Service Mesh non è più un prerequisito per l'installazione ibrida e Apigee smetterà di fornire la configurazione del routing ad Anthos Service Mesh. Dopo l'upgrade, devi eseguire la migrazione del traffico al nuovo gateway gateway in entrata Apigee.

Gli scenari per la migrazione sono due:

  • Migrazione multi-cluster o multiregionale (consigliata):

    Prima di passare a una nuova risorsa Ingress per Apigee, svuota tutto il traffico verso un altro cluster o un'altra regione dal cluster di cui stai eseguendo la migrazione. In questo modo potrai verificare se il nuovo gateway gateway in entrata Apigee funziona come previsto. Quindi, riporta il traffico al cluster di cui è stato eseguito l'upgrade.

  • Upgrade in loco (non consigliato negli ambienti di produzione):

    Durante l'upgrade, Apigee visualizzerà il nuovo gateway in entrata con un nuovo indirizzo IP. Puoi quindi verificare se il nuovo gateway gateway in entrata Apigee funziona come previsto, quindi spostare il traffico al nuovo gateway in entrata. Durante l'upgrade potrebbero verificarsi tempi di inattività.

Installa il gateway in entrata Apigee

  1. Per installare il gateway in entrata Apigee, devi aggiungere la proprietà ingressGateways al file degli override.

    Sintassi

    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

    Esempio

    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 è il nome del deployment in entrata. Può essere qualsiasi nome che soddisfi i seguenti requisiti:
      • Avere una lunghezza massima di 17 caratteri
      • Contenere solo caratteri alfanumerici minuscoli, "-" o "."
      • Inizia con un carattere alfanumerico
      • Termina con un carattere alfanumerico
      Consulta ingressGateways[].name nella Riferimento alle proprietà di configurazione.
    • REPLICAS_MIN e REPLICAS_MAX sono il numero minimo e massimo di repliche per il gateway Apigee in entrata nella tua installazione. Per ulteriori informazioni e per le impostazioni predefinite, consulta ingressGateways[].replicaCountMin e ingressGateways[].replicaCountMax nel riferimento sulle proprietà di configurazione.
    • CPU_COUNT_REQ e MEMORY_REQ sono le richieste di CPU e memoria per ogni replica del gateway in entrata Apigee nella tua installazione.

      Per ulteriori informazioni e per le impostazioni predefinite, consulta ingressGateways[].resources.requests.cpu e ingressGateways[].resources.requests.memory nel riferimento sulle proprietà di configurazione.

    • CPU_COUNT_LIMIT e MEMORY_LIMIT sono i limiti massimi di CPU e memoria per ogni replica del gateway in entrata Apigee nella tua installazione.

      Per ulteriori informazioni e per le impostazioni predefinite, consulta ingressGateways[].resources.limits.cpu e ingressGateways[].resources.limits.memory nel riferimento sulle proprietà di configurazione.

    • (Facoltativo) SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE:

      Si tratta di una coppia chiave-valore che fornisce annotazioni per il servizio in entrata predefinito. Le annotazioni vengono utilizzate dalla piattaforma cloud per configurare l'installazione ibrida, ad esempio impostando il tipo di bilanciatore del carico su interno o esterno. Ad esempio: 

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

      Le annotazioni variano da piattaforma a piattaforma. Per le annotazioni richieste e suggerite, fai riferimento alla documentazione della tua piattaforma.

      Consulta ingressGateways[].svcAnnotations nella Riferimento alle proprietà di configurazione.
    • SVC_LOAD_BALANCER_IP (facoltativo) Consente di assegnare un indirizzo IP statico per il bilanciatore del carico. Sulle piattaforme che supportano la specifica dell'indirizzo IP del bilanciatore del carico, il bilanciatore del carico verrà creato con questo indirizzo IP. Sulle piattaforme che non consentono di specificare l'indirizzo IP del bilanciatore del carico, questa proprietà viene ignorata.

      Se non hai un indirizzo IP statico allocato per il bilanciatore del carico, escludi questa proprietà dal file degli override.

      Consulta ingressGateways[].svcLoadBalancerIP nella Riferimento alle proprietà di configurazione.
  2. Applica le modifiche per installare il gateway in entrata Apigee con i seguenti comandi: 
    $APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml

Passa il traffico al gateway in entrata Apigee

Per eseguire la migrazione del traffico da Anthos Service Mesh al gateway in entrata Apigee, segui i passaggi descritti in Cambiare il traffico da Anthos Service Mesh al gateway in entrata Apigee nell'argomento Upgrade ad Apigee Hybrid v1.8.