Pular para o conteúdo

Publicação

O site público é gerado de novo a cada mudança no conteúdo. Essa geração é a publicação. A tela Publicação mostra o estado do site, a fila de pedidos e o log de cada um.

Tela Publicação com o estado do site, a fila com um pedido falhado e um publicado

Captura de desenvolvimento: os motivos, os horários e os nomes da fila vêm de dados de exemplo, não de publicações reais.

O cartão Estado do site resume a última situação:

Texto no cartãoQuer dizer
No arO último pedido foi publicado.
Na fila para publicarO pedido mais recente ainda espera a vez.
Gerando o site…Uma publicação está em andamento.
Falhou — o site anterior continua no arO último pedido falhou. O site visível é o da publicação anterior.
Ainda não publicadoNenhum pedido foi feito.

Ele também mostra a data da Última publicação concluída, o número de Páginas (posts e páginas fixas) e o Destino, que é o endereço do site.

Para gerar o site agora, clique em Republicar o site. O pedido entra na fila com o motivo Republicação manual, e a tela mostra Publicação pedida.. O mesmo aviso aparece depois de Tentar de novo.

Você não precisa pedir uma publicação depois de salvar. O painel pede uma sempre que uma mudança aparece no site. Os motivos aparecem na coluna Pedido:

  • Configurações do site alteradas e Menus do site alterados, quando você muda as configurações ou os menus.
  • Perfil de autor alterado: <nome>, quando o perfil de um autor que aparece no site muda.
  • Módulos ativados ou desativados, e Configuração do módulo <módulo> alterada, quando um módulo muda.
  • Um registro de conteúdo, na forma <tipo>: <título> (<situação>), como Post: Título (publicado). A situação pode ser novo, alterado, excluído ou o estado para o qual o registro foi movido.
  • Restauração de backup, quando um backup é restaurado (veja Backup).

Se várias mudanças acontecem enquanto outro pedido ainda espera na fila, elas viram um pedido só. Um pedido que já está sendo gerado não é alterado: a mudança entra num pedido novo, que roda depois.

A tabela Fila de publicações mostra os últimos 20 pedidos, do mais recente para o mais antigo:

ColunaO que mostra
PedidoO motivo do pedido.
OrigemQuem pediu. Quando o próprio painel pediu, aparece Sistema.
EstadoNa fila, Gerando, Publicado ou Falhou.
InícioQuando a geração começou (ou quando o pedido entrou na fila).
DuraçãoQuanto tempo a geração levou.

Quando não há pedidos, a tabela mostra Nenhuma publicação pedida e a orientação de usar Republicar o site.

Em cada linha, clique em Ver log. Uma aba lateral abre com o título Log: Motivo do pedido, o Estado, quem pediu (Pedido por), a Duração e a saída do build.

O build tem quatro etapas, que aparecem no início do log:

  1. [1/4] Copiando o projeto para a área de build
  2. [2/4] Exportando o conteúdo publicado
  3. [3/4] bun run build
  4. [4/4] Publicando o dist/ novo

Quando a publicação dá certo, o log termina com Site publicado.. O log guarda as últimas 400 linhas da saída do build. Se houve mais, a primeira delas diz quantas foram omitidas.

Uma publicação falha quando:

  • o build termina com erro, e o log mostra O build saiu com código <número>.;
  • o build passa de 5 minutos, e o log mostra O build passou do prazo de 5 min e foi encerrado.;
  • o painel cai ou é encerrado à força durante a geração, sem o desligamento normal. Na próxima subida, o pedido aparece como Falhou, com Interrompido pelo reinício. no log, e um pedido igual entra na fila para rodar de novo.

Em qualquer falha, o site anterior continua no ar. A nova versão só substitui a antiga quando o build termina com sucesso. O log traz a linha Falha: <motivo>, e a aba lateral mostra O site anterior continua no ar.

Para resolver:

  1. Clique em Ver log no pedido falhado e leia as últimas linhas, onde o erro aparece.
  2. Leia o erro e corrija a causa antes de tentar de novo.
  3. Clique em Tentar de novo na aba lateral. O pedido é refeito com o mesmo motivo.

Enquanto a última publicação estiver falhada, a Visão geral mostra o aviso A última publicação falhou: o site anterior continua no ar., com o link Ver a publicação. O aviso só aparece para quem pode publicar, e some quando a publicação seguinte termina bem.

Se o painel for desligado normalmente no meio de uma geração, o pedido não conta como falha: ele volta para a fila e roda no próximo início.

Para quem implanta ou estende: as rotas desta tela.

MétodoCaminhoDonoTítuloPermissãoSem sessão
GET /painel/publicacao core Publicação core.publish Não
POST /painel/publicacao/republicar core Publicação core.publish Não
POST /painel/publicacao/:id/repetir core Publicação core.publish Não