Migrazione al gateway Apigee Ingress

Usa questa procedura per eseguire la migrazione delle installazioni Apigee hybrid v1.8 esistenti dall'utilizzo Anthos Service Mesh per il traffico in entrata per l'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ù prerequisito per l'installazione ibrida e Apigee smetterà di fornire la configurazione del routing Anthos Service Mesh. Dopo l'upgrade, devi eseguire la migrazione del traffico al nuovo gateway in entrata Apigee gateway VPN ad alta disponibilità.

Gli scenari per la migrazione sono due:

  • Migrazione multi-cluster o multiregionale (consigliata):

    Prima di passare a un nuovo Ingress per Apigee, svuota tutto il traffico su un altro cluster oppure regione dal cluster di cui stai eseguendo la migrazione. In questo modo avrai il tempo di verificare se la nuova Il gateway gateway in entrata Apigee funziona come previsto. quindi sposta il traffico sulla piattaforma di cui è stato eseguito in un cluster Kubernetes.

  • 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 e quindi spostare il traffico verso il nuovo traffico 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 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 nel Riferimento alle proprietà di configurazione.
    • REPLICAS_MIN e REPLICAS_MAX sono il numero minimo e massimo di repliche per il gateway in entrata Apigee nella tua installazione. Per ulteriori informazioni e impostazioni predefinite, vedi ingressGateways[].replicaCountMin e ingressGateways[].replicaCountMax nel riferimento della proprietà di configurazione.
    • CPU_COUNT_REQ e MEMORY_REQ sono le richieste di CPU e memoria per ogni del gateway Apigee in entrata nella tua installazione.

      Per ulteriori informazioni e impostazioni predefinite, vedi ingressGateways[].resources.requests.cpu e ingressGateways[].resources.requests.memory nel riferimento della proprietà di configurazione.

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

      Per ulteriori informazioni e impostazioni predefinite, vedi ingressGateways[].resources.limits.cpu e ingressGateways[].resources.limits.memory nel riferimento della proprietà di configurazione.

    • SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (facoltativo):

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

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

      Le annotazioni variano da piattaforma a piattaforma. Fai riferimento alla tua piattaforma documentazione per le annotazioni obbligatorie e suggerite.

      Consulta ingressGateways[].svcAnnotations nella documentazione di riferimento delle proprietà di configurazione.
    • SVC_LOAD_BALANCER_IP (facoltativo) ti consente di assegnare un indirizzo IP statico per il tuo con il bilanciatore del carico di rete passthrough esterno regionale. Sulle piattaforme che supportano la specifica dell'indirizzo IP del bilanciatore del carico, verrà creato con questo indirizzo IP. Sulle piattaforme che non consentono di specificare indirizzo IP del bilanciatore del carico, questa proprietà viene ignorata.

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

      Consulta ingressGateways[].svcLoadBalancerIP nella documentazione di riferimento delle 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.