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
# ⚠ A default runtime token was created for this function.
#   Save it now — it will not be shown again.
# ▸ Token    jfn_rt_abc123...

El runtime token solo aparece en el primer deploy de una función. Los deploys subsiguientes no lo muestran. Si perdiste el token, crea uno nuevo con jelou tokens create.

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 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