Como migrar para o gateway de entrada da Apigee

Use este procedimento para migrar as instalações híbridas atuais da Apigee v1.8 de usar o Anthos Service Mesh para entrada para usar o gateway de entrada da Apigee.

Gateway de entrada da Apigee na Apigee híbrida versão 1.8

A partir da versão 1.8, a Apigee híbrida oferece um novo recurso para gerenciar o gateway de entrada da sua instalação híbrida, o gateway de entrada da Apigee. O Anthos Service Mesh não é mais um pré-requisito para a instalação híbrida. A Apigee deixará de fornecer configurações de roteamento para o Anthos Service Mesh. Após o upgrade, será necessário migrar o tráfego para o novo gateway de gateway de entrada da Apigee.

Veja a seguir dois cenários que podem ser migrados:

  • Migração em vários clusters ou multirregiões (recomendado):

    Antes de alternar para um novo Ingress para a Apigee, drene todo o tráfego para outro cluster ou região do cluster que você está migrando. Isso dará tempo para você testar se o novo gateway de gateway de entrada da Apigee está funcionando conforme o esperado. Depois, transfira o tráfego de volta para o cluster atualizado.

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

    Durante o upgrade, a Apigee abrirá o novo gateway de entrada com um novo endereço IP. Depois, é possível testar se o novo gateway de gateway de entrada da Apigee está funcionando conforme o esperado e, em seguida, transferir o tráfego para a nova entrada. Talvez haja inatividade durante esse upgrade.

Instalar o gateway de entrada da Apigee

  1. Para instalar o gateway de entrada da Apigee, é necessário adicionar a propriedade ingressGateways ao arquivo de modificaçõ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. See Known issue 243599452.
        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 implantação de entrada. Pode ser qualquer nome que atenda aos seguintes requisitos:
      • ter um comprimento máximo de 17 caracteres
      • conter apenas caracteres alfanuméricos minúsculos, "-" ou ".";
      • começar com um caractere alfanumérico;
      • terminar com um caractere alfanumérico.
      Consulte ingressGateways[].name na referência da propriedade de configuração.
    • REPLICAS_MIN e REPLICAS_MAX são as contagens mínima e máxima de réplicas para o gateway de entrada da Apigee na sua instalação. Para mais informações e configurações padrão, consulte ingressGateways[].replicaCountMin e ingressGateways[].replicaCountMax na referência da propriedade de configuração.
    • CPU_COUNT_REQ e MEMORY_REQ são a solicitação de CPU e memória para cada réplica do gateway de entrada da Apigee na sua instalação.

      Para mais informações e definições padrão, 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 da Apigee na sua instalação.

      Para mais informações e definições padrão, 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):

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

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

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

      Consulte ingressGateways[].svcAnnotations na referência da propriedade de configuração.
    • SVC_LOAD_BALANCER_IP (opcional) permite atribuir um endereço IP estático ao seu balanceador de carga. Nas plataformas compatíveis com a especificação do endereço IP do balanceador de carga, o balanceador de carga será criado com esse endereço IP. Nas plataformas que não permitem especificar o IP do balanceador de carga, essa propriedade é ignorada.

      Se você não tiver um endereço IP estático alocado para o balanceador de carga, deixe essa propriedade fora do arquivo de substituição.

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

Alternar tráfego para o gateway de entrada da Apigee

Para migrar o tráfego do Anthos Service Mesh para o gateway de entrada da Apigee, siga as etapas em Alternar tráfego do Anthos Service Mesh para o gateway de entrada da Apigee no tópico "Como fazer upgrade para a Apigee híbrida v1.8".