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

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.

   

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

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.

   

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-1

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 - nome do estágio - deve ser único entre todos os nomes de estágio na estratégia.
   • (Opcional) Aprovações de estágio – selecione essa opção se você quiser aguardar uma aprovação antes que essa fase seja iniciada ou depois que ela for concluída. Para obter mais informações, confira Adicionar aprovações a grupos e etapas de atualização.
   • (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.

   Observação

   O número máximo de Grupos de Atualização em cada Estágio de Atualização é 50.

   

Para esse cenário, criamos 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. Os estágios são executados sequencialmente na ordem em que aparecem no arquivo JSON. Os grupos são executados em paralelo em cada estágio, portanto, a ordenação não é importante. O seguinte arquivo de exemplo (example-stages.json) define uma estratégia com dois estágios e inclui opcionais maxConcurrency e maxAllowedFailures configurações:

   {
       "stages": [
           {
               "name": "stage-1",
               "maxConcurrency": "7",
               "maxAllowedFailures": "2",
               "groups": [
                   {
                       "name": "group-1",
                       "maxConcurrency": "3",
                       "maxAllowedFailures": "1"
                   },
                   {
                       "name": "group-2",
                       "maxConcurrency": "50%",
                       "maxAllowedFailures": "25%"
                   }
               ],
               "afterStageWaitInSeconds": 300
           },
           {
               "name": "stage-2",
               "maxConcurrency": "100%",
               "maxAllowedFailures": "0",
               "groups": [
                   {
                       "name": "group-3",
                       "maxConcurrency": "2",
                       "maxAllowedFailures": "0"
                   }
               ]
           }
       ]
   }
   

   maxConcurrency

   O maxConcurrency campo é opcional e controla quantos clusters podem ser atualizados simultaneamente no nível do estágio ou do grupo. Use um valor maior para atualizar clusters mais rapidamente em sua frota ou um valor menor para uma distribuição mais controlada que limita o raio de explosão se surgirem problemas.

   Neste exemplo, stage-1 define maxConcurrency como "7", o que permite que até "7" clusters nesta fase atualizem simultaneamente. Dentro de stage-1, group-1 limita a simultaneidade aos clusters "3", o que significa que até "3" nesse grupo pode ser atualizado simultaneamente. group-2 permite que até "50%" seus clusters atualizem simultaneamente (por exemplo, se o grupo contiver 4 clusters, até 2 poderão ser atualizados simultaneamente).

   Os valores podem ser um inteiro fixo (por exemplo, "3") ou um percentual (por exemplo, "100%"). Se omitido, o sistema aplicará valores padrão. Para obter detalhes sobre como esses valores são resolvidos e seus limites superiores, consulte Máxima simultaneidade (versão prévia).

   maxAllowedFailures

   O campo maxAllowedFailures é opcional e controla quantas falhas na atualização dos clusters membros são toleradas antes que o grupo ou estágio seja marcado como falho. Por padrão (quando não definido ou "0"), uma única falha interrompe toda a execução da atualização.

   Essa configuração avalia apenas a contagem de falhas. Ele não impõe uma taxa mínima de sucesso. Um grupo ou estágio pode, portanto, terminar em Completed mesmo que alguns ou todos os membros tenham falhado, desde que o limite de falhas não tenha sido excedido quando a Fleet tomou as decisões de agendamento.

   Neste exemplo, stage-1 define maxAllowedFailures como "2", tolerando até duas falhas de membro no estágio. Dentro de stage-1, group-1 tolera "1" falhas, e group-2 tolera a falha de "25%" de seus membros (por exemplo, se o grupo contiver 4 clusters, até 1 falha será tolerada). stage-2 define maxAllowedFailures como "0", o que significa que qualquer falha interrompe imediatamente a execução e geralmente é útil para estágios de produção.

   Para a maioria das implantações, prefira valores baseados em percentuais, pois eles se adaptam melhor a diferentes tamanhos de grupo. Evite definir o valor igual ao número total de membros, a menos que você queira, intencionalmente, um comportamento de “nunca falhar” para esse segmento.

   Os valores podem ser um inteiro fixo (por exemplo, "3") ou um percentual (por exemplo, "25%"). Para obter detalhes sobre como esses valores são resolvidos, consulte Máximo de falhas permitidas (versão prévia).

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