Faça deploy de Astro na Nodion

Faça deploy de Astro passo a passo

1. Faça commit do lockfile e faça o build Faça commit do seu lockfile; sem ele, o build falha. A Nodion executa o seu script build e serve dist/ com um servidor web estático. Não há nenhum servidor Node.js em execução, por isso um site Astro estático não precisa de adapter. package.json

   "scripts": {
     "dev": "astro dev",
     "build": "astro build"
   }

2. Marque as variáveis de build Um build estático lê todas as variáveis durante astro build, por isso marque Build para cada uma no separador Environment. No modo servidor, o mesmo vale para as variáveis PUBLIC_*, que acabam no código executado pelo browser.
3. Para SSR: adicione o adapter Node Execute npx astro add node ou instale manualmente @astrojs/node, use-o em modo standalone e defina output: 'server' (ou 'hybrid' no Astro 4). A Nodion só inicia um servidor quando astro.config.mjs, .js ou .ts contém essa definição; não lê astro.config.mts. Mantenha astro e @astrojs/node em dependencies, porque as dependências de desenvolvimento são removidas depois do build. astro.config.mjs

   import { defineConfig } from "astro/config";
   import node from "@astrojs/node";
   
   export default defineConfig({
     output: "server",
     adapter: node({ mode: "standalone" }),
   });

4. Ponha o servidor a escutar em todas as interfaces O servidor standalone lê PORT, definida pela Nodion, e HOST. Defina HOST como 0.0.0.0 no separador Environment para que o servidor aceite ligações de fora da instância, incluindo o health check. A Nodion inicia node ./dist/server/entry.mjs, a menos que o package.json tenha um script start; se o seu script executar astro dev, remova-o.
5. Crie a aplicação e faça push No dashboard, crie uma aplicação a partir do seu repositório GitHub, GitLab, Bitbucket ou Gitea na região EU Central. Cada push faz o build de uma nova release, e o tráfego passa para ela assim que / responde com um estado 2xx ou 3xx.

A ter em conta

• As páginas on demand precisam de output: 'server'A Nodion decide com base na definição output, não no adapter. Um projeto que mantém o output estático predefinido e renderiza páginas individuais on demand com export const prerender = false não é executado como servidor. Defina antes output: 'server' e marque as páginas que devem continuar estáticas com export const prerender = true.
• A sua página 404Para caminhos que não existem, o servidor estático responde com o seu index.html. Para mostrar em vez disso a página que o Astro gera a partir de src/pages/404.astro, adicione um static.toml com fallback = "404.html". Faça-o apenas com output estático: com um static.toml, a Nodion serve sempre o projeto como ficheiros estáticos.

O que a Nodion gere por si

• Deploys sem downtime Faça push para o seu branch e a Nodion cria uma nova release. O tráfego só muda quando as novas instâncias passam no health check; se uma release falhar, a que está em execução mantém-se. Em vez disso, as aplicações com um volume local são reiniciadas, porque o disco pertence a uma única instância.
• Bases de dados junto à aplicação PostgreSQL, pgvector, MySQL, Valkey e ClickHouse geridos, na mesma região. As bases de dados associadas chegam como DATABASE_URL, REDIS_URL ou CLICKHOUSE_URL.
• Pré-visualizações por pull request Ative as pré-visualizações e cada pull request do seu repositório passa a ter uma aplicação própria, com URL próprio e bases de dados novas e vazias, criada automática ou manualmente. Os forks e os pull requests de bots são ignorados.
• Workers, cron jobs e escalabilidade Execute workers como processos adicionais da mesma aplicação, agende tarefas no separador Cron e escale cada processo até 16 instâncias.
• Etapa de release Com buildpacks, uma linha release: do Procfile é executada a cada novo build. As aplicações com Dockerfile, bem como os redeploys ou rollbacks para uma imagem anterior, usam um comando de release definido na própria aplicação, que também tem prioridade sobre a linha do Procfile. Nos sites estáticos, a etapa de release é executada numa imagem que contém apenas os ficheiros gerados pelo build.
• Logs e métricas Logs de build, release e runtime, além de métricas de CPU, memória, disco e rede de cada instância, no dashboard.
• Domínios e HTTPS Um hostname atribuído por omissão com HTTPS desde o primeiro deploy; os seus próprios domínios recebem certificados automaticamente.

Para saber mais

• Ambientes de pré-visualização: uma aplicação por pull request Uma cópia em execução da sua aplicação para cada pull request: para que servem os ambientes de pré-visualização, onde se complicam e como a Nodion os gere.

Astro na Nodion: perguntas e respostas