Saltar al contenido principal

Inicio Rapido

Despliega tu primer proyecto en 5 minutos.

Requisitos previos​

  • Una cuenta de GitHub o GitLab
  • Un repositorio con un Dockerfile (o un runtime soportado: Node.js, Python, Java)
  • Una cuenta de Swisblade

Paso 1: Crear stack.json​

Agrega un archivo stack.json en la raiz de tu repositorio:

{
  "name": "hello-world",
  "services": {
    "api": {
      "source": { "repo": "github.com/you/hello-world.git", "ref": "main" },
      "type": "app",
      "runtime": "node",
      "port": 3000,
      "public": true
    }
  }
}

Esto define un unico servicio que se compilara desde tu repo y se expondra publicamente.

Sin Dockerfile?

Si tu repo no tiene un Dockerfile, Swisblade detecta automaticamente tu runtime y genera uno por ti usando Nixpacks. Runtimes soportados: Node.js, Python, Java.

Paso 2: Crear un proyecto​

  1. Ve al dashboard y haz clic en Create Project.
  2. Elige como definir tu stack:
    • Git Repo — Apunta a un repositorio que contenga un stack.json.
    • Visual Builder NUEVO — Arma tu stack visualmente con formularios, sin escribir JSON. Elige servicios, bases de datos, runtimes y conexiones desde la UI.
    • stack.json — Pega tu stack.json directamente.
  3. Ingresa un nombre de proyecto (por ejemplo, hello-world).
  4. Si usas Git Repo o Visual Builder con repos privados, proporciona un Personal Access Token (PAT).
  5. Haz clic en Create & Deploy.
No sabes JSON?

Usa el tab Visual Builder para armar tu stack con un formulario. Agrega servicios, contenedores y bases de datos, selecciona infraestructura (PostgreSQL, Redis, etc.) y conecta servicios entre si, todo sin escribir una sola linea de JSON. El builder genera exactamente el mismo stack.json detras de escena.

Paso 3: Observa el despliegue​

El dashboard muestra un log de despliegue en tiempo real. Veras:

  1. Clonando tu repositorio
  2. Compilando la imagen Docker
  3. Iniciando el contenedor
  4. Health check aprobado

Una vez que el despliegue es exitoso, tu servicio esta activo.

Paso 4: Accede a tu app​

Tu servicio publico esta disponible en:

https://api-{project-slug}.swisblade.com

El slug del proyecto se muestra en el dashboard (por ejemplo, a1b2c3d4-hello-world).

Paso 5: Agrega una base de datos​

Necesitas una base de datos? Actualiza tu stack.json:

{
  "name": "hello-world",
  "services": {
    "api": {
      "source": { "repo": "github.com/you/hello-world.git", "ref": "main" },
      "type": "app",
      "runtime": "node",
      "port": 3000,
      "public": true,
      "needs": ["postgres"]
    }
  }
}

Haz commit, push y redespliega desde el dashboard. Swisblade va a:

  1. Aprovisionar una base de datos PostgreSQL
  2. Crear un usuario dedicado con limites de conexion
  3. Inyectar DATABASE_URL en tu servicio automaticamente

Tu app puede usar process.env.DATABASE_URL inmediatamente, sin necesidad de configuracion.

Que sigue​