Configurar atualizações para membros da rede de aplicações do Azure Kubernetes (pré-visualização)

Importante

Os recursos de pré-visualização do AKS estão disponíveis numa base de autosserviço e adesão voluntária. As visualizações prévias são fornecidas "como estão" e "conforme disponíveis" e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões de teste do AKS são parcialmente cobertas pelo suporte ao cliente numa base de melhor esforço. Assim sendo, estas funcionalidades não se destinam ao uso em produção. Para obter mais informações, consulte os seguintes artigos de suporte:

O Azure Kubernetes Application Network proporciona controlo flexível sobre como as atualizações menores de versão são aplicadas aos membros. Cada cluster membro inscrito num recurso Azure Kubernetes Application Network pode usar um de dois modos de atualização, dependendo do nível de controlo que necessita: autogerido (SelfManaged) ou totalmente gerido (FullyManaged). Estes modos funcionam ao nível dos membros, permitindo-lhe escolher se as melhorias são feitas manualmente ou automaticamente para cada cluster.

Este artigo explica as diferenças entre estes modos de atualização, como configurá-los para os membros da sua Azure Kubernetes Application Network e considerações importantes a ter em conta ao gerir atualizações.

Considerações gerais sobre modos de atualização

Tenha em mente as seguintes limitações e considerações ao configurar modos de atualização para membros da Azure Kubernetes Application Network:

  • Os modos de atualização Azure Kubernetes Application Network aplicam-se apenas a versões menores dos componentes Azure Kubernetes Application Network. Eles não controlam ou afetam atualizações ao nível do cluster, como as versões do Kubernetes ou as atualizações de imagem dos nós.
  • As atualizações de patches são sempre aplicadas automaticamente, independentemente do modo.
  • Seleciona o modo de atualização para cada membro durante o processo de junção. Uma vez selecionado, o modo mantém-se ativo para esse membro até ser removido do recurso Azure Kubernetes Application Network. Não pode alterar o modo de atualização para um membro sem primeiro removê-lo e voltar a ligá-lo ao recurso Azure Kubernetes Application Network.
  • Se não especificares um modo de atualização durante a entrada dos membros, por defeito passa para SelfManaged.

Modo de gestão própria

No SelfManaged modo, especifica a versão menor do Azure Kubernetes Application Network para instalar e controlar quando ocorrem atualizações. Este modo destina-se a cenários em que se pretende gerir manualmente o processo de atualização menor em vez de depender de atualizações automáticas. Neste modo, se --version não for especificado, passa por defeito para a N-1primeira versão disponível. Este modo é também o padrão se não for especificado um modo de atualização durante a entrada dos membros.

Considerações sobre modos autogeridos

Ao usar o modo SelfManaged, tenha em mente as seguintes considerações:

  • As melhorias só são permitidas entre versões menores consecutivas (por exemplo, da versão N menor para N+1). Saltar versões (por exemplo, atualizar de 1.1 para 1.3) não é suportado.
  • Só pode voltar atrás para a versão imediatamente anterior (N-1), desde que tenha sido instalada anteriormente no mesmo cluster. Voltar a qualquer outra versão anterior não é suportado.
  • Múltiplos rollbacks consecutivos não são suportados. Podes reverter apenas uma versão.

Inscreva-se em modo de autogestão e selecione a versão durante a adesão de membros

  • Adira ao modo SelfManaged e selecione explicitamente uma versão durante a entrada de membros utilizando o comando az appnet member join com o parâmetro --upgrade-mode SelfManaged e o parâmetro --version ajustado para a versão desejada.

    az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode SelfManaged \
    --version $VERSION

Verifique a versão atual

  • Verifique qual a versão que está instalada atualmente num membro do sistema usando o comando az appnet member show e consulte a(s) propriedade(s) Version na saída.

    az appnet member show --member-name $APPNET_MEMBER_NAME --appnet-name $APPNET_NAME --resource-group $APPNET_RG

Verifique as versões de atualização disponíveis

  • Verifique quais as versões disponíveis para cada modo e a versão Kubernetes na sua região usando o az appnet list-versions comando com o --location parâmetro definido para a região de interesse. No resultado, consulte a AvailableUpgrades coluna para ver quais as versões disponíveis.

    az appnet list-versions --location $LOCATION -o table

Iniciar uma atualização

  • Inicie uma atualização usando o az appnet member update comando com o --version parâmetro definido para a versão desejada a atualizar.

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION

Voltar a uma versão anterior

  • Recuar para uma versão previamente instalada usando o comando az appnet member update com o parâmetro --version definido para a versão desejada. Lembre-se que só é suportado reverter para a versão imediatamente anterior (N-1).

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION

Modo totalmente gerido

No FullyManaged modo, a Azure Kubernetes Application Network gere automaticamente as atualizações de versão para cada membro com base no canal de lançamento selecionado. Recomendamos este modo se preferir a Azure Kubernetes Application Network para tratar da avaliação da estabilidade de versões, do calendário de implementação e das atualizações contínuas sem intervenção manual.

Ao usar FullyManaged o modo de atualização, escolhe um canal de lançamento que determina a rapidez com que os seus grupos de membros adotam novas versões. A Azure Kubernetes Application Network monitoriza a prontidão para lançamentos e atualiza os membros de acordo com os critérios de estabilidade do canal.

Os seguintes canais de lançamento estão disponíveis para o modo FullyManaged.

  • Rapid: Entrega a versão mais recente da Rede de Aplicações assim que esta fica disponível. Este canal destina-se a ambientes não produtivos ou de validação inicial, onde testar novas funcionalidades é priorizado em detrimento do tempo de validação prolongado.
  • Estável: Fornece versões que completaram validação e testes adicionais. Este canal destina-se a ambientes de produção e normalmente está alinhado com versões N-1menores, garantindo maior fiabilidade e resolvendo quaisquer problemas identificados em versões anteriores.

Quando o modo FullyManaged é selecionado, pode especificar o canal de lançamento como stable ou rapid. Se omitido, o canal padrão é stable.

Importante

No FullyManaged modo, a Azure Kubernetes Application Network aplica automaticamente atualizações à medida que novas versões são promovidas através dos canais de lançamento. O controlo manual do timing da atualização ou da seleção de versões não é suportado.

Verifique as versões de atualização disponíveis para o modo totalmente gerido

  • Verifique a que versão cada canal corresponde para uma dada região e uma versão Kubernetes utilizando o comando az appnet list-versions e executar o grep para o modo FullyManaged.

    az appnet list-versions --location $LOCATION -o table | grep FullyManaged

Registe-se no modo total de gestão e selecione o canal de lançamento durante a aderência dos membros

  • Inscreva-se no FullyManaged modo e selecione um canal de distribuição durante a adesão do membro usando o az appnet member join comando com os parâmetros --upgrade-mode FullyManaged e --release-channel definidos para o canal desejado. O exemplo seguinte mostra como selecionar o Rapid canal durante a entrada de membros:

    az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode FullyManaged \
    --release-channel Rapid \
    --member-location $LOCATION

Atualização da seleção de canais de lançamento

Pode atualizar a sua versão selecionada a qualquer momento. Quaisquer alterações ao canal de lançamento entram em vigor imediatamente.

  • Atualize a seleção do canal de distribuição para um membro existente usando o comando az appnet member update com o parâmetro --release-channel definido como o canal pretendido. O exemplo seguinte mostra como mudar para o Stable canal para um membro existente:

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --release-channel Stable

Conteúdo relacionado

Para saber mais sobre a Azure Kubernetes Application Network, consulte os seguintes artigos:

  • Última atualização a