Compartilhar via

Usar o Canal Anual do Windows para Contêineres no AKS (Serviço de Kubernetes do Azure) (Versão prévia)

  • Artigo

O AKS dá suporte ao Canal Anual do Windows Server para Contêineres em visualização pública. Cada versão do canal é lançada anualmente e tem suporte para dois anos. Esse canal é benéfico se você precisar de maiores ciclos de inovação e portabilidade.

As versões do Canal Anual do Windows são baseadas na versão do Kubernetes do seu pool de nós. Para atualizar de uma versão do Canal Anual para a próxima, você pode atualizar para uma versão do Kubernetes que dê suporte a próxima versão do Canal Anual.

Importante

As versões prévias do recurso AKS estão disponíveis em uma base de autoatendimento e aceitação. As visualizações são fornecidas "como estão" e "conforme disponíveis" e estão excluídas dos acordos 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:

Lançamentos do Canal Atual com suporte

O AKS lança suporte para novos lançamentos do Canal Anual do Windows Server para Contêineres alinhados com as versões do Kubernetes. Para obter as atualizações mais recentes, confira as notas sobre a versão do AKS. A tabela a seguir fornece uma agenda de lançamento estimada para os próximos lançamentos do Canal Anual:

Versão do K8s Versão anual do Canal (host) Imagem de contêiner com suporte Data de fim do suporte
1.28 23H2 (somente versão prévia) Windows Server 2022 Fim do suporte de 1.30
1.31 24H2 Windows Server 2022 e Windows Server 2025 Fim do suporte de 1.34
1,35 25H2 Windows Server 2025 Fim do suporte de 1.38

Canal Anual do Windows vs. Laçamentos do LTSC (Canal de Manutenção em Longo Prazo)

O AKS dá suporte aos lançamentos do LTSC (Canal de Manutenção em Longo Prazo), incluindo o Windows Server 2022 e o Windows Server 2019. Eles vêm de um canal de lançamento diferente do Canal Anual do Windows Server para Contêineres. Para exibir nossas recomendações atuais, confira a documentação de melhores práticas do Windows.

Observação

O Windows Server 2019 será descontinuado depois que a versão 1.32 do Kubernetes chegar ao fim da vida útil, e o Windows Server 2022 será descontinuado depois que a versão 1.34 do Kubernetes chegar ao fim da vida útil. Para obter mais informações, confira as Notas sobre a versão do AKS.

A tabela a seguir compara os laçamentos do Canal Anual do Windows e do Canal de Manutenção em Longo Prazo:

Canal Suporte Atualizações
LTSC (Canal de Manutenção em Longo Prazo) Os canais LTSC são lançados a cada três anos e têm suporte por cinco anos. Esse canal é recomendado para clientes que usam suporte de longo prazo. Para atualizar de uma versão para a próxima, você precisa migrar seus pools de nós para uma nova opção de SKU do SO e recriar as imagens de contêiner com a nova versão do SO.
Canal Anual para Contêineres Os lançamentos do Canal Anual ocorrem anualmente e têm suporte por dois anos. Para atualizar para a versão mais recente, você pode atualizar a versão do Kubernetes do seu pool de nós.

Antes de começar

  • Você precisa da CLI do Azure versão 2.56.0 ou posterior instalada e configurada para definir os-sku como WindowsAnnual com o comando az aks nodepool add. Execute az --version para encontrar a versão. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.

Limitações

  • O Canal Anual do Windows não dá suporte ao NPM (Gerenciador de Políticas de Rede do Azure).

Instale a extensão aks-preview da CLI do Azure

  • Registre ou atualize a extensão aks-preview usando o comando az extension add ou az extension update.

    # Register the aks-preview extension
az extension add --name aks-preview
# Update the aks-preview extension
az extension update --name aks-preview

Registrar o sinalizador de recurso AKSWindowsAnnualPreview

  1. Registre o sinalizador de recurso AKSWindowsAnnualPreview usando o comando az feature register.

    az feature register --namespace "Microsoft.ContainerService" --name "AKSWindowsAnnualPreview"

    Demora alguns minutos para o status exibir Registrado.

  2. Verifique o status do registro usando o comando az feature show.

    az feature show --namespace "Microsoft.ContainerService" --name "AKSWindowsAnnualPreview"

  3. Quando o status reflete Registrado, atualize o registro do provedor de recursos Microsoft.ContainerService usando o comando az provider register.

    az provider register --namespace Microsoft.ContainerService

Use o Canal Anual do Windows para Contêineres no AKS

Para usar o Canal Anual do Windows no AKS, especifique os seguintes parâmetros:

  • os-type definido como Windows
  • os-sku definido como WindowsAnnual

As versões do Canal Anual do Windows são baseadas na versão do Kubernetes do seu pool de nós. Para verificar qual lançamento você obterá com base na versão do Kubernetes do seu pool de nós, confira os lançamentos do Canal Anual com suporte.

Criar um novo pool de nós do Canal Anual do Windows

  • Crie um pool de nós do Canal Anual do Windows usando o comando az aks nodepool add. O exemplo a seguir cria um pool de nós do Canal Anual do Windows com a versão 23H2:

    az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --os-type Windows \
    --os-sku WindowsAnnual \
    --kubernetes-version 1.29
    --name $NODE_POOL_NAME \
    --node-count 1

    Observação

    Se você não especificar a versão do Kubernetes durante a criação do pool de nós, o AKS usará a mesma versão do Kubernetes que seu cluster.

Verifique a criação do pool de nós do Canal Anual do Windows

  • Verifique a criação do pool de nós do Canal Anual do Windows verificando a SKU do sistema operacional do pool de nós usando o comando kubectl describe node.

    kubectl describe node $NODE_POOL_NAME

    Se você criou com sucesso um pool de nós do Canal Anual do Windows, deverá ver a seguinte saída:

    Name:               npwin
Roles:              agent
Labels:             agentpool=npwin
...
                    kubernetes.azure.com/os=windows
...
                    kubernetes.azure.com/node-image-version=AKSWindows-23H2-gen2
...
                    kubernetes.azure.com/os-sku=WindowsAnnual

Atualizar um pool de nós existente para o Canal Anual do Windows

Você pode atualizar um pool de nós existente de uma versão do LTSC para o Canal Anual do Windows seguindo as diretrizes em Atualizar a versão do sistema operacional para suas cargas de trabalho do Windows no AKS (Serviço de Kubernetes do Azure).

Para atualizar de uma versão do Canal Anual para a próxima, você pode atualizar para uma versão do Kubernetes que dê suporte a próxima versão do Canal Anual.

Próximas etapas

Para saber mais sobre os contêineres do Windows no AKS, confira os seguintes recursos:

Melhores práticas do WindowsPerguntas frequentes do Windows