Como hospedar uma aplicação Deno na Vertra Cloud

​

Requisitos

• Deno 2.8+ instalado localmente
• Conta na Vertra Cloud
• Um deno.json (ou deno.jsonc) na raiz do projeto

​

Estrutura do projeto

my-server-deno/
├── main.ts
├── deno.json
├── deno.lock
└── vertracloud.config

​

Configuração

​

deno.json

{
  "imports": {
    "@std/http": "jsr:@std/http@^1"
  }
}

​

vertracloud.config

MAIN=main.ts
VERSION=recommended

​

Exemplo: servidor HTTP

const port = Number(Deno.env.get("PORT") ?? 80);

Deno.serve({ hostname: "0.0.0.0", port }, (req) => {
  const { pathname } = new URL(req.url);

  if (pathname === "/health") {
    return Response.json({ status: "healthy", service: "deno-api" });
  }

  return Response.json({
    message: "Deno on Vertra Cloud",
    version: "1.0.0",
  });
});

​

Deploy

vertra upload
vertra logs -f

​

Versões disponíveis

​

Observações

• Dependências: declare-as no deno.json e versione o deno.lock para que as instalações sejam reproduzíveis
• Permissões: a aplicação roda com permissões totais, então Deno.env, rede e acesso a arquivos funcionam sem flags
• Variáveis de ambiente: use Deno.env.get("KEY")
• Logs: use console.log() para logs que aparecem em tempo real
• Escute em 0.0.0.0 na porta 80

​

Erros comuns

• Arquivo de entrada não encontrado: MAIN precisa apontar para o arquivo de entrada relativo à raiz do zip, por exemplo main.ts.
• Detectado como outra linguagem: um projeto Deno sem nenhum dos arquivos deno.json, deno.jsonc ou deno.lock na raiz não é reconhecido. Adicione um deles ou defina LANGUAGE=deno no vertracloud.config.
• A aplicação inicia, mas o site não abre: o servidor precisa escutar em 0.0.0.0 e na porta 80, não em localhost.