Cómo alojar una aplicación Deno en Vertra Cloud

​

Requisitos

• Deno 2.8+ instalado localmente
• Cuenta en Vertra Cloud
• Un deno.json (o deno.jsonc) en la raíz del proyecto

​

Estructura del proyecto

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

​

Configuración

​

deno.json

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

​

vertracloud.config

MAIN=main.ts
VERSION=recommended

​

Ejemplo: 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",
  });
});

​

Despliegue

vertra upload
vertra logs -f

​

Versiones disponibles

​

Notas

• Dependencias: decláralas en deno.json e incluye deno.lock en el repositorio para que las instalaciones sean reproducibles
• Permisos: la aplicación se ejecuta con permisos completos, así que Deno.env, el acceso a la red y a los archivos funcionan sin flags
• Variables de entorno: usa Deno.env.get("KEY")
• Logs: usa console.log() para los logs que aparecen en tiempo real
• Escucha en 0.0.0.0 en el puerto 80

​

Errores comunes

• Archivo de entrada no encontrado: MAIN debe apuntar al archivo de entrada relativo a la raíz del zip, por ejemplo main.ts.
• Detectado como otro lenguaje: un proyecto Deno sin ninguno de deno.json, deno.jsonc o deno.lock en la raíz no se reconoce. Añade uno de ellos o define LANGUAGE=deno en vertracloud.config.
• La aplicación arranca pero el sitio no abre: el servidor debe escuchar en 0.0.0.0 y en el puerto 80, no en localhost.