Despliegue - Jelou AI Docs

Flujo de despliegue

Cuando ejecutas jelou functions deploy, la plataforma:

Lee jelou.json para encontrar el slug y entrypoint
Recolecta todos los archivos desplegables del directorio
Muestra un resumen con nombres y tamaños
Sube los archivos y ejecuta el despliegue
Renombra tu entrypoint a user-function.ts
Genera un main.ts wrapper que importa tu código e inicia el servidor
Inyecta tus secrets como variables de entorno

jelou functions deploy
# ▸ Files: index.ts (1.2 KB), helpers.ts (800 B), jelou.json (98 B), deno.json (65 B)
# ? Deploy consultar-cliente? (Y/n) y
# ✓ Deployed
# ▸ ID:  dep_abc12345
# ▸ URL: https://consultar-cliente.fn.jelou.ai

El deploy no genera ningún runtime token — la función queda protegida por defecto y solo acepta llamadas autenticadas con una API key de plataforma. Créala en la sección de configuración de apps (apps.jelou.ai) y envíala como Authorization: Bearer <key>. Consulta la guía de autenticación para más detalles.

Límites de archivos

Límite	Valor
Archivos por despliegue	20
Tamaño por archivo	256 KB
Tamaño total	1 MB
Extensiones permitidas	`.ts`, `.js`, `.json`, `.md`, `.txt`
Entrypoint requerido	`index.ts`

Qué se excluye automáticamente

node_modules/
.git/
.env
dist/
.jelou/
Archivos ocultos (que empiezan con .)

Omitir confirmación

Para despliegues automatizados, usa --no-confirm:

jelou functions deploy --no-confirm

Rollback

Si necesitas revertir a una versión anterior, usa jelou functions rollback.

Interactivo
Directo

Sin argumentos, muestra un menú con despliegues recientes:

jelou functions rollback
# ? Select deployment to rollback to:
#   ▸ dep_abc12345.. — 2 hours ago by [email protected] (current)
#     dep_def67890.. — 1 day ago by [email protected]
#     dep_ghi11223.. — 3 days ago by [email protected]

Especifica el slug y el ID del despliegue:

jelou functions rollback consultar-cliente dep_def67890
# ✓ Rolled back to dep_def67890

CI/CD con GitHub Actions

Despliegue básico
Con secrets

deploy.yml

name: Deploy Function
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install CLI
        run: npm install -g @jelou/cli

      - name: Deploy
        env:
          JELOU_TOKEN: ${{ secrets.JELOU_TOKEN }}
        run: jelou functions deploy --no-confirm --json | jq '.data.url'

deploy.yml

name: Deploy with Secrets
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install CLI
        run: npm install -g @jelou/cli

      - name: Configure secrets
        env:
          JELOU_TOKEN: ${{ secrets.JELOU_TOKEN }}
        run: |
          jelou functions secrets set consultar-cliente \
            CRM_API_KEY=${{ secrets.CRM_API_KEY }} \
            JELOU_API_KEY=${{ secrets.JELOU_API_KEY }}

      - name: Deploy
        env:
          JELOU_TOKEN: ${{ secrets.JELOU_TOKEN }}
        run: |
          DEPLOY_URL=$(jelou functions deploy --no-confirm --json | jq -r '.data.url')
          echo "Deployed to $DEPLOY_URL"

Usa --json en pipelines para obtener output estructurado que puedes parsear con jq. El formato es siempre { "ok": true, "data": ... } en stdout.

Rutas expuestas

Modo define()
Modo app()

Ruta	Descripción
`/__health`	Health check y metadata de la función
`/mcp`	Endpoint MCP (a menos que `config.mcp: false`)
Tu ruta	Ruta del handler (default: `*` coincide con cualquier path)

Ruta	Descripción
`/__health`	Health check con lista de todos los tools
`/mcp`	Servidor MCP unificado con todos los tools
`/<tool-key>`	Ruta de cada tool (kebab-case auto-generado o `config.path` personalizado)

Historial de despliegues

jelou functions deployments list mi-funcion
# ▸ ID             Status   Source  Files  Deployed By    Age
# ▸ dep_abc123..   active   cli     3      [email protected]  2h ago
# ▸ dep_def456..   active   cli     3      [email protected]    1d ago

Para ver detalles de un despliegue específico:

jelou functions deployments info mi-funcion dep_abc123

Para descargar el artifact de un despliegue:

jelou functions deployments download mi-funcion dep_abc123 -o artifact.tar.gz

​Flujo de despliegue

​Límites de archivos

​Qué se excluye automáticamente

​Omitir confirmación

​Rollback

​CI/CD con GitHub Actions

​Rutas expuestas

​Historial de despliegues

Flujo de despliegue

Límites de archivos

Qué se excluye automáticamente

Omitir confirmación

Rollback

CI/CD con GitHub Actions

Rutas expuestas

Historial de despliegues