Alibaba Cloud Service Mesh:Upgrade canário para um gateway do ASM

Pré-requisitos

• Instância e versão do ASM — Certifique-se de ter added a cluster to an ASM instance e que a versão do ASM seja 1.20 ou posterior. Para obter instruções sobre como atualizar uma instância do ASM, consulte Upgrade an ASM instance.

• Gateway de entrada — Verifique se você já created an ingress gateway.

• Desligamento graceful — Ative o desligamento graceful no gateway antes de realizar o upgrade. Essa medida minimiza o risco de perda de tráfego durante a atualização. Para mais detalhes, consulte Enable graceful shutdown to prevent traffic loss.

• Ausência de conflito de nomes com o Canary Deployment — Garanta que não exista nenhum Deployment no namespace do gateway cujo nome corresponda ao nome do Deployment do gateway seguido pelo sufixo -canary. Por exemplo, se o gateway se chamar ingressgateway, confirme que não há nenhum Deployment chamado istio-ingressgateway-canary no namespace istio-system.

• Acesso ao plano de dados — Obtenha o arquivo KubeConfig do plano de dados para executar comandos kubectl no cluster correspondente.

Funcionamento do upgrade canário de gateway

Como ponto único de entrada e saída para o tráfego de service, o gateway deve atender a rigorosos requisitos de disponibilidade. O upgrade canário ajuda a manter a continuidade dos negócios. Você altera a configuração do gateway para iniciar primeiro um pod com a nova versão e valida o tráfego nele. A atualização completa do gateway ocorre somente após a validação bem-sucedida. Caso surja algum problema durante a verificação, exclua esse novo pod a qualquer momento e retome o upgrade após resolver a questão.

No ASM, a atualização do plano de controle e a do plano de dados são processos separados. O plano de dados pode ser atualizado após a conclusão da atualização do plano de controle.

Um upgrade canário de gateway cria um Deployment de réplica única compatível com a versão atual do plano de controle. Esse recurso é denominado Canary Deployment, e o único pod gerenciado por ele é o pod canário. O Canary Deployment pertence ao mesmo Service do Deployment original do gateway. A diferença reside no nome, que corresponde ao nome do Deployment original acrescido do sufixo -canary.

Ambos os caminhos de atualização de instância do ASM listados abaixo suportam o upgrade canário de gateway. Identifique o seu cenário antes de começar:

• Upgrade in-place de instância do ASM — Após a conclusão da atualização do plano de controle, o gateway continua executando a versão anterior. Execute do Passo 1 ao Passo 4 descritos neste tópico.

• Upgrade canário de instância do ASM — O Passo 1 deste tópico não se aplica. Durante o upgrade canário da instância, após alternar a nova versão para o plano de controle padrão, o gateway fica pendente de atualização. Prossiga a partir do Passo 2 para implantar um pod canário no gateway, validar o tráfego e concluir a atualização do gateway após a verificação bem-sucedida.

Passo 1: Atualize o plano de controle

1. Faça login no console do ASM. No painel de navegação à esquerda, escolha Service Mesh > Mesh Management.

2. Na página Mesh Management, clique em nome da instância do ASM. No painel de navegação à esquerda, escolha Instance Information > Upgrade Management.

3. Na página Upgrade Management, na aba In-place Upgrades, clique em Perform Upgrade Precheck. Na caixa de diálogo Note, clique em OK.

   Nota

   Caso a página exiba a mensagem Currently, it is the latest version and does not need to be upgraded., significa que a service mesh já está na versão mais recente e não pode ser atualizada.

4. Após a aprovação da pré-verificação, clique em Upgrade. Na caixa de diálogo Note, clique em OK.

Passo 2: Implante um pod canário para o gateway do ASM

Para implantar um pod canário em um gateway do ASM, adicione a anotação asm.alibabacloud.com/enable-canary-deployment: "true" ao campo annotations, dentro de metadata, no arquivo YAML do gateway. Utilize o console do ASM ou a linha de comando kubectl.

apiVersion: istio.alibabacloud.com/v1beta1
kind: IstioGateway
metadata:
  labels:
    asm-gateway-type: ingress
  annotations:
    asm.alibabacloud.com/enable-canary-deployment: "true"  # Add this annotation.
  name: ingressgateway
  namespace: istio-system
spec:
  clusterIds:
    - xxxxxxxxxxxxxx
  disableContainerPortExposed: true
  dnsPolicy: ClusterFirst
  externalTrafficPolicy: Local
  gatewayType: ingress
  ports:
    - name: http-0
      port: 80
      protocol: HTTP
      targetPort: 80
  replicaCount: 1
  resources:
    limits:
      cpu: '2'
      memory: 4G
    requests:
      cpu: 200m
      memory: 256Mi
  rollingMaxSurge: 25%
  rollingMaxUnavailable: 25%
  serviceAnnotations:
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain: 'on'
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain-timeout: '10'
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-instance-charge-type: PayByCLCU
    service.beta.kubernetes.io/alicloud-loadbalancer-address-type: internet
  serviceType: LoadBalancer

Passo 3: Atualize o gateway após a validação bem-sucedida

1. Faça login no console do ASM. No painel de navegação à esquerda, escolha Service Mesh > Mesh Management.

2. Na página Mesh Management, clique em nome da instância do ASM. No painel de navegação à esquerda, escolha Instance Information > Upgrade Management.

3. Na seção Data Plane, coluna Upgrade, selecione o gateway desejado e clique em Upgrade Gateway. Na caixa de diálogo Note, clique em OK e aguarde a conclusão da atualização do gateway.

Passo 4: Exclua o pod canário

Após concluir a atualização do gateway, remova a anotação adicionada no Passo 2. O pod canário será excluído automaticamente. Para confirmar, visualize novamente os Deployments no namespace do gateway e verifique se o Deployment com o sufixo -canary deixou de existir.