Microservices Engine:Migrate from Nginx Ingress to MSE Ingress

Pré-requisitos

• Um Nginx Ingress Controller implantado no cluster do Container Service.

• Um Cloud Native Gateway disponível. Se não tiver um, consulte Crie um MSE Cloud Native Gateway.

Observações de uso

• O processo de migração não copia as configurações de Ingress. Em vez disso, permite que o MSE Ingress reutilize essas configurações monitorando e interpretando alterações nos recursos de Ingress existentes em tempo real.

• Durante a migração, tanto o Nginx Ingress Controller quanto o MSE Ingress refletem quaisquer alterações nas configurações de Ingress.

• Após concluir a migração, não exclua nenhuma configuração de Ingress em uso. A migração apenas habilita o MSE Ingress a monitorar e interpretar configurações de Ingress atuais e futuras.

• Após a migração, mantenha as configurações de Ingress existentes e futuras associadas à IngressClass original. Por exemplo, se um recurso de Ingress especificava anteriormente ingressClassName: nginx em sua spec, deve continuar assim após a migração.

Métodos de migração

Fluxo de trabalho de migração

O Cloud Native Gateway fornece uma ferramenta de Migração para a Cloud que orienta passo a passo na migração das configurações de roteamento e na transferência de tráfego.

Etapa 1: Migrar regras de roteamento

1. Faça login no console do MSE. Na barra de navegação superior, selecione uma região.

2. No painel de navegação à esquerda, escolha Cloud Native Gateway > Migration to Cloud.

3. Na página Migration to Cloud, clique em Add Task.

4. No painel Create Migration Configuration, configure os parâmetros.

   O Cloud Native Gateway monitora todos os recursos de Ingress no cluster de contêiner selecionado associados à IngressClass de origem e aplica as configurações de nome de domínio e roteamento.

   Importante

   A migração não é permitida se o Cloud Native Gateway de destino já estiver associado a este cluster de contêiner usando uma IngressClass diferente. Certifique-se de que a IngressClass especificada aqui corresponda àquela já configurada para o cluster.

   Parâmetro	Descrição
   Cloud-native Gateway	Selecione o Cloud Native Gateway de destino para a migração. A versão do gateway deve ser 1.2.22 ou posterior.
   Container Service ACK/ACK Serverless cluster	Selecione o cluster do Container Service que contém o Nginx Ingress a ser migrado. Garanta que o Cloud Native Gateway e o cluster de contêiner estejam na mesma VPC.
   Source Ingress Class	Especifique a IngressClass associada aos recursos de Ingress que deseja migrar. Nota É possível especificar apenas uma IngressClass. Se deixar este parâmetro vazio, a IngressClass será ignorada e o gateway monitorará todos os recursos de Ingress no cluster.
   Descrição	Insira uma descrição com até 64 caracteres.

5. Clique em Next.

   O Cloud Native Gateway passa a monitorar automaticamente as alterações em todos os recursos de Ingress no cluster de contêiner selecionado e associados à IngressClass de origem, aplicando as configurações de nome de domínio e roteamento desses recursos.

   1. Suponha que exista um Ingress chamado httpbin no cluster de contêiner de origem.

   2. No console do Cloud Native Gateway, o Ingress do cluster de origem é sincronizado automaticamente com o gateway de destino, criando as configurações de domínio e roteamento correspondentes. A página de detalhes Routing Settings é exibida da seguinte forma:

      1. Assistente de configuração:

         1. Adicionar fonte de serviço

            Use K8s, Nacos, Zookeeper, SAE, EDAS e Function Compute (FC) como fontes de serviço. Adicione um recurso existente da VPC atual e selecione um serviço registrado nele.

            Botão: Add service source

         2. Associar serviço de backend

            Distribui solicitações para um serviço de backend. Esse serviço pode ser descoberto dinamicamente a partir de uma fonte de serviço ou especificado por um endereço estático ou nome de domínio.

            Botão: Associate backend service

         3. Vincular nome de domínio

            Oferece gerenciamento de múltiplos domínios. Ao vincular um nome de domínio, associe protocolos, certificados e configurações de roteamento a diferentes domínios.

            Botão: Bind domain name

         4. Criar rota

            Uma rota contém regras de correspondência baseadas em nomes de domínio, caminhos, métodos, parâmetros de solicitação e cabeçalhos de solicitação. Quando um usuário acessa uma rota, a solicitação é encaminhada para o serviço de backend correspondente.

            Botão: Create route

      2. Colunas da lista: Route name, Status, WAF protection, Source, Route condition, Associated domain name, Destination service type, Destination service e Actions.

Etapa 2: Verificar rotas

Verifique a compatibilidade das anotações de Ingress monitoradas:

• Se não houver anotações de Ingress incompatíveis, prossiga para a próxima etapa.

• Caso encontre anotações de Ingress incompatíveis, envie um ticket para obter uma solução.

  Importante

  • Ignore a anotação nginx.ingress.kubernetes.io/service-weight se seu valor for "". Essa anotação é adicionada por padrão por uma versão anterior do console do Container Service e não tem efeito.

  • Durante a migração, não remova anotações incompatíveis em uso. Essas anotações ainda são interpretadas pelo Nginx Ingress Controller e afetam o tráfego do negócio. Adicione anotações estendidas do MSE ao recurso de Ingress para obter a mesma funcionalidade no MSE Ingress. Depois que todo o tráfego for migrado para o MSE Ingress, remova as anotações incompatíveis conforme necessário.

Etapa 3: Selecionar método de transferência

Testar antes de transferir o tráfego

Antes de transferir o tráfego de produção, realize um teste local. Modifique o arquivo hosts local para resolver o nome de domínio de negócios para o SLB do Cloud Native Gateway. Use uma ferramenta como curl ou Postman para verificar se todo o tráfego se comporta conforme o esperado.

Selecionar método de transferência

apiVersion: v1
kind: Service
metadata:
  annotations:
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-id: lb-bp1lc0huzf0o1ks333yo1
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight: '100'
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-vgroup-port: 'rsp-bp1uybv6iy50i:80,rsp-bp10s0ndrfvdt:443'
  creationTimestamp: '2023-11-29T07:14:40Z'
  finalizers:
    - service.k8s.alibaba/resources
  labels:
    app: nginx-ingress-lb
    service.beta.kubernetes.io/hash: 39a51bd97b88f6eaf232da33434ce2fe44ae094b7b4d2b9bb9126eb7
    service.k8s.alibaba/loadbalancer-id: lb-bp1lc0huzf0o1ks333yo1
  managedFields:
    - apiVersion: v1
      fieldsType: FieldsV1
      fieldsV1:
        'f:metadata':
          'f:annotations':
            .: {}
            'f:kubectl.kubernetes.io/last-applied-configuration': {}
            'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain': {}
            'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain-timeout': {}
            'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-instance-charge-type': {}
            'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-resource-group-id': {}
          'f:labels':
            .: {}
            'f:app': {}