44 Princípios gerais da solução de problemas #

Consultar os registros: os registros são a principal fonte de informações. Na maior parte das vezes, os erros são autoexplicativos e contêm dicas sobre o motivo da falha.

Verificar os relógios: as diferenças entre os relógios dos sistemas podem provocar diversos tipos de erros. Assegure a sincronização dos relógios. É possível instruir o EIB a forçar a sincronização dos relógios no momento da inicialização. Consulte Configurando a hora do sistema operacional (Capítulo 3, Clusters independentes com o Edge Image Builder).

Problemas na inicialização: se o sistema travar durante a inicialização, anote as últimas mensagens exibidas. Acesse o console (físico ou via BMC) para observar as mensagens de inicialização.

Problemas de rede: verifique a configuração da interface de rede (ip a) e a tabela de roteamento (ip route), teste a conectividade com outros nós e serviços externos (ping, nc) e garanta que as regras de firewall não bloqueiem as portas necessárias.

Verificar o status dos componentes: use kubectl get e kubectl describe para os recursos do Kubernetes. Use kubectl get events --sort-by='.lastTimestamp' -n <namespace> para ver os eventos em um determinado namespace do Kubernetes.

Verificar o status dos serviços: use systemctl status <serviço> para os serviços systemd.

Verificar a sintaxe: o software espera uma determinada estrutura e sintaxe nos arquivos de configuração. Para os arquivos yaml, por exemplo, use yamllint ou ferramentas similares para verificar a sintaxe adequada.

Isolar o problema: tente restringir o problema a um componente ou uma camada específica (por exemplo, rede, armazenamento, sistema operacional, Kubernetes, Metal³, Ironic etc.).

Documentação: consulte sempre a documentação oficial do SUSE Edge e também a documentação upstream para obter informações detalhadas.

Versões: o SUSE Edge é uma versão consistente e completamente testada de diferentes componentes SUSE. Consulte as versões de cada componente por lançamento do SUSE Edge na matriz de suporte do SUSE Edge.

Problemas conhecidos: para cada versão do SUSE Edge existe uma seção de "problemas conhecidos" nas Notas de lançamento, com informações dos problemas que serão corrigidos em versões futuras, mas que podem afetar a versão atual.