Solução de problemas

Diagnostique e corrija problemas comuns: uma página por família de sintomas, escrita de forma que a solução fique ao alcance sem precisar ler o resto da documentação antes.

Nesta seção

• Falhas de build: promoção bloqueada, erros de renderização, timeouts e rajadas de orçamento de escrita; onde ficam o texto do motivo e o controle "promote anyway".
• CSS bloqueado (SRI): quando a área admin se recusa a carregar a folha de estilo e por que o hash de integridade é derivado do conteúdo.
• Conflitos de portas: qual porta pertence a qual camada, quem a detém e como movê-la de forma limpa.
• Problemas de login e autenticação: bloqueios, expiração, suspensões, revogação de sessão.
• Redirecionamentos e 404s: por que um site estático dá 404 onde o CMS responderia, e as regras dos formatos de redirecionamento.
• FAQ: o compêndio de perguntas frequentes (senhas, builds, bloqueios, chaves de API, configuração inicial).

O hábito que resolve a maior parte

Duas superfícies respondem à maioria das perguntas antes de caçar sintomas:

• O histórico de builds (Builds no admin): as últimas 100 execuções com motivos por verificação, saída capturada e o texto exato de recusa dos promotes bloqueados.
• O journal (journalctl -u chinaski@<N>): toda mensagem de nível de serviço, incluindo bloqueios de login, falhas de deploy e resultados de webhooks.

/health (múltiplas verificações com detalhes por verificação) e /api/health (resumo para monitores) fecham o ciclo: quando nenhuma das duas reporta saúde, o problema é de infraestrutura, não de conteúdo.