Capturar um arquivo de despejo de contêiner do Windows de um nó windows em um cluster do AKS

Se um contêiner do Windows falhar em um cluster do AKS (Microsoft Serviço de Kubernetes do Azure), talvez seja necessário examinar o arquivo de despejo de contêiner do Windows para investigar a causa raiz. Este artigo fornece etapas para capturar um arquivo de despejo de contêiner do Windows de um nó windows em um cluster do AKS. Ele também inclui instruções para baixar o arquivo de despejo no computador local para análise adicional.

Pré-requisitos

• Um cluster AKS. Se você não tiver um cluster do AKS, crie um usando a CLI do Azure ou por meio do portal do Azure.

• Pools de agentes do Windows criados após 3/13/2024 ou uma imagem de nó que foi atualizada para a versão 20240316 de imagem do Windows do AKS ou uma versão posterior. Como alternativa, verifique se a versão do WindowsCSEScriptsPackage é v0.0.39 ou mais recente, que pode estar localizada nos C:\AzureData\CustomDataSetupScript.log nós do Windows.

Etapa 1: adicionar metadados de anotações à sua implantação

Monte uma pasta host no contêiner e adicione os metadados de anotações para solicitar que o contêiner do Windows armazene o arquivo de despejo em uma pasta designada:

metadata:
  ...
  annotations:
    "io.microsoft.container.processdumplocation": "C:\\CrashDumps\\{container_id}"
    "io.microsoft.wcow.processdumptype": "mini"
    "io.microsoft.wcow.processdumpcount": "10"
spec:
  ...
  containers:
  - name: containername
    image: ...
    ...
    volumeMounts:
      - mountPath: C:\CrashDumps
        name: local-dumps
  volumes:
  - name: local-dumps
    hostPath:
      path: C:\k\containerdumps
      type: DirectoryOrCreate

Etapa 2: Reproduzir o problema

Reimplante sua implantação e aguarde a falha do contêiner do Windows. Você pode usar kubectl describe pod -n [POD-NAMESPACE] [POD-NAME] para saber qual nó do AKS Windows está hospedando o pod.

Etapa 3: Conectar-se ao nó Windows

Estabeleça uma conexão com o nó de cluster do AKS. Você autentica usando uma chave SSH (Secure Shell) ou a senha de administrador do Windows em uma conexão RDP (Protocolo de Área de Trabalho Remota). Ambos os métodos exigem que você crie uma conexão intermediária. Isso ocorre porque atualmente você não pode se conectar diretamente ao nó do AkS Windows. Se você se conectar a um nó por meio de SSH ou RDP, você precisa especificar o nome de usuário para os nós do AKS. Por padrão, esse nome de usuário é azureuser.

SSH

Se você tiver uma chave SSH, crie uma conexão SSH com o nó Windows. A chave SSH não persiste nos nós do AKS. A chave SSH reverte para o que foi inicialmente instalado no cluster durante qualquer uma das seguintes ações:

• Reiniciar
• Atualização de versão
• Atualização de imagem de nó

RDP

Se você não tiver uma chave SSH, conecte-se usando RDP e a senha de administrador do Windows. Se você não tiver essa senha para o cluster, redefina a senha na CLI do Azure executando o comando az aks update . Especifique o grupo de recursos, o nome do cluster e a nova senha. O comando exibe os detalhes do cluster após a conclusão:

az aks update \
    --resource-group <myResourceGroup> \
    --name <myAKSCluster> \
    --windows-admin-password "<myNewPassword>"

Use sua senha de administrador do Windows para se conectar ao nó usando RDP. Essa ação exige que você implante uma VM (máquina virtual de salto) que se conecta à mesma sub-rede à qual o cluster se conecta.

Redirecionar uma unidade de dados para a conexão RDP

Para transferir os arquivos de captura para o computador, você precisa redirecionar um disco rígido do computador para a VM criada e a conexão RDP com o nó do Windows AKS. Esse redirecionamento permite copiar os arquivos de captura gerados posteriormente para o computador.

1. Em seu computador, selecione Iniciar e, em seguida, pesquise e selecione Conexão de Área de Trabalho Remota.

2. Na caixa de diálogo Conexão da Área de Trabalho Remota , selecione Mostrar Opções.

   

3. Na guia Recursos Locais , selecione Mais.

   

4. Em uma nova caixa de diálogo Conexão da Área de Trabalho Remota , selecione Unidades para expandir a lista de unidades que estão no computador e selecione a unidade que você deseja redirecionar.

   

5. Conecte-se à VM do Windows que você configurou anteriormente.

Etapa 4: transferir o arquivo de despejo localmente

SSH

Depois que o contêiner falhar, identifique o pod auxiliar para que você possa copiar o arquivo de despejo localmente. Abra um segundo console e, em seguida, obtenha uma lista de pods executando o kubectl get pods comando, da seguinte maneira:

kubectl get pods
NAME                                                    READY   STATUS    RESTARTS   AGE
azure-vote-back-6c4dd64bdf-m4nk7                        1/1     Running   2          3d21h
azure-vote-front-85b4df594d-jhpzw                       1/1     Running   2          3d21h
node-debugger-aks-nodepool1-38878740-vmss000000-6ztp6   1/1     Running   0          3m58s

O pod auxiliar tem um prefixo de node-debugger-aks, conforme mostrado na terceira linha. Substitua o nome do pod e execute os seguintes comandos scp (Cópia Segura) para recuperar os arquivos de despejo (.dmp) salvos quando o contêiner falhar:

scp -o 'ProxyCommand ssh -p 2022 -W %h:%p azureuser@127.0.0.1' azureuser@10.240.0.97:/C:/k/containerdumps/{container_id}/{application}.dmp .

Você pode listar a C:\k\containerdumps pasta para encontrar o caminho completo dos arquivos de despejo depois que a conexão for feita com o nó Windows.

RDP

Para transferir os arquivos de despejo TCP do nó do Windows do AKS para a VM de salto, siga estas etapas:

1. Conecte-se ao nó do AkS Windows.

2. Execute o seguinte comando de uso líquido para mapear o recurso compartilhado da VM de salto para uma unidade chamada Z. Se o recurso compartilhado for algo diferente da unidade C, ajuste o comando.

   C:\Users\bookbinder>net use z: \\tsclient\c
   The command completed successfully.
   

3. Para copiar os arquivos de despejo para sua VM de salto, execute o seguinte comando de cópia:

   C:\Users\azureuser>copy C:\k\containerdumps\*\*.dmp z:\
   

4. End the connection from the jump VM to the AKS Windows nó. Os arquivos de despejo agora estão na unidade C da VM de salto.

Para copiar os arquivos de despejo da VM de salto para o computador, siga estas etapas:

1. Em Explorador de Arquivos na VM de salto, vá para o diretório raiz da unidade C.
2. Selecione os arquivos *.dmp.
3. Arraste os arquivos .dmp para a conexão chamada C no <myComputerName>.

Os arquivos de despejo agora estão no diretório raiz da unidade C em seu computador.

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.