Quando você envia um Job ao Kubernetes e os Pods não aparecem, isso nem sempre é um erro. Em um cluster que usa o Kueue, o sistema pode estar apenas decidindo se o Job pode usar os recursos pedidos. Por isso, a primeira pergunta útil é se o Kueue já admitiu a carga de trabalho, chamada de Workload, e não apenas por que o Pod está pendente.

O plugin do Kueue para o Headlamp, na versão alpha 0.1.0-alpha, mostra essa investigação na própria interface. Em vez de juntar informações de vários comandos e arquivos YAML grandes, você começa pelo Workload, lê a mensagem de condição e segue os links até a LocalQueue, a ClusterQueue, o ResourceFlavor e o Cohort. Essa versão é somente de leitura: não cria, edita, pausa, retoma nem apaga recursos.

O Kueue e o agendador do Kubernetes respondem a perguntas diferentes. O Kueue decide se a carga pode começar agora, considerando políticas de fila, cota, ResourceFlavors, verificações de admissão e outros Workloads em espera. Já o agendador decide, depois da admissão, em quais nós os Pods podem rodar. Se o Workload não foi admitido, a investigação fica na seção do Kueue. Se foi admitido e os Pods continuam pendentes, o caminho é olhar as telas normais de Job e Pod, com os eventos do agendador.

No exemplo da fonte, o Workload pedia três Pods e três CPUs no total, com 600 MiB de memória. A condição indicava que o Kueue não conseguiu atribuir um ResourceFlavor por falta de cota de CPU na ClusterQueue. A LocalQueue estava ativa e apontava para a ClusterQueue esperada, que oferecia apenas duas CPUs e duas vagas de Pod. Assim, o Job continuava suspenso até a cota ficar disponível ou a configuração mudar.

A fonte também explica que, se a admissão já ocorreu, mas a aplicação não roda, deve-se seguir para Jobs e Pods no Headlamp, verificando eventos como falta de capacidade nos nós, regras de afinidade, taints e tolerations, vínculo de volumes persistentes ou falhas ao baixar imagens. O plugin não substitui o kubectl ou o kueuectl para scripts e mudanças, mas facilita a navegação interativa durante a investigação.