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 l'ingresso all'utilizzo del gateway di ingresso Apigee.

Gateway in entrata Apigee 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 l'installazione ibrida, Apigee Ingress Gateway. 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 migrare il traffico al nuovo gateway in entrata Apigee.

Due scenari per la migrazione sono:

  • Migrazione multi-cluster o multiregionale (opzione consigliata):

    Prima di passare a un nuovo Ingress per Apigee, reindirizza tutto il traffico a un altro cluster o regione dal cluster di cui stai eseguendo la migrazione. In questo modo, avrai il tempo di verificare se il nuovo gateway in entrata Apigee funziona come previsto. Poi sposta di nuovo il traffico sul cluster di cui è stato eseguito l'upgrade.

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

    Durante l'upgrade, Apigee visualizzerà il nuovo gateway di ingresso con un nuovo indirizzo IP. A questo punto puoi verificare se il nuovo gateway in entrata Apigee funziona come previsto e poi spostare il traffico sul nuovo ingresso. Durante questo upgrade potrebbe verificarsi un tempo di inattività.

Installa il gateway in entrata Apigee

  1. Per installare Apigee Ingress Gateway, 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.
    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 Ingress. Può essere qualsiasi nome che soddisfi i seguenti requisiti:
      • Avere una lunghezza massima di 17 caratteri
      • Contenere solo caratteri alfanumerici minuscoli, '-' o '.'
      • Iniziare con un carattere alfanumerico
      • Terminare con un carattere alfanumerico
      Consulta ingressGateways[].name nel Riferimento per le proprietà di configurazione.
    • REPLICAS_MIN e REPLICAS_MAX sono il numero minimo e massimo di repliche per il gateway in entrata Apigee nell'installazione. Per ulteriori informazioni e impostazioni predefinite, vedi ingressGateways[].replicaCountMin e ingressGateways[].replicaCountMax nel riferimento alla proprietà di configurazione.
    • CPU_COUNT_REQ e MEMORY_REQ sono la richiesta di CPU e memoria per ogni replica del gateway in entrata Apigee nell'installazione.

      Per ulteriori informazioni e impostazioni predefinite, vedi ingressGateways[].resources.requests.cpu e ingressGateways[].resources.requests.memory nel riferimento alla 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 ulteriori informazioni e impostazioni predefinite, vedi ingressGateways[].resources.limits.cpu e ingressGateways[].resources.limits.memory nel riferimento alla proprietà di configurazione.

    • SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (facoltativo):

      Si tratta di una coppia chiave-valore che fornisce annotazioni per il servizio di ingresso predefinito. Le annotazioni vengono utilizzate dalla tua piattaforma cloud per aiutare 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 piattaforma a piattaforma. Consulta la documentazione della piattaforma per le annotazioni richieste e suggerite.

      Consulta ingressGateways[].svcAnnotations in Riferimento per le proprietà di configurazione.
    • SVC_LOAD_BALANCER_IP (facoltativo) Consente di assegnare un indirizzo IP statico al 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 in Riferimento per le proprietà di configurazione.
  2. Applica le modifiche per installare Apigee Ingress Gateway con questi comandi: 
    $APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml

Sposta il traffico sul gateway in entrata Apigee

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