Como instalar o Astro na Saplo (site rápido com islands)

Por predefinição, o Astro gera uma página totalmente estática - zero bytes de JavaScript no início - e permite-te inserir componentes interativos únicos (ilhas) do React, Vue ou Svelte exatamente onde a interação é realmente necessária. O resto da página permanece em HTML puro. O resultado são páginas de conteúdo e blogs que carregam instantaneamente mesmo com uma ligação fraca, sem o compromisso de um bundle pesado de framework para toda a página. Na Saplo, o Astro é configurado como qualquer outra aplicação estaticamente construída - o motor constrói o projeto e expõe o diretório pronto dist sob o nginx.

Para quem é o Astro na Saplo

Antes de começares a instalação, verifica se é a escolha certa para o teu projeto:

• blog ou site de conteúdo que precisa ser rápido - zero JavaScript desnecessário no início, o conteúdo carrega instantaneamente,
• documentação do produto - content collections em Markdown e static build são adequados para isso,
• portfólio ou landing page com um pouco de interação - um formulário de contacto ou galeria como uma ilha única de React ou Vue, sem hidratação de toda a página,
• site que hoje está no WordPress apenas porque alguém precisava de editar conteúdo - se a edição for feita através de ficheiros Markdown no repositório, o Astro oferece a mesma conveniência sem um motor PHP e base de dados em segundo plano.

Se o site for totalmente dinâmico (dados diferentes para cada consulta, login de utilizadores), verifica no Catálogo de aplicações a stack Node.js em vez do Astro estático.

Requisitos

Para instalares o Astro no Saplo, precisas de:

• Um Box em qualquer plano, o S é suficiente para começar - o resultado é uma compilação estática sem um processo mantido em memória.
• Mínimo de 512 MB de RAM livre para o processo de compilação (o Astro tem uma toolchain de compilação mais pesada que o Vite puro) e 3 GB de espaço em disco.
• Um domínio ou subdomínio *.saploapp.pl incluído em todos os planos.
• Um repositório Git, se quiseres implementações automáticas (opcional para começar, também podes carregar a aplicação como um arquivo .zip através do Painel).

Instalação passo a passo

1. No Painel da Saplo, acede ao Catálogo de aplicações e seleciona Astro (categoria "Sites").
2. Indica a Box e o nome da aplicação - a partir daqui é criado o subdomínio padrão <name>.saploapp.pl.
3. Escolhe a versão do Node.js para a compilação (18, 20 ou 22, padrão 20) e confirma a instalação.
4. O motor cria um esqueleto mínimo do Astro, instala as dependências e constrói o projeto, e o conteúdo do diretório dist é colocado diretamente no diretório da aplicação, servido pelo nginx.
5. Após a conclusão da instalação, o domínio do passo 2 mostra a página inicial do Astro - a partir deste momento, podes implementar o teu próprio conteúdo nele.

Implementação de código personalizado via Git

1. Nos detalhes da aplicação, encontra a secção Git / CI-CD e clica em "Ligar GitHub", confirma a instalação da aplicação "Saplo Deploy" e seleciona o repositório com o projeto Astro.
2. O ficheiro saplo.yaml deve estar localizado na raiz do repositório.
3. Faz commit e push do ficheiro saplo.yaml para o branch de produção (por defeito, main).
4. Cada git push subsequente para este branch constrói o projeto e substitui o conteúdo do diretório dist na Box. Podes verificar o estado no separador Deployments.
5. Por defeito, o Astro gera estáticos para dist/ - o nginx serve-os diretamente, sem qualquer processo em segundo plano no servidor.

Exemplo de um ficheiro saplo.yaml mínimo para Astro:

name: my-project
stack: astro
build:
  install: npm ci
  command: npm run build
  output: dist

Astro na Saplo vs. Alternativas

Perguntas Frequentes

Posso escrever conteúdo em Markdown? Sim, as coleções de conteúdo no Astro guardam o conteúdo como ficheiros Markdown no repositório, validados durante a compilação.

O Astro precisa de um processo em segundo plano? Não no modo padrão - o output é totalmente estático e servido diretamente pelo nginx, sem consumo de RAM após a conclusão da compilação.

Quando escolher SSR (adaptador de Node) em vez de estático? Quando o site precisa de retornar dados diferentes para cada consulta (por exemplo, painel de utilizador) - então no catálogo de aplicações escolhe o stack Node.js e configura o start.command.

Posso misturar 'islands' de diferentes frameworks numa única página? Sim, o Astro permite combinar componentes React, Vue e Svelte na mesma página, cada um hidratado independentemente.

Terei SSL e o meu próprio Domínio? Sim, o certificado SSL é automático, e o Domínio ou subdomínio *.saploapp.pl está incluído no preço de qualquer plano.

No Saplo, podes ter um site Astro a funcionar num Domínio em poucos minutos, e atualizas o conteúdo através do git push sem mexer no painel de administração ou na base de dados. Se o projeto crescer e precisar de SSR completo, encontrarás o stack Node.js no mesmo catálogo.