Migrazione al gateway Apigee Ingress

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

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ù 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 di ingresso Apigee.

Esistono due scenari per la migrazione:

  • Migrazione multi-cluster o multi-regione (opzione 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 il nuovo gateway di ingresso Apigee funziona come previsto. Poi sposta nuovamente 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 di ingresso Apigee funziona come previsto e poi spostare il traffico sul nuovo ingresso. Durante l'upgrade potrebbero verificarsi tempi di inattività.

Installa il gateway di ingresso Apigee

  1. Per installare il gateway di ingresso Apigee, devi aggiungere la proprietà ingressGateways al file delle sostituzioni.

    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 di Ingress. 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
      • Deve terminare con un carattere alfanumerico
      Consulta ingressGateways[].name nel Riferimento per le proprietà di configurazione.
    • REPLICAS_MIN e REPLICAS_MAX sono i conteggi delle repliche minimo e massimo per Gateway di ingresso 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 replica del gateway di ingresso Apigee 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 di importazione 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 richieste e suggerite.

      Consulta ingressGateways[].svcAnnotations nel riferimento per le proprietà di configurazione.
    • SVC_LOAD_BALANCER_IP (facoltativo) Ti consente di assegnare un indirizzo IP statico per il bilanciatore del carico. Sulle piattaforme che supportano l'indicazione 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 allocato un indirizzo IP statico per il bilanciatore del carico, lascia questa proprietà fuori dal file delle sostituzioni.

      Consulta ingressGateways[].svcLoadBalancerIP nel riferimento per le proprietà di configurazione.
  2. Applica le modifiche per installare il gateway di ingresso 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.