Tareas manuales¶
Las tareas manuales se ejecutan solo cuando un usuario lo decide, proporcionando control total sobre cuándo se realizan ciertas acciones.
¿Qué es una tarea manual?¶
Una tarea manual:
- Requiere acción del usuario para ejecutarse
- No tiene horario automático
- Es útil para acciones que necesitan supervisión
- Puede ejecutarse múltiples veces
Casos de uso¶
Las tareas manuales son ideales para:
| Caso | Ejemplo |
|---|---|
| Despliegues | Deploy a producción |
| Migraciones | Migración de base de datos |
| Generación | Crear reportes bajo demanda |
| Mantenimiento | Limpieza de cache |
| Operaciones sensibles | Cualquier acción que requiera supervisión |
Ver tareas manuales¶
- Ve a Tareas
- Haz clic en la pestaña Manuales
┌─────────────────────────────────────────────────────────────────┐
│ Tareas Manuales │
├─────────────────────────────────────────────────────────────────┤
│ Nombre │ Proyecto │ Agente │ Última │
├─────────────────────┼───────────┼───────────────────┼──────────┤
│ Deploy Production │ Platform │ devops-engineer │ Ayer │
│ Generate Report │ Analytics │ report-generator │ Hace 2d │
│ Clear Cache │ Platform │ maintenance-bot │ Hace 1h │
│ DB Migration │ Platform │ database-admin │ Hace 5d │
└─────────────────────┴───────────┴───────────────────┴──────────┘
Columnas¶
| Columna | Descripción |
|---|---|
| Nombre | Identificador de la tarea |
| Proyecto | Proyecto asociado |
| Agente | Agente que ejecutará |
| Última | Última vez que se ejecutó |
Crear tarea manual¶
- Haz clic en + Crear
- Selecciona tipo Manual
- Completa el formulario:
| Campo | Descripción |
|---|---|
| Nombre | Nombre descriptivo |
| Proyecto | Proyecto asociado |
| Agente | Agente que ejecutará |
| Descripción | Instrucciones detalladas |
- Haz clic en Crear
Sin CRON
Las tareas manuales no tienen expresión CRON ya que se ejecutan bajo demanda.
Ejecutar tarea manual¶
Desde la lista¶
- Localiza la tarea en la lista
- Haz clic en Ejecutar
- Confirma la ejecución si se solicita
- La tarea comienza a ejecutarse
Desde los detalles¶
- Abre los detalles de la tarea
- Haz clic en el botón Ejecutar
- Opcionalmente, añade parámetros adicionales
- Confirma y ejecuta
Parámetros de ejecución¶
Algunas tareas manuales aceptan parámetros:
┌─────────────────────────────────────────────────────────────────┐
│ Ejecutar: Deploy Production │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Versión a desplegar │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ v2.5.0 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Entorno │
│ ○ Staging │
│ ● Production │
│ │
│ [✓] Notificar por Slack al completar │
│ │
│ [Cancelar] [Ejecutar] │
│ │
└─────────────────────────────────────────────────────────────────┘
Confirmación de seguridad¶
Para tareas sensibles, se puede requerir confirmación adicional:
┌─────────────────────────────────────────────────────────────────┐
│ ⚠️ Confirmar ejecución │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Estás a punto de ejecutar: │
│ "Deploy Production" │
│ │
│ Esta acción desplegará cambios en el entorno de producción. │
│ │
│ Escribe "DEPLOY" para confirmar: │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [Cancelar] [Confirmar] │
│ │
└─────────────────────────────────────────────────────────────────┘
Monitorear ejecución¶
Después de lanzar una tarea manual:
- Se abre automáticamente el panel de ejecución
- Ves el progreso en tiempo real
- Los logs aparecen según avanza
- Al terminar, ves el resultado final
Estados durante ejecución¶
| Estado | Icono | Descripción |
|---|---|---|
| En cola | Esperando recursos | |
| Ejecutando | En progreso | |
| Completada | Terminó con éxito | |
| Fallida | Terminó con error | |
| Cancelada | Cancelada por usuario |
Cancelar ejecución¶
Si necesitas detener una tarea en progreso:
- Durante la ejecución, haz clic en Cancelar
- Confirma la cancelación
- El agente recibe señal de parada
- La tarea termina con estado Cancelada
Cancelación
La cancelación puede no ser inmediata. El agente intentará terminar de forma limpia.
Historial de ejecuciones¶
Cada tarea manual mantiene historial:
- Abre los detalles de la tarea
- Ve a la pestaña Historial
- Verás todas las ejecuciones pasadas
┌─────────────────────────────────────────────────────────────────┐
│ Historial: Deploy Production │
├─────────────────────────────────────────────────────────────────┤
│ Fecha │ Usuario │ Duración │ Estado │
├────────────────────┼────────────────┼──────────┼──────────────┤
│ 25/01/2025 14:30 │ Juan García │ 2m 45s │ ✓ Éxito │
│ 24/01/2025 10:15 │ María López │ 3m 12s │ ✓ Éxito │
│ 23/01/2025 16:00 │ Juan García │ 0m 45s │ ✗ Fallo │
│ 20/01/2025 09:30 │ Pedro Ruiz │ 2m 30s │ ✓ Éxito │
└────────────────────┴────────────────┴──────────┴──────────────┘
Permisos¶
Las tareas manuales pueden tener permisos específicos:
| Rol | Permiso |
|---|---|
| Admin | Crear, editar, ejecutar, eliminar |
| Editor | Ejecutar |
| Viewer | Solo ver |
Configurar permisos¶
- Edita la tarea
- En la sección Permisos
- Define quién puede ejecutarla
- Guarda los cambios
Diferencias con tareas programadas¶
| Aspecto | Manual | Programada |
|---|---|---|
| Trigger | Usuario | Horario CRON |
| Control | Total | Automático |
| Horario | No tiene | Definido |
| Uso | Acciones puntuales | Rutinas repetitivas |
| Supervisión | Durante ejecución | Post-ejecución |
Convertir entre tipos¶
De manual a programada¶
- Edita la tarea manual
- Cambia el tipo a Programada
- Define la expresión CRON
- Guarda
De programada a manual¶
- Edita la tarea programada
- Cambia el tipo a Manual
- El CRON se elimina
- Guarda
Siguiente: Crear tarea - Guía paso a paso para crear tareas.