Definir estratégias de atualização reutilizáveis usando o Azure Kubernetes Fleet Manager

Os administradores podem controlar a sequência de atualizações para clusters gerenciados por frotas definindo uma série de estágios e grupos. Eles podem configurar quando as aprovações e pausas devem ocorrer dentro desses estágios e grupos. Toda a configuração pode ser salva como uma estratégia de atualização que pode ser gerenciada independentemente de execuções de atualização ou atualizações automáticas, permitindo que as estratégias sejam reutilizadas conforme necessário.

Este artigo aborda como definir estratégias de atualização usando grupos e estágios.

Pré-requisitos

• Leia a visão geral conceitual das atualizações do Fleet, que fornece uma explicação dos ciclos de atualização, estágios, grupos e estratégias referenciados neste guia.

• Você deve ter um recurso de frota com um ou mais grupos de membros. Caso contrário, siga o Guia de Início Rápido para criar um recurso Fleet e adicionar clusters ao Serviço Kubernetes do Azure (AKS) como membros.

• Defina as seguintes variáveis de ambiente:

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  export CLUSTERID=<aks-cluster-resource-id>
  export STRATEGY=<strategy-name>
  

• Se você estiver seguindo as instruções da CLI do Azure neste artigo, precisará da CLI do Azure versão 2.70.0 ou posterior instalada. Para instalar ou atualizar, consulte Instalar a CLI do Azure.

• Você também precisa da fleet extensão CLI do Azure versão 1.6.0 ou posterior, que pode ser instalada executando o seguinte comando:

  az extension add --name fleet
  

  Execute o az extension update comando para atualizar para a versão mais recente da extensão lançada:

  az extension update --name fleet
  

Selecione clusters para a sua estratégia

Existem duas formas de selecionar quais clusters estão incluídos em cada fase e grupo da sua estratégia de atualização para controlar a sequência de atualização:

• Rótulos de membros (recomendados): Atribua rótulos a cada membro da frota e usa memberSelector para selecionar membros por esses rótulos. Cada membro pode ter várias etiquetas.
• Atualizar grupos: Atribua um grupo de atualização a cada membro da frota, depois define grupos na tua estratégia que correspondam a esses nomes. Cada membro só pode pertencer a um grupo.

Crie uma estratégia de atualização usando selecionadores de membros (pré-visualização)

As etiquetas de membros são a abordagem recomendada para selecionar clusters nas suas estratégias de atualização porque oferecem mais flexibilidade. Para detalhes conceptuais, veja Agrupamentos de grupo usando rótulos de membros.

Aplicar etiquetas nos clusters de membros

Aplique etiquetas ao adicionar um agrupamento de membros à frota

Aplique etiquetas aos membros da sua frota usando o az fleet member create comando. O exemplo seguinte aplica dois rótulos ao grupo de membros: env=staging e tier=frontend:

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --labels "env=staging tier=frontend"

Aplique etiquetas a um membro da frota existente

Aplique etiquetas aos membros da sua frota usando o az fleet member update comando

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --labels "env=staging tier=frontend"

Criar uma estratégia de atualização

Uma estratégia de atualização consiste em um ou mais estágios, onde um estágio pode conter um ou mais grupos de atualização.

1. Crie um arquivo JSON para definir os estágios e grupos para a execução da atualização. Os estágios são executados sequencialmente na ordem em que aparecem no arquivo JSON. Os grupos correm em paralelo dentro de cada estágio. O seguinte ficheiro de exemplo (example-labels-strategy.json) define uma estratégia com dois estágios que usam memberSelector para selecionar clusters pelos seus rótulos e inclui definições opcionais maxConcurrency :

   • O estágio staging utiliza um memberSelector ao nível de estágio para selecionar todos os clusters com o rótulo env=staging e criar um grupo implícito.
   • O production estágio utiliza um memberSelector de nível de estágio para pré-filtrar clusters com o rótulo env=production, depois define dois grupos, cada um com memberSelector próprio para selecionar clusters pelo rótulo tier.

   Quando memberSelector está configurado em um grupo, o campo name do grupo é usado apenas como identificador de visualização para relatórios de status e de registo, e não é mais utilizado para a seleção dos membros da frota com base em atualizações de grupos.

   {
       "stages": [
           {
               "name": "staging",
               "memberSelector": { "byLabel": "env=staging" },
               "maxConcurrency": "1",
               "afterStageWaitInSeconds": 600
           },
           {
               "name": "production",
               "memberSelector": { "byLabel": "env=production" },
               "maxConcurrency": "4",
               "groups": [
                   {
                       "name": "frontend",
                       "memberSelector": { "byLabel": "tier=frontend" },
                       "maxConcurrency": "3"
                   },
                   {
                       "name": "backend",
                       "memberSelector": { "byLabel": "tier=backend" },
                       "maxConcurrency": "3"
                   }
               ]
           }
       ]
   }
   

2. Crie uma nova estratégia de atualização usando o az fleet updatestrategy create comando com o sinalizador --stages definido como o nome do seu arquivo JSON.

   az fleet updatestrategy create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name $STRATEGY \
    --stages example-labels-strategy.json
   

Crie uma estratégia de atualização usando grupos de atualização

Clusters também podem ser selecionados em estratégias de atualização, atribuindo-os a um único grupo de atualização. Pode definir uma estratégia de atualização que atribua estes grupos de atualização a estágios. Dentro de um estágio de atualização, as atualizações são aplicadas a cada grupo de atualizações em paralelo. Dentro de um grupo de atualização, os clusters de membros são atualizados sequencialmente.

Atribuir clusters a grupos de atualização

Atribuir ao grupo ao adicionar cluster de membros à frota

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --update-group group-1a

Atribuir um membro da frota existente a um grupo de atualização

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --update-group group-1

Criar uma estratégia de atualização

Uma estratégia de atualização consiste em um ou mais estágios, onde um estágio pode conter um ou mais grupos de atualização.

Próximos passos

Você pode usar uma estratégia de atualização como parte de uma execução de atualização manual ou um perfil de atualização automática. Veja:

• Como fazer: Atualizar vários clusters usando as execuções de atualização do Kubernetes Fleet Manager do Azure.
• Como: Adicionar aprovações às Estratégias de Atualização do Gerenciador de Frota do Kubernetes do Azure.
• Como fazer: atualize automaticamente vários clusters usando o Azure Kubernetes Fleet Manager.
• Perguntas frequentes sobre atualizações de vários clusters.