Alibaba Cloud Service Mesh:Migrate an Nginx Ingress that uses a CLB instance to an ASM gateway

Obter o ID da instância de CLB

Execute o comando a seguir para recuperar o ID da instância de CLB:

kubectl -n kube-system get svc nginx-ingress-lb -o yaml | grep service.k8s.alibaba/loadbalancer-id

Saída esperada:

service.k8s.alibaba/loadbalancer-id: lb-bp1gts52ced2vgaw1ni78

Anote o ID da instância de CLB (por exemplo, lb-bp1gts52ced2vgaw1ni78). Você precisará dele nas etapas posteriores.

Atualize as configurações do CLB no console

1. Abra o Server Load Balancer console.

2. Localize sua instância de CLB e faça as seguintes alterações:

   • Desative o configuration read-only mode.

   • Exclua as tags kubernetes.do.not.delete e ack.aliyun.com.

   • Renomeie os grupos vServer que começam com k8s/ para o formato shared-<port>. Por exemplo, renomeie k8s/80/nginx-ingress-lb/kube-system/c553a74e6ad13423aa839c8e5******** para shared-80.

Adicionar anotações ao Serviço NGINX Ingress

Adicione as seguintes anotações ao Serviço NGINX Ingress para que ele referencie o CLB explicitamente, em vez de depender da descoberta gerenciada pelo ACK:

metadata:
  annotations:
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-id: "<your-clb-instance-id>"
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-force-override-listeners: "false"
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-vgroup-port: "<your-vgroup-id-1>:80,<your-vgroup-id-2>:443"
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight: "100"

Substitua os seguintes espaços reservados pelos valores reais:

serviceAnnotations:
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-id: "<your-clb-instance-id>"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-force-override-listeners: "false"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-vgroup-port: "<your-vgroup-id>:80"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight: "0"

NGINX Ingress (antes)

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: helloworld
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
  rules:
    - http:
        paths:
          - backend:
              serviceName: helloworld
              servicePort: 80
            path: /helloworld(/|$)(.*)
      host: example.com

VirtualService do Istio (depois)

apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
  name: example-vs
spec:
  gateways:
  - istio-system/ingressgateway    # Replace with your ASM gateway name
  hosts:
  - example.com
  http:
  - name: route-helloworld
    match:
    - uri:
        prefix: /helloworld/
    - uri:
        prefix: /helloworld
    rewrite:
      uri: /
    route:
    - destination:
        host: helloworld
        port:
          number: 80

Principais diferenças entre Ingress e VirtualService

A tabela a seguir resume o mapeamento entre os campos do NGINX Ingress e seus equivalentes no VirtualService do Istio:

Equivalentes comuns de anotações do NGINX Ingress

Se você usar anotações avançadas do NGINX Ingress, consulte a tabela a seguir para ver os equivalentes no Istio:

Roteamento entre namespaces

Se um VirtualService e seu Serviço de destino estiverem no mesmo namespace, use o nome curto do serviço (por exemplo, helloworld). Se estiverem em namespaces diferentes, use o formato de Nome de Domínio Totalmente Qualificado (FQDN):

<service-name>.<namespace>.svc.cluster.local

Opção A: Testar por meio de um CLB temporário

Crie uma nova instância de CLB e aponte-a para o gateway de entrada do ASM. Envie solicitações de teste para este CLB:

curl -s -I -H "Host: example.com" http://<test-clb-ip>/helloworld/

Saída esperada (principais cabeçalhos):

HTTP/1.1 200 OK
server: istio-envoy

O cabeçalho server: istio-envoy confirma que o tráfego está fluindo pelo gateway do ASM.

Opção B: Testar de dentro do cluster

Envie solicitações diretamente para o Serviço do gateway de entrada do ASM dentro do cluster:

# Get the ASM ingress gateway ClusterIP
GATEWAY_IP=$(kubectl -n istio-system get svc istio-ingressgateway -o jsonpath='{.spec.clusterIP}')

# Send a test request
curl -s -I -H "Host: example.com" http://$GATEWAY_IP/helloworld/

Confirme se a resposta corresponde ao que o NGINX Ingress retorna para a mesma solicitação. O cabeçalho server: istio-envoy na resposta indica que o tráfego está fluindo pelo gateway do ASM.

Cronograma de migração recomendado

Aumente o peso do gateway do ASM incrementalmente e monitore em cada estágio:

Ajustar pesos

Peso do gateway do ASM: Atualize a anotação service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight no serviceAnnotations do IstioGateway:

serviceAnnotations:
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight: "50"    # Adjust this value

Peso do NGINX Ingress: Atualize a anotação service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight no Serviço NGINX Ingress. Se essa anotação não estiver configurada, ajuste o peso diretamente no CLB console.

Rollback

Se ocorrerem problemas durante a migração de tráfego, defina o peso do gateway do ASM como "0" e o peso do NGINX Ingress como "100":

# ASM gateway: stop receiving traffic
serviceAnnotations:
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight: "0"

# NGINX Ingress Service: restore full traffic
metadata:
  annotations:
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight: "100"

Todo o tráfego retorna ao NGINX Ingress imediatamente. Nenhuma alteração de DNS é necessária porque ambos os gateways compartilham a mesma instância de CLB.