Migrar para o gateway de entrada do Apigee

Use este procedimento para migrar as instalações existentes do Apigee hybrid v1.8 da utilização do Anthos Service Mesh para a entrada para a utilização do gateway de entrada do Apigee.

Gateway de entrada do Apigee na versão 1.8 do Apigee Hybrid

A partir da versão 1.8, o Apigee hybrid oferece uma nova funcionalidade para gerir o gateway de entrada para a sua instalação híbrida, o gateway de entrada do Apigee. O Anthos Service Mesh já não é um pré-requisito para a instalação híbrida, e o Apigee vai deixar de fornecer a configuração de encaminhamento ao Anthos Service Mesh. Após a atualização, tem de migrar o tráfego para o novo gateway de entrada do Apigee.

Seguem-se dois cenários de migração:

  • Migração multicluster ou multirregião (recomendada):

    Antes de mudar para um novo Ingress para o Apigee, desvie todo o tráfego para outro cluster ou região do cluster que está a migrar. Isto dá-lhe tempo para testar se o novo gateway de entrada do Apigee está a funcionar como esperado. Em seguida, transfira o tráfego novamente para o cluster atualizado.

  • Atualização no local (não recomendado em ambientes de produção):

    Durante a atualização, o Apigee apresenta o novo gateway de entrada com um novo endereço IP. Em seguida, pode testar se o novo gateway de entrada do Apigee está a funcionar como esperado e, depois, transferir o tráfego para a nova entrada. Pode haver indisponibilidade durante esta atualização.

Instale o gateway de entrada do Apigee

  1. Para instalar o gateway de entrada do Apigee, tem de adicionar a propriedade ingressGateways ao ficheiro de substituições.

    Sintaxe

    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

    Exemplo

    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 é o nome da implementação de entrada. Pode ser qualquer nome que cumpra os seguintes requisitos:
      • Ter um comprimento máximo de 17 carateres
      • Contêm apenas carateres alfanuméricos minúsculos, "-" ou "."
      • Começar com um caráter alfanumérico
      • Terminar com um caráter alfanumérico
      Consulte ingressGateways[].name na referência da propriedade de configuração.
    • REPLICAS_MIN e REPLICAS_MAX são as quantidades mínimas e máximas de réplicas para o gateway de entrada do Apigee na sua instalação. Para mais informações e definições predefinidas, consulte ingressGateways[].replicaCountMin e ingressGateways[].replicaCountMax na referência da propriedade de configuração.
    • CPU_COUNT_REQ e MEMORY_REQ são o pedido de CPU e memória para cada réplica do gateway de entrada do Apigee na sua instalação.

      Para mais informações e definições predefinidas, consulte ingressGateways[].resources.requests.cpu e ingressGateways[].resources.requests.memory na referência da propriedade de configuração.

    • CPU_COUNT_LIMIT e MEMORY_LIMIT são os limites máximos de CPU e memória para cada réplica do gateway de entrada do Apigee na sua instalação.

      Para mais informações e definições predefinidas, consulte ingressGateways[].resources.limits.cpu e ingressGateways[].resources.limits.memory na referência da propriedade de configuração.

    • SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (opcional):

      Este é um par de chave-valor que fornece anotações para o seu serviço de entrada predefinido. As anotações são usadas pela sua plataforma na nuvem para ajudar a configurar a instalação híbrida, por exemplo, definindo o tipo de balanceador de carga como interno ou externo. Por exemplo: 

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

      As anotações variam de plataforma para plataforma. Consulte a documentação da plataforma para ver as anotações obrigatórias e sugeridas.

      Consulte ingressGateways[].svcAnnotations na referência da propriedade de configuração.
    • SVC_LOAD_BALANCER_IP (opcional) Permite-lhe atribuir um endereço IP estático ao seu equilibrador de carga. Em plataformas que suportam a especificação do endereço IP do balanceador de carga, o balanceador de carga é criado com este endereço IP. Nas plataformas que não permitem especificar o endereço IP do balanceador de carga, esta propriedade é ignorada.

      Se não tiver um endereço IP estático atribuído ao seu equilibrador de carga, exclua esta propriedade do ficheiro de substituições.

      Consulte ingressGateways[].svcLoadBalancerIP na referência da propriedade de configuração.
  2. Aplique as alterações para instalar o gateway de entrada do Apigee com os seguintes comandos: 
    $APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml

Mude o tráfego para o gateway de entrada do Apigee

Para migrar o tráfego do Anthos Service Mesh para o gateway de entrada do Apigee, siga os passos descritos no artigo Mude o tráfego do Anthos Service Mesh para o gateway de entrada do Apigee no tópico Atualizar para o Apigee Hybrid v1.8.