Migrazione al gateway Apigee Ingress

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

Gateway in entrata Apigee in Apigee versione ibrida 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 Ingress Apigee. Anthos Service Mesh non è più un prerequisito per l'installazione ibrida e Apigee smetterà di fornire la configurazione di routing ad Anthos Service Mesh. Dopo l'upgrade, devi eseguire la migrazione del traffico al nuovo gateway gateway in entrata Apigee.

Esistono due scenari per la migrazione:

  • Migrazione multi-cluster o più regioni (opzione 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 di Apigee funziona come previsto. Poi riporta il traffico al cluster di cui è stato eseguito l'upgrade.

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

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

Installa il gateway in entrata Apigee

  1. Per installare il gateway in entrata Apigee, devi aggiungere la proprietà ingressGateways al file di 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:
      • Hanno una lunghezza massima di 17 caratteri
      • Contenere solo caratteri alfanumerici minuscoli, "-" o "."
      • Deve iniziare con un carattere alfanumerico.
      • Deve terminare con un carattere alfanumerico
      Consulta ingressGateways[].name nel riferimento alle proprietà Configurazione.
    • REPLICAS_MIN e REPLICAS_MAX sono il numero minimo e massimo di repliche per il gateway in entrata Apigee nell'installazione. Per maggiori informazioni e impostazioni predefinite, consulta ingressGateways[].replicaCountMin e ingressGateways[].replicaCountMax nel riferimento alle 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 maggiori informazioni e impostazioni predefinite, consulta ingressGateways[].resources.requests.cpu e ingressGateways[].resources.requests.memory nel riferimento alle 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 nell'installazione.

      Per maggiori informazioni e impostazioni predefinite, consulta ingressGateways[].resources.limits.cpu e ingressGateways[].resources.limits.memory nel riferimento alle proprietà di configurazione.

    • SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (facoltativo):

      Questa è una coppia chiave-valore che fornisce annotazioni per il servizio in entrata predefinito. Le annotazioni vengono utilizzate dalla piattaforma cloud per aiutarti a 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 una piattaforma all'altra. Fai riferimento alla documentazione della piattaforma per le annotazioni obbligatorie e suggerite.

      Consulta ingressGateways[].svcAnnotations nel 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 di override.

      Consulta ingressGateways[].svcLoadBalancerIP nel 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 di Apigee

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