Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é adapter?

    Um adapter ajusta a saída do framework ao ambiente que executa as páginas. Entenda a integração no Astro e o que ainda exige configuração na hospedagem.

    Também chamado de: adaptador de servidor, server adapter

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano