Configurar atualizações para membros da Rede de Aplicativos do Kubernetes do Azure (versão prévia)

Importante

As funcionalidades em versão preliminar do AKS estão disponíveis de forma optativa e por autoatendimento. As versões prévias são fornecidas “no estado em que se encontram” e “conforme disponíveis” e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões prévias do AKS são parcialmente cobertas pelo suporte ao cliente em uma base de melhor esforço. Dessa forma, esses recursos não são destinados ao uso em produção. Para obter mais informações, consulte os seguintes artigos:

A Rede de Aplicações Kubernetes do Azure fornece controle flexível sobre como as atualizações de versão menor são aplicadas aos membros. Cada cluster membro registrado em um recurso da Rede de Aplicativos do Kubernetes do Azure pode usar um dos dois modos de atualização, dependendo do nível de controle necessário: autogerenciado (SelfManaged) ou totalmente gerenciado (FullyManaged). Esses modos operam no nível de membro, permitindo que você escolha se as atualizações são executadas manualmente ou automaticamente para cada cluster.

Este artigo explica as diferenças entre esses modos de atualização, como configurá-los para seus membros da Rede de Aplicativos do Kubernetes do Azure e considerações importantes a serem consideradas ao gerenciar atualizações.

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

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

  • Os modos de atualização da Rede de Aplicativos do Kubernetes do Azure se aplicam somente a versões secundárias de componentes da Rede de Aplicativos do Kubernetes do Azure. Eles não controlam nem afetam atualizações no nível do cluster, como versões do Kubernetes ou atualizações de imagens dos nós.
  • As atualizações de patch são sempre aplicadas automaticamente, independentemente do modo.
  • Você seleciona o modo de atualização para cada membro durante o processo de junção. Depois de selecionado, o modo permanecerá em vigor para esse membro até que ele seja removido do recurso de Rede de Aplicativos do Kubernetes do Azure. Você não pode alterar o modo de upgrade de um membro sem primeiro removê-lo e reassociá-lo ao recurso Rede de Aplicativos do Kubernetes do Azure.
  • Se você não especificar um modo de atualização durante a entrada de membro, o padrão será SelfManaged.

Modo autogerenciado

No SelfManaged modo, você especifica a versão secundária da Rede de Aplicativos do Kubernetes do Azure para instalar e controlar quando as atualizações ocorrem. Esse modo destina-se a cenários em que você deseja gerenciar o processo de atualização secundária manualmente em vez de depender de atualizações automatizadas. Nesse modo, se --version não for especificado, ele usará como padrão a N-1versão st disponível. Esse modo também será o padrão se nenhum modo de atualização for especificado durante a junção do membro.

Considerações sobre o modo autogerenciado

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

  • As atualizações só são permitidas entre versões secundárias consecutivas (por exemplo, da versão N secundária para N+1). Não há suporte para ignorar versões (por exemplo, atualizar de 1.1 para 1.3).
  • Você só pode reverter para a versão imediatamente anterior (N-1), desde que ela tenha sido instalada anteriormente no mesmo cluster. Não há suporte para reverter para qualquer outra versão anterior.
  • Não há suporte para várias reversões consecutivas. Você pode reverter no máximo uma versão.

Registrar-se no modo autogerenciado e selecionar a versão durante a adesão do membro

  • Registre-se no modo SelfManaged e escolha explicitamente uma versão durante o ingresso de membro usando o comando az appnet member join com o parâmetro --upgrade-mode SelfManaged e o parâmetro --version definido como 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

Verificar a versão atual

  • Verifique qual versão está atualmente instalada em um membro usando o comando az appnet member show e consulte a propriedade Version na saída.

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

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

  • Verifique quais versões estão disponíveis para cada modo e a versão do Kubernetes em sua região usando o az appnet list-versions comando com o --location parâmetro definido como a região de interesse. Na saída, consulte a AvailableUpgrades coluna para ver quais versões estão 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 como a versão desejada para a qual atualizar.

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

Reverter para uma versão anterior

  • Reverta para uma versão instalada anteriormente usando o az appnet member update comando com o --version parâmetro definido como a versão desejada para a qual reverter. Lembre-se de que há suporte apenas para 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 gerenciado

No FullyManaged modo, a Rede de Aplicações Kubernetes do Azure gerencia automaticamente atualizações de versão para cada membro com base no canal de lançamento escolhido. Recomendamos esse modo se você preferir que a Rede de Aplicativos do Kubernetes no Azure lide com a avaliação de estabilidade da versão, o tempo de implementação e as atualizações contínuas sem intervenção manual.

Ao usar FullyManaged o modo de atualização, você escolhe um canal de lançamento que determina a rapidez com que os clusters membros adotam novas versões. A Rede de Aplicativos do Kubernetes do Azure monitora a preparação da versão e atualiza os membros de acordo com os critérios de estabilidade do canal.

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

  • Rápido: fornece a versão mais recente da Rede de Aplicativos assim que ela fica disponível. Esse canal destina-se a ambientes de validação iniciais ou não de produção em que o teste de novos recursos e funcionalidades é priorizado em relação ao tempo de validação estendido.
  • Estável: fornece versões que concluíram a validação e o teste adicionais. Esse canal destina-se a ambientes de produção e normalmente se alinha com a versão N-1secundária, garantindo maior confiabilidade e resolvendo quaisquer problemas identificados em versões anteriores.

Quando o modo FullyManaged é selecionado, você pode especificar o canal de lançamento para stable ou rapid. Se omitido, o canal padrão será stable.

Importante

No modo FullyManaged, a Rede de Aplicativos Kubernetes do Azure aplica automaticamente atualizações conforme novas versões são promovidas por meio de canais de lançamento. Não há suporte para controle manual de tempo de atualização ou seleção de versão.

Verificar as versões de atualização disponíveis para o modo totalmente gerenciado

  • Verifique a qual versão cada canal corresponde para uma determinada região e versão do Kubernetes, usando o comando az appnet list-versions e grep para o modo FullyManaged.

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

Inscrever-se no modo totalmente gerenciado e selecionar o canal de lançamento durante a entrada do membro

  • Registre-se no modo FullyManaged e selecione um canal de lançamento durante a entrada do membro usando o comando az appnet member join com o parâmetro --upgrade-mode FullyManaged e o parâmetro --release-channel definido como o canal desejado. O exemplo a seguir mostra como selecionar o canal Rapid durante a entrada de membro:

    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

Atualizar seleção de canal de distribuição

Você pode atualizar sua versão selecionada a qualquer momento. Todas as alterações no canal de lançamento entrarão em vigor imediatamente.

  • Atualize a seleção do canal de lançamento para um membro existente usando o comando az appnet member update com o parâmetro --release-channel definido para o canal desejado. O exemplo a seguir mostra como alternar 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 Rede de Aplicativos kubernetes do Azure, confira os seguintes artigos:

  • Last updated on