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 estágios, grupos e pausas opcionais entre estágios. Essas sequências podem ser salvas como estratégias de atualização que podem ser gerenciadas 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 das execuções de atualização, estágios, grupos e estratégias referenciados neste guia.

• Você deve ter um recurso de frota com um ou mais clusters de membros. Caso contrário, siga o início rápido para criar um recurso do Fleet e ingressar em clusters do 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.61.0 ou posterior instalada. Para instalar ou atualizar, consulte Instalar a CLI do Azure.

• Você também precisa da extensão CLI do fleet Azure, 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
  

Atribuir clusters a grupos de atualização

Antes que os clusters possam ser usados em estratégias de atualização, eles devem ser adicionados a grupos de atualização que podem ser usados em estágios de atualização. 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.

Você pode atribuir um cluster de membros a um grupo de atualização específico de duas maneiras:

• Atribua ao grupo ao adicionar cluster de membros à frota.
• Atribua um membro da frota existente a um grupo de atualização.

Nota

Um membro da frota só pode fazer parte de um grupo de atualização, mas um grupo de atualização pode ter vários membros da frota atribuídos a ele. Um grupo de atualização em si não é um tipo de recurso separado. Os grupos de atualização são apenas cadeias de caracteres que representam referências dos membros da frota. Assim, se todos os membros da frota com referências a um grupo de atualização comum forem excluídos, esse grupo de atualização específico também deixará de existir.

Atribuir ao grupo ao adicionar cluster de membros à frota

Portal do Azure

1. No portal do Azure, navegue até o recurso do Azure Kubernetes Fleet Manager.

2. No menu de serviço, em Configurações, selecione Adicionar clusters>de membros.

   

3. Selecione o cluster que pretende adicionar e, em seguida, selecione Seguinte: Rever + adicionar.

4. Introduza o nome do grupo de atualizações ao qual pretende atribuir o cluster e, em seguida, selecione Adicionar.

   

CLI do Azure

Atribua um cluster membro a um grupo de atualização ao adicionar o cluster membro à frota usando o az fleet member create comando com o --update-group parâmetro definido para o nome do grupo de atualização.

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

Portal do Azure

1. No portal do Azure, navegue até o recurso do Azure Kubernetes Fleet Manager.

2. No menu de serviço, em Configurações, selecione Clusters de membros.

3. Selecione os clusters que pretende atribuir a um grupo de atualizações e, em seguida, selecione Atribuir grupo de atualizações

   

4. Introduza o nome do grupo de atualização ao qual pretende atribuir o cluster e, em seguida, selecione Atribuir.

   

CLI do Azure

Atribua um membro da frota existente a um grupo de atualização usando o az fleet member update comando com o --update-group sinalizador definido para o nome do grupo de atualização.

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

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.

Portal do Azure

1. No portal do Azure, navegue até o recurso do Azure Kubernetes Fleet Manager.

2. No menu de serviço, em Configurações, selecione Estratégias de atualização>de vários clusters e, em seguida, Criar.

3. Insira um nome para a estratégia.

4. Na primeira vez que você visualiza a página, um diagrama de explicação da estratégia de atualização é exibido que pode ajudar a visualizar como as estratégias funcionam.

   

5. Selecione Criar estágio e digite:

   • Nome artístico - nomeie o palco - deve ser único em todos os nomes de palco da frota.
   • (Opcional) Pausar após etapa - selecione esta opção se quiser definir uma pausa antes de passar para a próxima etapa.
   • (Opcional) Duração da pausa - selecione uma duração predefinida ou insira um valor personalizado em segundos.

   

6. Atribua um ou mais grupos de atualizações ao estágio e selecione Criar.

   

CLI do Azure

Para esse cenário, criaremos estágios e grupos para corresponder aos detalhes usados para o processo do portal do Azure.

1. Crie um arquivo JSON para definir os estágios e grupos para a execução da atualização. Aqui está um exemplo de entrada do arquivo de estágios (example-stages.json) que representa a estratégia mostrada para criação por meio do portal do Azure:

   {
       "stages": [
           {
               "name": "stage-1",
               "groups": [
                   {
                       "name": "group-1"
                   },
                   {
                       "name": "group-2"
                   }
               ],
               "afterStageWaitInSeconds": 300
           },
           {
               "name": "stage-2",
               "groups": [
                   {
                       "name": "group-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-stages.json
   

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 fazer: atualize automaticamente vários clusters usando o Azure Kubernetes Fleet Manager.