Requisitos
- Bun 1.3+ instalado localmente
- Conta na Vertra Cloud
package.json configurado
Estrutura do projeto
Configuração
package.json
bunfig.toml
vertracloud.config
src/index.ts
Deploy
- Compacte o projeto em um
.zip (pastas como node_modules, venv e target são removidas automaticamente) ou envie para o GitHub.
- No painel, clique em Novo Projeto e envie o
.zip ou cole a URL do repositório.
- Em Build, confira o runtime (Bun), o arquivo principal (
index.ts) e a memória. Os comandos de start e de build ficam em Configurações Avançadas.
- Adicione suas variáveis de ambiente em Ambiente.
- Em Rede, ative a publicação web para que a aplicação receba um endereço
*.vertraweb.app (plano Pro ou superior, 512 MB de memória). A aplicação precisa escutar na porta 80.
- Revise e faça o deploy. Acompanhe a saída na aba Logs.
Veja CLI para instalação e login. Abra a pasta com a extensão da Vertra Cloud instalada e execute Fazer deploy do projeto atual. Veja Extensão do VS Code.
O passo a passo completo está em Primeiro deploy.
Versões disponíveis
Observações
- Desempenho: o Bun é significativamente mais rápido que o Node.js
- TypeScript nativo: o Bun executa TypeScript diretamente, sem compilação
- Compatibilidade: o Bun é compatível com Node.js/npm, mas tem algumas diferenças
- Variáveis de ambiente: acesse via
process.env.KEY
- Logs: use
console.log() para logs que aparecem no painel
- Módulos: use
bun add para adicionar dependências
- Escute em
0.0.0.0 na porta $PORT
Última modificação em 26 de outubro de 2026