Documentation
Primeros Pasos
Inicio Rápido

Inicio Rápido

Inicio Rápido

Una vez que hayas instalado MiniProcess, sigue estos pasos para crear y ejecutar tu primer proceso.

Paso 1: Iniciar el Servicio 

# Iniciar MiniProcess en modo daemon
miniprocess start

# O ejecutar en primer plano para desarrollo
miniprocess serve

Paso 2: Acceder a la Interfaz Web

Abre tu navegador y ve a http://localhost:8080. Deberías ver la página de bienvenida de MiniProcess.

Paso 3: Crear tu Primer Proceso

Opción 1: Usando la Interfaz Web

  1. Haz clic en “Nuevo Proceso”
  2. Selecciona “Proceso Simple” como plantilla
  3. Configura los parámetros básicos
  4. Haz clic en “Crear y Ejecutar”

Opción 2: Usando la CLI 

# Crear un nuevo proceso desde plantilla
miniprocess create --template simple --name "mi-primer-proceso"

# Ejecutar el proceso
miniprocess run mi-primer-proceso

Opción 3: Usando un archivo YAML

Crea un archivo proceso.yaml:

name: "Proceso de Ejemplo"
description: "Un proceso simple para comenzar"
version: "1.0"

steps:
  - name: "saludo"
    type: "log"
    config:
      message: "¡Hola desde MiniProcess!"
      level: "info"
  
  - name: "esperar"
    type: "delay"
    config:
      seconds: 2
  
  - name: "despedida"
    type: "log"
    config:
      message: "Proceso completado exitosamente"
      level: "info"

triggers:
  - type: "manual"
  - type: "schedule"
    config:
      cron: "0 */6 * * *"  # Cada 6 horas

Luego ejecútalo:

miniprocess deploy proceso.yaml
miniprocess run "Proceso de Ejemplo"

Paso 4: Monitorear tu Proceso

Ver Estado Actual 

# Listar todos los procesos
miniprocess list

# Ver detalles de un proceso específico
miniprocess status "Proceso de Ejemplo"

# Ver logs en tiempo real
miniprocess logs "Proceso de Ejemplo" --follow

Dashboard Web

Ve a http://localhost:8080/dashboard para una vista gráfica de:

  • Estado de todos los procesos
  • Métricas de rendimiento
  • Logs centralizados
  • Historial de ejecuciones

Paso 5: Configurar Notificaciones (Opcional) 

# Configurar notificaciones por email
miniprocess config set notifications.email.enabled true
miniprocess config set notifications.email.smtp_host smtp.gmail.com
miniprocess config set notifications.email.smtp_port 587
miniprocess config set notifications.email.username tu-email@gmail.com
miniprocess config set notifications.email.password tu-password

# Configurar Slack
miniprocess config set notifications.slack.enabled true
miniprocess config set notifications.slack.webhook_url https://hooks.slack.com/services/...

Ejemplos de Casos de Uso Comunes

1. Backup Automático 

name: "Backup Diario"
description: "Respaldo automático de base de datos"

steps:
  - name: "crear_backup"
    type: "shell"
    config:
      command: "pg_dump -h localhost -U user database > /backups/db_$(date +%Y%m%d).sql"
  
  - name: "comprimir"
    type: "shell"
    config:
      command: "gzip /backups/db_$(date +%Y%m%d).sql"
  
  - name: "limpiar_antiguos"
    type: "shell"
    config:
      command: "find /backups -name '*.sql.gz' -mtime +30 -delete"

triggers:
  - type: "schedule"
    config:
      cron: "0 2 * * *"  # Todos los días a las 2 AM

2. Procesamiento de Archivos 

name: "Procesar Imágenes"
description: "Redimensionar imágenes automáticamente"

steps:
  - name: "buscar_imagenes"
    type: "file_watcher"
    config:
      path: "/uploads/original"
      pattern: "*.jpg,*.png"
  
  - name: "redimensionar"
    type: "shell"
    config:
      command: "convert {{.file_path}} -resize 800x600 /uploads/resized/{{.file_name}}"
  
  - name: "generar_thumbnail"
    type: "shell"
    config:
      command: "convert {{.file_path}} -resize 150x150 /uploads/thumbnails/{{.file_name}}"

triggers:
  - type: "file_change"
    config:
      watch_path: "/uploads/original"

3. API Health Check 

name: "Health Check APIs"
description: "Monitoreo de servicios web"

steps:
  - name: "check_api_1"
    type: "http"
    config:
      url: "https://api.example.com/health"
      method: "GET"
      expected_status: 200
  
  - name: "check_api_2"
    type: "http"
    config:
      url: "https://api2.example.com/status"
      method: "GET"
      expected_status: 200
  
  - name: "notificar_error"
    type: "notification"
    config:
      on_failure: true
      channels: ["email", "slack"]
      message: "⚠️ API Health Check falló: {{.error_message}}"

triggers:
  - type: "schedule"
    config:
      cron: "*/5 * * * *"  # Cada 5 minutos

Próximos Pasos

Ahora que tienes un proceso funcionando:

  1. Explora las características avanzadas en la documentación completa
  2. Configura integraciones con tus herramientas existentes
  3. Personaliza el dashboard según tus necesidades
  4. Configura alertas y monitoreo para producción

Ayuda y Recursos

Installation