Saltar al contenido principal

Quickstart — Primer deploy

Este guía te lleva desde cero hasta tener una app Node.js corriendo en producción. El proceso es el mismo para cualquier runtime; las diferencias se documentan en las guías específicas por lenguaje.

Antes de empezar​

Necesitas:

  • Una cuenta activa en Kubiy
  • Un repositorio GitHub con tu aplicación
  • La app debe escuchar en el puerto indicado por la variable de entorno PORT

Paso 1 — Prepara tu aplicación​

Tu app debe leer el puerto desde la variable de entorno PORT. Por ejemplo, en Express:

const express = require('express')
const app = express()

const port = process.env.PORT || 3000

app.get('/health', (req, res) => res.json({ status: 'ok' }))

app.listen(port, () => {
  console.log(`Servidor escuchando en puerto ${port}`)
})

Asegúrate de tener un package.json con el script start:

{
  "name": "mi-app",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "express": "^4.18.0"
  }
}

Paso 2 — Crea una nueva app en Kubiy​

  1. Ve al dashboard y haz clic en New App
  2. Selecciona App Deploy
  3. En el Step 1, elige el runtime Node.js
  4. Conecta tu cuenta de GitHub si no lo has hecho, luego selecciona el repositorio

Paso 3 — Configura el inicio​

En el Step 2:

  1. Selecciona el preset npm run [script]
  2. En el campo Script, escribe start (o el nombre de tu script en package.json)
  3. Deja el Build Command vacío — Kubiy ejecutará npm ci --omit=dev automáticamente
consejo

Si tu app tiene un proceso de build (TypeScript, bundlers, etc.), aquí es donde pones el comando, por ejemplo npm run build. Ver Build Command.

Paso 4 — Configura el health check (recomendado)​

En la sección Health Check:

  1. Activa el health check
  2. Escribe el path: /health

Kubiy verificará que tu app responde en ese endpoint antes de dar el deploy como exitoso.

Paso 5 — Variables de entorno​

Si tu app necesita variables de entorno (conexiones a bases de datos, API keys, etc.):

  1. En la sección Environment Variables, haz clic en Add variable
  2. Ingresa el nombre y el valor
  3. Repite para cada variable necesaria
aviso

Nunca subas secretos en tu código fuente. Usa siempre las variables de entorno de Kubiy.

Lanza el deploy​

Haz clic en Deploy. Kubiy:

  1. Sube tu código a S3
  2. Instala las dependencias con npm ci --omit=dev
  3. Inicia la app con PM2 usando npm run start
  4. Verifica el health check en /health
  5. Activa el dominio cuando la app está lista

El proceso toma entre 30 segundos y 3 minutos dependiendo del tamaño de las dependencias.

Resultado​

Una vez completado el deploy, tu app estará disponible en:

https://<app-id>.kubiy.site

Puedes también configurar un dominio personalizado desde la configuración de la app.

Siguientes pasos​