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
-
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.
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
eingressGateways[].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
eingressGateways[].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
eingressGateways[].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.
ConsulteingressGateways[].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.
ConsulteingressGateways[].svcLoadBalancerIP
na referência da propriedade de configuração.
- INGRESS_NAME é o nome da implantação de entrada. Pode ser qualquer nome
que atenda aos seguintes requisitos:
- 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".