Como criar um site estático HTML na Saplo (sem processos em segundo plano)

O tipo de aplicação mais simples em todo o catálogo Saplo: ficheiros HTML, CSS e JavaScript normais, sem qualquer build nem processo mantido em memória. Se tens uma página pronta - escrita à mão, exportada de um gerador de sites estáticos (Hugo, Jekyll, Eleventy, VitePress) ou comprada como template - basta carregares os ficheiros e pronto. O Nginx serve-os diretamente, sem qualquer camada intermédia que possa avariar.

Para quem serve uma página estática na Saplo

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

• um cartão de visita ou uma landing page a partir de um template pronto - carregas os ficheiros e a página funciona, sem instalares um CMS,
• uma página gerada por um gerador de sites estáticos - Hugo, Jekyll, Eleventy, VitePress e outros, enquanto o resultado forem ficheiros HTML,
• documentação ou portfolio - o conteúdo muda com pouca frequência, não precisas de painel de administração nem de base de dados,
• uma página que queres ter o mais leve e difícil de danificar possível - sem PHP, sem base de dados MySQL, sem atualizações de plugins.

Se a página precisar de ganhar funcionalidades que exijam uma base de dados ou um painel para editar o conteúdo sem tocar em código, consulta o diretório de aplicações WordPress ou Astro (para conteúdo em Markdown vindo de um repositório).

Requisitos

Para criar um site estático na Saplo, precisas de:

• Box S em qualquer plano, o S é perfeitamente suficiente - é a receita mais leve de todo o catálogo,
• pelo menos 64 MB de RAM livre e 1 GB de espaço em disco,
• um domínio ou subdomínio *.saploapp.pl incluído no preço de cada plano,
• um repositório Git, se quiseres deploys automáticos (opcional, também podes carregar os ficheiros por SFTP ou um arquivo .zip através do painel).

Instalação passo a passo

1. No painel Saplo, entra no Catálogo de aplicações e seleciona HTML (categoria "Páginas").
2. Indica o Box e o nome da aplicação - a partir deste é criado o subdomínio predefinido <name>.saploapp.pl.
3. Confirma a instalação. O motor cria um placeholder simples index.html com informação sobre o endereço do domínio, para que saibas que a aplicação está a funcionar antes de carregares os teus próprios ficheiros.
4. Quando a instalação terminar, o domínio do passo 2 mostra esse placeholder - a partir desse momento, substitui-o pela tua própria página.

Carregamento de ficheiros: SFTP ou Git

Tens duas opções, ambas funcionam imediatamente após a instalação:

1. SFTP - no painel, na secção Acesso SSH / SFTP, adicionas a tua chave pública, recebes o host e a porta do diretório da aplicação e carregas os ficheiros com qualquer cliente (FileZilla, Cyberduck ou linha de comandos).
2. Git - nos detalhes da aplicação, na secção Git / CI-CD, ligas o repositório, colocas nele o ficheiro saplo.yaml e fazes push das alterações para o branch de produção. Se o repositório não tiver o ficheiro package.json, o Saplo carrega os ficheiros exatamente como estão no repositório, sem qualquer build.

Se o site vier de um gerador de sites estáticos, em saplo.yaml indica o comando de build e o diretório de saída:

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

Para ficheiros HTML normais sem build, basta:

name: my-project
stack: static
build:
  output: .

Site estático no Saplo face às alternativas

Perguntas frequentes

Tenho de usar o Git para carregar a página? Não, o SFTP funciona imediatamente após a instalação - adicionas a chave pública no painel e envias os ficheiros com qualquer cliente.

Uma página estática funciona com qualquer gerador? Sim, desde que o build produza ficheiros HTML prontos no diretório indicado em build.output. O processo de build é executado pela Saplo em cada git push.

Recebo SSL e um domínio próprio? Sim, o certificado SSL é automático, e o domínio ou subdomínio *.saploapp.pl está incluído no preço de cada plano.

Quanto espaço ocupa uma página institucional típica? O manifesto da receita indica um mínimo de 1 GB, o que, com alguma margem, chega para uma página com uma galeria de fotografias em resolução razoável.

Posso mudar a página para WordPress ou Astro mais tarde? Sim, é uma aplicação separada no mesmo diretório - instalas uma ao lado da outra, migras o conteúdo ao teu ritmo e eliminas a versão estática anterior quando a nova estiver pronta.

Uma página estática na Saplo é a forma mais rápida de passar de uma Box vazia a um domínio funcional - sem build, sem base de dados, sem atualizações de plugins. Se, com o tempo, o conteúdo precisar de ganhar funcionalidades dinâmicas, WordPress e Astro estão à espera no mesmo diretório.