Integração com o ambiente de execução
Um adapter é uma integração que ajusta a saída de um framework ao ambiente de execução da aplicação. No Astro, o adapter de servidor prepara o código que vai receber requisições e gerar páginas sob demanda no destino escolhido.
Cada ambiente oferece interfaces próprias para executar esse código. Um servidor Node.js e uma plataforma de funções podem exigir saídas diferentes, por isso o adapter precisa corresponder ao destino da publicação. A instalação dessa integração faz parte da configuração do projeto.
Um servidor Node.js como exemplo
O adapter oficial @astrojs/node oferece o modo standalone, que produz uma aplicação capaz de iniciar seu próprio servidor. Com o build pronto e a estrutura de saída padrão, o comando node ./dist/server/entry.mjs executa a entrada gerada. Esse servidor atende as rotas da aplicação e pode servir os arquivos estáticos produzidos para o navegador.
O exemplo exige o Node.js no ambiente de destino e os arquivos gerados disponíveis nos caminhos esperados. Copiar somente as imagens e as folhas de estilo não instala a parte que gera as páginas sob demanda. Você precisa publicar e executar também a saída de servidor.
O mesmo adapter oferece um modo de middleware para integrar a aplicação a outro servidor Node.js. Nesse modo, o servidor que recebe a integração precisa cuidar dos arquivos estáticos. O comando do exemplo anterior pertence ao modo standalone, não descreve a inicialização de qualquer adapter.
O que ainda depende da hospedagem
Uma aplicação pode iniciar e falhar ao consultar o banco porque a credencial não foi configurada no destino. O adapter prepara a execução do código, mas o acesso aos serviços externos continua sujeito à configuração da aplicação e do ambiente.
Você pode conferir a integração usada no arquivo de configuração do Astro e comparar suas opções com a documentação do destino. Ter a dependência instalada não confirma que o adapter está ativado ou que a conexão com o banco funciona.
Um site composto apenas por arquivos previamente gerados pode ser publicado sem adapter de servidor. Alguns adapters também acrescentam recursos para páginas estáticas, conforme a plataforma, então sua presença no projeto não indica que todas as rotas são renderizadas sob demanda.
Dúvidas frequentes
Perguntas frequentes sobre adapter
- O adapter também fornece a hospedagem?
- Não. O adapter prepara a saída para o ambiente de destino. A hospedagem precisa executar essa saída e disponibilizar os arquivos e serviços usados pela aplicação.
- Um site Astro estático precisa de adapter?
- Um site composto apenas por arquivos previamente gerados pode ser publicado sem adapter de servidor. Alguns adapters oferecem recursos adicionais para páginas estáticas. A renderização sob demanda exige um adapter compatível.
- O mesmo adapter funciona em qualquer hospedagem?
- O adapter precisa ser compatível com o ambiente de execução. O adapter de Node.js, por exemplo, exige um destino capaz de executar a aplicação em Node.js com a configuração escolhida.
Para continuar
Recursos relacionados
Documentação
Astro: funcionamento dos adapters
Documenta a integração que prepara a saída de servidor para o ambiente de execução.
Abrir recursoSite de referência
Desenvolvimento Colaborativo da Dev Side Studio
Sessão prática com orientação ao vivo para conferir o adapter configurado e a execução da aplicação na hospedagem.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A configuração do ambiente de publicação precisa corresponder à forma de execução das páginas do sistema.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.