Partilhar via

Usar o Canal Anual do Windows para contêineres no Serviço Kubernetes do Azure (AKS) (Visualização)

  • Artigo

O AKS suporta o Canal Anual do Windows Server para Contêineres na visualização pública. Cada versão do canal é lançada anualmente e é suportada por dois anos. Este 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 suporte a próxima versão do Canal Anual.

Importante

Os recursos de visualização do AKS estão disponíveis em uma base de autosserviço e opt-in. 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 visualizações do AKS são parcialmente cobertas pelo suporte ao cliente com base no melhor esforço. Como tal, estas funcionalidades não se destinam a utilização em produção. Para obter mais informações, consulte os seguintes artigos de suporte:

Versões anuais do canal suportadas

O AKS lança suporte para novas versões do Windows Server Annual Channel for Containers em alinhamento com as versões do Kubernetes. Para obter as atualizações mais recentes, consulte as notas de versão do AKS. A tabela a seguir fornece um cronograma de lançamento estimado para os próximos lançamentos anuais do Canal:

Versão K8s Versão anual do canal (host) Imagem de contêiner suportada Data de fim do suporte
1.28 23H2 (apenas pré-visualização) Windows Server 2022 Fim do suporte 1.30
1.31 24H2 Windows Server 2022 & Windows Server 2025 Fim do suporte 1.34
1.35 25H2 Windows Server 2025 Fim do suporte 1.38

Canal Anual do Windows vs. Versões do Canal de Manutenção de Longo Prazo (LTSC)

O AKS suporta LTSC (Long Term Servicing Channel Releases), incluindo Windows Server 2022 e Windows Server 2019. Eles vêm de um canal de lançamento diferente do Canal Anual do Windows Server para Contêineres. Para ver as nossas recomendações atuais, consulte a documentação de práticas recomendadas do Windows.

Nota

O Windows Server 2019 será aposentado após o Kubernetes versão 1.32 atingir o fim da vida útil e o Windows Server 2022 será aposentado depois que o Kubernetes versão 1.34 atingir o fim da vida útil. Para obter mais informações, consulte as notas de versão do AKS.

A tabela a seguir compara as versões do Canal Anual do Windows e do Canal de Manutenção de Longo Prazo:

Canal Suporte Atualizações
Canal de manutenção de longo prazo (LTSC) Os canais LTSC são lançados a cada três anos e são suportados por cinco anos. Este canal é recomendado para clientes que usam o Suporte de Longo Prazo. Para atualizar de uma versão para outra, você precisa migrar seus pools de nós para uma nova opção de SKU do sistema operacional e reconstruir suas imagens de contêiner com a nova versão do sistema operacional.
Canal Anual para Contentores Os lançamentos anuais do canal ocorrem anualmente e são suportados 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 az aks nodepool add comando. Executar az --version para localizar a versão. Se precisar de instalar ou atualizar, veja Install Azure CLI (Instalar o Azure CLI).

Limitações

  • O Canal Anual do Windows não suporta o Azure Network Policy Manager (NPM).

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

  • Registre ou atualize a extensão aks-preview usando o az extension add comando or 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 AKSWindowsAnnualPreview recurso

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

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

    Leva alguns minutos para que o status mostre Registrado.

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

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

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

    az provider register --namespace Microsoft.ContainerService

Usar 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 versão você obterá com base na versão do Kubernetes do seu pool de nós, consulte as versões do Canal Anual suportadas.

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 az aks nodepool add comando. 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

    Nota

    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 do cluster.

Verificar 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 kubectl describe node o comando.

    kubectl describe node $NODE_POOL_NAME

    Se você criou com êxito 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 LTSC para o Canal Anual do Windows seguindo as orientações em Atualizar a versão do sistema operacional para suas cargas de trabalho do Windows do Serviço Kubernetes do Azure (AKS).

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

Próximos passos

Para saber mais sobre os Contêineres do Windows no AKS, consulte os seguintes recursos:

Práticasrecomendadas do Windows Perguntas frequentes sobre o Windows