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 di ingresso Apigee nella versione 1.8 di Apigee hybrid

A partire dalla versione 1.8, Apigee Hybrid offre una nuova funzionalità per gestire il gateway di ingresso per la tua installazione ibrida, Apigee ingress gateway. 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 di ingresso Apigee.

Esistono due scenari per la migrazione:

  • Migrazione multi-cluster o multiregionale (consigliata):

    Prima di passare a un nuovo Ingress per Apigee, scarica tutto il traffico su un altro cluster o 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. Poi sposta di nuovo il traffico sul cluster sottoposto ad upgrade.

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

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

Installa il gateway di ingresso 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 "."
      • Deve iniziare 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, consulta ingressGateways[].replicaCountMin e ingressGateways[].replicaCountMax nel riferimento alla proprietà Configuration.
    • 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, consulta ingressGateways[].resources.requests.cpu e ingressGateways[].resources.requests.memory nel riferimento alla proprietà Configuration.

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

      Per ulteriori informazioni e impostazioni predefinite, consulta ingressGateways[].resources.limits.cpu e ingressGateways[].resources.limits.memory nel riferimento alla proprietà Configuration.

    • 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 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 piattaforma a piattaforma. Fai riferimento alla documentazione della piattaforma per le annotazioni richieste 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 l'indirizzo IP del bilanciatore del carico, questa proprietà viene ignorata.

      Se non hai allocato un indirizzo IP statico per il bilanciatore del carico, lascia questa proprietà al di fuori del file delle sostituzioni.

      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

Spostare il traffico sul gateway di ingresso Apigee

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