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 pela Frota 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 reutilizados 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 da Frota, que fornece uma explicação das execuções de atualização, estágios, grupos e estratégias referenciadas neste guia.

• Você tem um recurso de frota com um ou mais clusters membros. Caso contrário, siga o início rápido para criar um recurso de frota e ingressar clusters do AKS (Serviço de Kubernetes do Azure) 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, confira Instalar a CLI do Azure.

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

  az extension add --name fleet
  

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

  az extension update --name fleet
  

Selecionar clusters para sua estratégia

Há duas maneiras de selecionar quais clusters estão incluídos em cada estágio e grupo de sua estratégia de atualização para controlar a sequência de atualizações:

• Rótulos de membro (recomendado): atribua rótulos a cada membro da frota e use memberSelector para selecionar membros por esses rótulos. Cada membro pode ter vários rótulos.
• Atualizar grupos: atribua um grupo de atualizações a cada membro da frota e defina grupos em sua estratégia que correspondam a esses nomes de grupo. Cada membro só pode pertencer a um grupo.

Criar uma estratégia de atualização usando seletores de membro (versão prévia)

Os rótulos de membro são a abordagem recomendada para selecionar clusters em suas estratégias de atualização, pois fornecem mais flexibilidade. Para obter detalhes conceituais, consulte Clusters de grupo usando rótulos de membro.

Aplicar rótulos em clusters de membros

Aplique rótulos ao adicionar um cluster de membros à frota

Aplique rótulos aos membros da frota usando o az fleet member create comando. O exemplo a seguir aplica dois rótulos ao cluster membro: 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"

Aplicar rótulos a um membro da frota existente

Aplicar rótulos aos membros da 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, em que 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 funcionam em paralelo em cada etapa. O arquivo de exemplo a seguir (example-labels-strategy.json) define uma estratégia com dois estágios usando memberSelector para selecionar clusters por seus rótulos e inclui configurações opcionais maxConcurrency :

   • O estágio staging usa um memberSelector em nível de estágio para selecionar todos os clusters com o rótulo env=staging e criar um grupo implícito.
   • A etapa production utiliza um filtro no nível da etapa memberSelector para pré-filtrar todos os clusters com o rótulo env=production, e, em seguida, define dois grupos, cada um com seu próprio memberSelector para selecionar os clusters com base no rótulo tier.

   Quando memberSelector é definido em um grupo, o campo name desse grupo é utilizado apenas como um identificador de exibição para relatórios de status e registro em log, e deixa de ser usado para a seleção de membros da frota com base no grupo de atualização.

   {
       "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 comando az fleet updatestrategy create 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
   

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

Os clusters também podem ser selecionados em estratégias de atualização atribuindo-os a um único grupo de atualizações. Você pode definir uma estratégia de atualização que atribui esses grupos de atualização a estágios. Em um estágio de atualização, as atualizações são aplicadas a cada grupo de atualizações em paralelo. Em um grupo de atualização, os clusters membros são atualizados sequencialmente.

Atribuir clusters a grupos de atualização

Atribua ao grupo ao adicionar o cluster membro à 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, em que um estágio pode conter um ou mais grupos de atualização.

Próximas etapas

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

• Instruções: Atualizar vários clusters usando execuções de atualização do Gerenciador de Frota de Kubernetes do Azure.
• Instruções: adicionar aprovações às estratégias de atualização do Azure Kubernetes Fleet Manager.
• Instruções: Atualizar automaticamente vários clusters usando o Gerenciador de Frota de Kubernetes do Azure.
• Perguntas frequentes sobre atualizações de vários clusters.