Definir estratégias de atualização reutilizáveis usando o Gerenciador de Frota de Kubernetes do Azure

Os administradores podem controlar a sequência de atualizações para clusters gerenciados pela Frota 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 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 estiver seguindo as instruções da CLI do Azure neste artigo, você precisará da versão 2.61.0 ou posterior da CLI do Azure instalada. Para instalar ou atualizar, confira Instalar a CLI do Azure.

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

Atribuir clusters a grupos de atualização

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

Você pode atribuir um cluster membro a um grupo de atualizações específico de uma das duas maneiras:

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

Observação

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ções em si não é um tipo de recurso separado. Os grupos de atualizações são apenas cadeias de caracteres que representam referências dos membros da frota. Portanto, se todos os membros da frota que têm referências a um grupo de atualizações comum forem excluídos, esse grupo de atualizações específico também deixará de existir.

Atribua ao grupo ao adicionar o cluster membro à frota

Portal do Azure

1. No portal do Azure, navegue até o recurso do Gerenciador de Frota de Kubernetes do Azure.

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

   

3. Selecione o cluster que você deseja adicionar e selecione Avançar: Examinar + adicionar.

4. Insira o nome do grupo de atualização ao qual deseja atribuir o cluster e selecione Adicionar.

   

CLI do Azure

Atribua um cluster membro a um grupo de atualização ao adicionar o cluster membro à frota usando o comando az fleet member create com o parâmetro --update-group definido como 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 Gerenciador de Frota de Kubernetes do Azure.

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

3. Selecione os clusters que você deseja atribuir a um grupo de atualização e selecione Atribuir grupo de atualização

   

4. Insira o nome do grupo de atualização ao qual deseja atribuir o cluster e selecione Atribuir.

   

CLI do Azure

Atribua um membro de frota existente a um grupo de atualização usando o comando az fleet member update com o sinalizador --update-group definido com 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, em que 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 Gerenciador de Frota de Kubernetes do Azure.

2. No menu de serviço, em Configurações, selecione Atualização de múltiplos clusters>Estratégias e, em seguida, Criar.

3. Insira um nome para a estratégia.

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

   

5. Selecione Criar Estágio e insira:

   • Nome do estágio - nomeie o estágio - deve ser exclusivo em todos os nomes de estágio na frota.
   • (Opcional) Pausar após o estágio – selecione essa opção se quiser definir uma pausa antes de passar para o próximo estágio.
   • (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ção 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 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-stages.json
   

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: Atualizar automaticamente vários clusters usando o Gerenciador de Frota de Kubernetes do Azure.