Ir para o artigo
Deploy e desenvolvimento

Como publicar um site Astro no painel WordPane

Do build ao domínio: publique um site Astro na WordPane, configure a pasta pública e prepare atualizações por Git sem confundir estático com SSR.

Capa do artigo: Como publicar um site Astro no painel WordPane — WordPane Cloud
Compartilhe este guia
WhatsApp (abre em nova aba)LinkedIn (abre em nova aba)Facebook (abre em nova aba)

Resposta direta

Um site Astro pré-renderizado pode ser publicado como arquivos estáticos: gere o build e envie o conteúdo de dist ao webroot. Se o projeto renderiza páginas sob demanda, é necessário um adapter, um runtime compatível e um processo de produção. A escolha depende das funcionalidades usadas, não apenas do framework.

Astro é uma opção para sites institucionais, blogs, documentação e páginas de produto. Ele também combina bem com um fluxo em que a IA ajuda a escrever componentes e conteúdo. Mas terminar a interface no computador não conclui a publicação: você precisa transformar o projeto em arquivos de produção, colocá-los no diretório correto e testar o endereço real. Este guia apresenta um caminho estático verificável no painel WordPane e explica o que muda quando existe processamento no servidor.

Visão do processo
  1. Código e conteúdo
  2. Build reproduzível
  3. Arquivos no webroot
  4. Domínio e testes

Antes de começar: identifique a saída do projeto

Abra o repositório e confira o package.json, o arquivo de configuração do Astro e as integrações usadas. O caso mais simples é um site totalmente pré-renderizado. Nesse cenário, o build produz arquivos que um servidor web pode entregar, sem manter o processo de desenvolvimento do Astro funcionando. A documentação oficial de deploy indica dist como diretório padrão de saída.

Se o projeto usa endpoints dinâmicos, sessões ou renderização sob demanda, ele pode exigir um adapter e um runtime. Não tente publicar apenas a interface e esperar que a autenticação ou a API apareçam automaticamente. Anote também serviços externos, variáveis, domínio, formulários e o destino dos dados enviados. Essa lista define o ambiente e as tarefas de validação.

Gere e confira a versão de produção

Execute os comandos a seguir na pasta do projeto. O exemplo pressupõe npm e package-lock.json versionado; se você usa outro gerenciador, mantenha o gerenciador e o lockfile do projeto. Confira a versão Node exigida pela sua versão do Astro. Pare se a instalação ou o build falhar e corrija o erro antes de enviar arquivos.

Use a prévia local para verificar as páginas e o resultado do build. A prévia serve para conferência, não como serviço permanente de produção. Abra uma página interna diretamente, examine as imagens e teste o formulário. Confira se a URL pública e a canônica apontam para seu domínio, em vez do endereço localhost.

No computador de desenvolvimento ou no ambiente de build
npm ci
npm run build
npm run preview

Prepare a aplicação no painel

Na área do cliente, escolha a infraestrutura compatível e aguarde a conclusão da configuração do servidor. Para um site estático, avalie um ambiente web que permita servir os arquivos do projeto. Você não precisa contratar um runtime Node apenas porque o Astro usa Node durante o build. A geração pode acontecer no seu computador ou em uma automação de CI.

O caminho observado no painel é Applications → Create an Application → Custom. Os campos de versão PHP desse formulário pertencem à aplicação personalizada PHP; eles não transformam o Astro em PHP. O uso relevante para o site estático é preparar domínio, usuário e diretório público que servirá os arquivos. Confira esse comportamento na stack escolhida.

  1. Informe Application Name e selecione Primary Domain ou Test Domain.
  2. Para domínio próprio, informe o endereço e revise a opção de SSL; o DNS precisa apontar para o destino correto.
  3. Escolha Custom e revise System User em Show Advance Options.
  4. Confira Custom Webroot. O destino deve corresponder à pasta que receberá o conteúdo gerado, não ao diretório de código-fonte.
  5. Crie a aplicação e confira o caminho no File Manager antes de enviar o build.

Envie o conteúdo de dist para o webroot

No File Manager da aplicação, confirme o breadcrumb e o caminho. O webroot observado em nossa documentação é public_html; um projeto com Custom Webroot pode usar outro destino. Envie o conteúdo interno de dist para essa pasta, preservando subpastas e nomes. Se você colocar a pasta dist inteira dentro de public_html, o index.html pode ficar um nível abaixo do que o servidor procura.

Use File Manager ou SFTP com o usuário correto. Mantenha uma cópia do site anterior antes de substituir arquivos. Não envie .env, .git, arquivos de credenciais ou dependências do ambiente de desenvolvimento para a pasta pública. Para futuras atualizações, publique o build completo de forma consistente: HTML novo com assets antigos, ou o contrário, pode quebrar a página.

Integre o Git sem pular a etapa de build

A integração Git permite vincular conta, repositório e branch à aplicação que disponibiliza esse recurso. Ela não significa, por si só, que todo projeto terá dependências instaladas e build executado. Na documentação WordPane, a aplicação criada pelo método Git oferece opções próprias de atualização; não há um campo de build universal confirmado para todas as stacks.

Você pode gerar os arquivos em uma rotina externa e publicar os artefatos, ou executar um procedimento de build no ambiente que tenha runtime, permissões e recursos necessários. Documente qual método sua equipe adotou. Só habilite atualização automática depois de provar que um commit produz os arquivos finais no webroot e que existe uma forma de recuperar a versão anterior.

O que muda com Astro e SSR

Para renderização no servidor, consulte o adapter Node oficial e a documentação correspondente à versão do projeto. Essa arquitetura precisa de um processo de produção, configuração de execução e proxy. O ambiente Node.js da WordPane está em beta; confira versão, comando, porta, variáveis e controles disponíveis antes da contratação.

Não copie o formulário PHP como se fosse o formulário Node. Se a aplicação depende de um runtime de edge ou de um serviço específico de outro provedor, prepare a adaptação. A hospedagem do código na VPS não reproduz automaticamente serviços de Vercel ou Cloudflare. Para esse caso, envie os requisitos e o comando de produção à equipe antes de seguir.

Valide o domínio e resolva as falhas mais comuns

  • Página inicial funciona, mas uma rota retorna 404: confira a saída do build, as regras de URL e a estrutura de pastas.
  • CSS ou imagens falham: confira o caminho base e se os assets gerados foram publicados junto do HTML.
  • Formulário não envia: verifique o endpoint real e o backend responsável; HTML estático não processa mensagens sozinho.
  • Uma alteração não aparece: confirme branch, build, diretório de destino e cache do navegador.
  • SSL não conclui: confira o DNS e a configuração do domínio antes de repetir a emissão.
  • Antes de divulgar, teste menu, páginas internas, metadados sociais e o cadastro que seu projeto oferece.

Um exemplo: blog estático com formulário externo

Considere um blog em que as páginas são geradas no build e o formulário envia dados a uma API separada. O servidor do blog precisa entregar HTML, CSS, JavaScript e imagens; a API precisa validar os campos, limitar abuso e tratar o envio. Publicar o blog corretamente não demonstra que o formulário está funcionando.

Nesse desenho, uma atualização editorial exige gerar e publicar um novo build. Se o conteúdo vier de um CMS, defina quem dispara essa geração e como reconhecer uma falha. O site continuará mostrando a versão anterior até que o novo artefato seja publicado; isso é parte do fluxo editorial escolhido, não um defeito do DNS.

Faça a publicação como um release, não como uma cópia improvisada

Guarde o commit de origem, a versão Node, o lockfile e o resultado do build. Prepare todos os arquivos antes de substituir a versão pública. Uma atualização parcial pode deixar o HTML apontando para arquivos com hash que ainda não chegaram ao servidor.

Quando a infraestrutura permitir uma troca de diretório ou de release de forma controlada, use esse mecanismo. Caso a publicação seja por envio de arquivos, planeje a ordem, preserve assets ainda usados e mantenha uma cópia recuperável. Não remova arquivos antigos por nome ou data sem verificar se continuam referenciados.

  • Abra diretamente uma URL interna, sem navegar antes pela home.
  • Confira canonical, sitemap, robots e a URL da imagem social.
  • Teste um endereço inexistente e verifique se a resposta HTTP é realmente 404.
  • Envie uma mensagem de teste e confirme seu recebimento no destino.
  • Simule a restauração do release anterior antes de automatizar atualizações.

Como analisar velocidade sem atribuir tudo ao framework

A saída estática elimina processamento de renderização a cada visita, mas não impede imagens grandes, scripts de terceiros ou fontes que atrasam a página. Meça a página publicada em condições comparáveis e observe o elemento que determina o LCP, o peso transferido e a estabilidade visual.

Em uma home com uma ilustração importante, dimensões explícitas e uma imagem bem dimensionada podem valer mais que alterar o servidor. Já uma API lenta exige investigar seu próprio processamento. Separe a medição da página estática da medição dos serviços que ela consome.

Onde a WordPane agrega à rotina

A plataforma reúne a criação ou conexão do servidor, acompanhamento de operações e consumo na área do cliente. No painel de controle, você encontra ferramentas para domínio, arquivos, integração Git, logs e backup conforme o ambiente configurado. Isso organiza tarefas que continuariam existindo mesmo quando a IA produz boa parte do código.

A cobrança por hora permite acompanhar o consumo do ambiente no saldo. O custo da infraestrutura é separado de modelos de IA, APIs e serviços externos usados pelo projeto. Comece com uma publicação de teste, registre os passos que funcionaram e escolha os recursos com base no comportamento observado. O primeiro resultado útil é um site acessível, atualizável e recuperável.

Escolha o ambiente do projeto

Compare os planos ou envie os requisitos da aplicação para a equipe WordPane.

Configurar meu projeto na WordPaneConsultar a documentação do painel

Referências para aprofundar