Implantar um contêiner do Windows Server em um cluster AKS (Serviço de Kubernetes do Azure) usando o PowerShell

O AKS (Serviço de Kubernetes do Azure) é um serviço de Kubernetes gerenciado que permite implantar e gerenciar clusters rapidamente. Neste artigo, você usará Azure PowerShell para implantar um cluster do AKS que executa contêineres do Windows Server. Também implanta um aplicativo de exemplo do ASP.NET em um contêiner do Windows Server para o cluster.

Antes de começar

Este guia de início rápido pressupõe uma compreensão básica dos conceitos do Kubernetes. Para obter mais informações, confira Principais conceitos do Kubernetes para o AKS (Serviço de Kubernetes do Azure).

• Se você ainda não tiver uma conta do Azure, crie uma conta gratuita antes de começar.

• Para facilitar o uso, experimente o ambiente do PowerShell no Azure Cloud Shell. Para obter mais informações, consulte Início Rápido para Azure Cloud Shell.

  Se você deseja usar o PowerShell localmente, instale o módulo Az PowerShell e conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount. Execute os comandos com privilégios administrativos. Para obter mais informações, consulte Instalar o Azure PowerShell.

• Certifique-se de que a identidade que você está usando para criar seu cluster tenha as permissões mínimas apropriadas. Para obter mais detalhes sobre acesso e identidade do AKS, consulte Opções de acesso e identidade para o AKS (Serviço de Kubernetes do Azure).

• Se você tiver mais de uma assinatura do Azure, defina a assinatura que deseja usar para o início rápido chamando o cmdlet Set-AzContext. Para obter mais informações, confira Gerenciar as assinaturas do Azure com o Azure PowerShell.

• Se você estiver usando osSku Windows2025, será necessário instalar a aks-preview extensão e registrar o sinalizador de visualização.

• Especificar o parâmetro OsSKU requer o módulo PowerShell Az versão 9.2.0 ou superior.

Instalar a aks-preview extensão

1. Instale a extensão aks-preview da CLI do Azure usando o comando az extension add.

az extension add --name aks-preview

1. Atualize para a última versão da extensão usando o comando az extension update. O Windows Server 2025 requer um mínimo de 18.0.0b40.

az extension update --name aks-preview

Registrar o sinalizador de recurso AksWindows2025Preview

1. Registre o sinalizador do recurso AksWindows2025Preview usando o comando [az feature register][az-feature-register].

az feature register --name AksWindows2025Preview --namespace Microsoft.ContainerService

1. Verifique o status do registro usando o comando [az feature show][az-feature-show]. Demora alguns minutos para o status mostrar Registrado.

az feature show --name AksWindows2025Preview --namespace Microsoft.ContainerService

1. Quando o status refletir Registrado, atualize o registro do provedor do recurso Microsoft.ContainerService usando o comando [az provider register][az-provider-register].

   az provider register --namespace Microsoft.ContainerService
   

Criar um grupo de recursos

Um grupo de recursos do Azure é um grupo lógico no qual os recursos do Azure são implantados e gerenciados. Ao criar um grupo de recursos, você é solicitado a especificar um local. Essa é a localização na qual os metadados do grupo de recursos são armazenados e na qual os recursos são executados no Azure, caso você não especifique outra região durante a criação de recursos.

• Crie um grupo de recursos usando o cmdlet New-AzResourceGroup. O exemplo a seguir cria um grupo de recursos chamado myResourceGroup na região eastus.

  New-AzResourceGroup -Name myResourceGroup -Location eastus
  

  A saída de exemplo a seguir mostra que o grupo de recursos foi criado com êxito:

  ResourceGroupName : myResourceGroup
  Location          : eastus
  ProvisioningState : Succeeded
  Tags              :
  ResourceId        : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup
  

Criar um cluster AKS

Nesta seção, criamos um cluster do AKS com a seguinte configuração:

• O cluster é configurado com dois nós para garantir que ele opere de forma confiável. Um nó é uma máquina virtual (VM) do Azure que executa os componentes do nó do Kubernetes e o runtime do contêiner.
• Os parâmetros -WindowsProfileAdminUserName e -WindowsProfileAdminUserPassword definem as credenciais de administrador para qualquer nó do Windows Server no cluster e devem atender aos Requisitos de complexidade de senha do Windows Server.
• O pool de nós usa VirtualMachineScaleSets.

Use as seguintes etapas para criar o cluster do AKS com o Azure PowerShell:

1. Crie as credenciais de administrador para seus contêineres do Windows Server usando o comando a seguir. Esse comando solicita que você insira um WindowsProfileAdminUserName e WindowsProfileAdminUserPassword. A senha deve ter no mínimo 14 caracteres e atender aos requisitos de complexidade de senha do Windows Server.

   $AdminCreds = Get-Credential `
       -Message 'Please create the administrator credentials for your Windows Server containers'
   

2. Crie seu cluster usando o cmdlet New-AzAksCluster e especifique os parâmetros WindowsProfileAdminUserName e WindowsProfileAdminUserPassword.

   New-AzAksCluster -ResourceGroupName myResourceGroup `
       -Name myAKSCluster `
       -NodeCount 2 `
       -NetworkPlugin azure `
       -NodeVmSetType VirtualMachineScaleSets `
       -WindowsProfileAdminUserName $AdminCreds.UserName `
       -WindowsProfileAdminUserPassword $secureString `
       -GenerateSshKey
   

   Após alguns minutos, o comando será concluído e retornará informações no formato JSON sobre o cluster. Ocasionalmente, o cluster pode levar mais de alguns minutos para ser provisionado. Aguarde até 10 minutos para o provisionamento.

   Se você receber um erro de validação de senha e a senha definida atender aos requisitos de comprimento e complexidade, tente criar seu grupo de recursos em outra região. Em seguida, tente criar o cluster com o novo grupo de recursos.

   Se você não especificar um nome de usuário e senha de administrador ao criar o pool de nós, o nome de usuário será definido como azureuser e a senha será definida como um valor aleatório. Para obter mais informações, veja as Perguntas frequentes do Windows Server.

   O nome de usuário do administrador não pode ser alterado, mas você pode alterar a senha de administrador que o cluster do AKS usa para nós do Windows Server usando az aks update. Para obter mais informações, veja as Perguntas frequentes do Windows Server.

   Para executar um cluster AKS que dá suporte aos pools de nós para contêineres do Windows Server, o cluster precisa usar uma política de rede que usa o plug-in de rede CNI do Azure (avançado). O parâmetro -NetworkPlugin azure especifica a CNI do Azure.

Adicionar um pool de nós

Por padrão, um cluster AKS é criado com um pool de nós que pode executar contêineres do Linux. Você deve adicionar outro pool de nós que possa executar contêineres do Windows Server junto com o pool de nós do Linux.

Para criar um pool de nós do Windows, você precisa especificar um suporte OsType e OsSku. Use as informações na tabela a seguir para determinar qual é apropriado para o cluster:

O Windows Server 2022 é o sistema operacional padrão para versões do Kubernetes 1.25-1.35. O Windows Server 2019 é o sistema operacional padrão para versões anteriores. Se você não especificar um SKU do sistema operacional específico, o Azure criará o novo pool de nós com a SKU padrão para a versão do Kubernetes usada pelo cluster.

• Adicione um pool de nós do Windows Server usando o New-AzAksNodePool cmdlet. O comando a seguir cria um pool de nós chamado npwin e o adiciona ao myAKSCluster. O comando acima também usa a sub-rede padrão na VNet padrão criada durante a execução de New-AzAksCluster:

  New-AzAksNodePool -ResourceGroupName myResourceGroup `
      -ClusterName myAKSCluster `
      -VmSetType VirtualMachineScaleSets `
      -OsType Windows `
      -OsSKU Windows2022 `
      -Name npwin
  

Conectar-se ao cluster

Para gerenciar um cluster do Kubernetes, use o kubectl, o cliente de linha de comando do Kubernetes. Se você usar o Azure Cloud Shell, o kubectl já estará instalado. Se você instalar o kubectl localmente, poderá usar o cmdlet Install-AzAzAksCliTool.

1. Configure kubectl para se conectar ao cluster do Kubernetes usando o cmdlet Import-AzAksCredential. Este comando baixa as credenciais e configura a CLI do Kubernetes para usá-las.

   Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster
   

2. Verifique a conexão com seu cluster usando o comando kubectl get, que retorna uma lista de nós de cluster.

   kubectl get nodes
   

   O exemplo de saída a seguir mostra todos os nodos no cluster. Verifique se o status de todos os nós é Pronto:

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-nodepool1-20786768-vmss000000   Ready    agent   22h   v1.27.7
   aks-nodepool1-20786768-vmss000001   Ready    agent   22h   v1.27.7
   aksnpwin000000                      Ready    agent   21h   v1.27.7
   

Implantar o aplicativo

Um arquivo de manifesto do Kubernetes define um estado desejado para o cluster, como as imagens de contêiner a serem executadas. Neste artigo, você usa um manifesto para criar todos os objetos necessários para executar o aplicativo de exemplo ASP.NET em um contêiner do Windows Server. Esse manifesto inclui uma implantação do Kubernetes para o aplicativo de exemplo ASP.NET e um serviço do Kubernetes externo para acessar ao aplicativo da Internet.

O aplicativo de exemplo ASP.NET é fornecido como parte das Amostras .NET Framework e é executado em um contêiner do Windows Server. O AKS requer que os contêineres do Windows Server sejam baseados em imagens do Windows Server 2019 ou posterior. O arquivo de manifesto Kubernetes também deve definir um seletor de nó para instruir o cluster AKS a executar o pod de seu aplicativo de exemplo ASP.NET em um nó que possa executar contêineres do Windows Server.

1. Crie um arquivo nomeado sample.yaml e copie na seguinte definição yaml:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: sample
     labels:
       app: sample
   spec:
     replicas: 1
     template:
       metadata:
         name: sample
         labels:
           app: sample
       spec:
         nodeSelector:
           "kubernetes.io/os": windows
         containers:
         - name: sample
           image: mcr.microsoft.com/dotnet/framework/samples:aspnetapp
           resources:
             limits:
               cpu: 1
               memory: 800M
           ports:
             - containerPort: 80
     selector:
       matchLabels:
         app: sample
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: sample
   spec:
     type: LoadBalancer
     ports:
     - protocol: TCP
       port: 80
     selector:
       app: sample
   

   Para obter um detalhamento dos arquivos de manifesto YAML, confira Implantações e manifestos YAML.

   Se você criar e salvar o arquivo YAML localmente, poderá carregar o arquivo de manifesto no diretório padrão no CloudShell selecionando o botão Carregar/Baixar arquivos e selecionando o arquivo no sistema de arquivos local.

2. Implante o aplicativo usando o comando kubectl apply e especifique o nome do manifesto YAML.

   kubectl apply -f sample.yaml
   

   A saída de exemplo a seguir mostra a implantação e o serviço criados com êxito:

   deployment.apps/sample created
   service/sample created
   

Testar o aplicativo

Quando o aplicativo é executado, um serviço de Kubernetes expõe o front-end do aplicativo à Internet. A conclusão desse processo pode levar alguns minutos. Ocasionalmente, o serviço pode levar mais do que alguns minutos para ser provisionado. Aguarde até 10 minutos para o provisionamento.

1. Verifique o status dos pods implantados usando o comando kubectl get pods. Faça com que todos os pods estejam Running antes de continuar.

   kubectl get pods
   

2. Monitore o andamento usando o comando kubectl get service com o argumento --watch.

   kubectl get service sample --watch
   

   Inicialmente, a saída mostra o EXTERNAL-IP para o serviço de exemplo como pendente:

   NAME               TYPE           CLUSTER-IP   EXTERNAL-IP   PORT(S)        AGE
   sample             LoadBalancer   10.0.37.27   <pending>     80:30572/TCP   6s
   

3. Quando o endereço EXTERNAL-IP for alterado de pendente para um endereço IP público real, use CTRL-C para interromper o processo de inspeção do kubectl.

   A seguinte saída de exemplo mostra um endereço IP público válido atribuído ao serviço:

   sample  LoadBalancer   10.0.37.27   52.179.23.131   80:30572/TCP   2m
   

4. Para ver o aplicativo de exemplo em ação, abra um navegador da Web no endereço IP externo do seu serviço.

   

Excluir recursos

Se você não planeja passar pelo tutorial do AKS, exclua o cluster para evitar incorrer em encargos do Azure.

• Remova o grupo de recursos, o serviço de contêiner e todos os recursos relacionados usando o Remove-AzResourceGroup cmdlet.

  Remove-AzResourceGroup -Name myResourceGroup
  

  Observação

  O cluster do AKS foi criado com uma identidade gerenciada atribuída pelo sistema (a opção de identidade padrão neste início rápido). A plataforma do Azure gerencia essa identidade, portanto, ela não requer remoção.

Próximas etapas

Neste início rápido, você implantou um cluster Kubernetes e implantou um aplicativo de amostra ASP.NET em um contêiner do Windows Server para ele. Esse aplicativo de exemplo é apenas para fins de demonstração e não representa todas as melhores práticas para aplicativos do Kubernetes. Para obter diretrizes sobre como criar soluções completas com o AKS para produção, consulte Diretrizes sobre a solução AKS.

Para saber mais sobre o AKS e para percorrer um exemplo completo de código para implantação, continue no tutorial do cluster Kubernetes.