Editor Visual de Pipelines

Guía completa del editor visual DAG de Promptline. Aprende a usar cada elemento del editor para crear pipelines CI/CD profesionales.

Navegación Rápida

Tipos de Nodos
Categorías y colores
Elementos del Nodo
Componentes y paneles
Interacciones
Cómo usar el editor

Tipos de Nodos del Pipeline

Build Jobs

build

Jobs que compilan, empaquetan y preparan el código para deployment

Ejemplos comunes:

install_dependencies
build_app
compile_assets
bundle_code

Test Jobs

test

Jobs que ejecutan pruebas unitarias, integración y end-to-end

Ejemplos comunes:

unit_tests
integration_tests
e2e_tests
lint_code

Deploy Jobs

deploy

Jobs que despliegan la aplicación a diferentes entornos

Ejemplos comunes:

deploy_staging
deploy_production
release_app
publish_package

Security Jobs

security

Jobs que ejecutan análisis de seguridad y auditorías

Ejemplos comunes:

security_scan
dependency_audit
sast_analysis
container_scan

Cache Jobs

cache

Jobs que gestionan cache y optimización de dependencias

Ejemplos comunes:

yarn_cache
npm_cache
docker_cache
build_cache

Prepare Jobs

prepare

Jobs de preparación y configuración inicial del pipeline

Ejemplos comunes:

setup_environment
configure_variables
prepare_workspace

Elementos del Nodo

Header Section

Información principal del job

Category Badge

Indica la categoría del job (build, test, deploy, etc.)

Badge coloreado con icono

Stage Badge

Muestra el stage del pipeline donde se ejecuta

Badge secundario con nombre del stage

Job Name

Nombre único del job en el pipeline

Título principal del nodo

Description

Descripción breve de lo que hace el job

Texto secundario truncado

Action Buttons

Controles de interacción con el job

Edit Button

Abre el editor de configuración del job

Icono de Settings, visible en hover

Duplicate Button

Crea una copia del job con configuración similar

Icono de Copy, visible en hover

Delete Button

Elimina el job del pipeline

Icono de Trash, visible en hover

Run Button

Simula la ejecución del job (demo)

Botón Play en la parte inferior

Configuration Panels

Paneles que muestran la configuración del job

Docker Image Panel

Muestra la imagen Docker que usa el job

Panel con borde azul y texto monospace

Services Panel

Lista los servicios Docker adicionales

Panel con icono Users y lista de servicios

Variables Panel

Muestra las variables de entorno del job

Panel con icono Code y pares clave-valor

Script Panel

Previsualiza los comandos que ejecuta el job

Panel con icono FileText y comandos truncados

Advanced Features

Características avanzadas del job

Artifacts Panel

Muestra archivos generados y su configuración

Panel con icono Archive y rutas de archivos

Environment Panel

Información del entorno de deployment

Panel con icono Globe y detalles del entorno

Dependencies

Muestra jobs de los que depende (needs)

Badges con nombres de jobs requeridos

Tags

Etiquetas de runner para ejecución

Badges pequeños con nombres de tags

Status Indicators

Indicadores visuales del estado del job

Status Icon

Icono que indica el comportamiento del job

CheckCircle (normal), AlertTriangle (allow_failure), Pause (interruptible)

Feature Badges

Badges que muestran características especiales

Parallel, Retry, Timeout, Coverage badges

Connection Handles

Puntos de conexión para crear dependencias

Círculos azules arriba (input) y abajo (output)

Ejemplo Visual: Nodo de Test

test
test

unit_tests

Run Jest unit tests with coverage reporting

Image:

node:18-alpine

Script:

npm run test:coverage
npm run test:unit
Needs:
install_dependencies
Coverage
Parallel: 2
Normal
1
Category Badge:Identifica el tipo de job (test) con color verde
2
Configuration Panels:Muestran imagen Docker, scripts y configuración
3
Action Buttons:Aparecen en hover para editar, duplicar o eliminar

Guía de Interacciones

Drag & Drop

Arrastra jobs desde la librería al canvas para añadirlos al pipeline

  1. 1
    Selecciona un job de la librería lateral
  2. 2
    Arrastra el job al área del canvas
  3. 3
    Suelta para añadir al pipeline
  4. 4
    El job aparece en una posición automática

Connect Jobs

Crea dependencias entre jobs arrastrando desde los handles

  1. 1
    Haz clic en el handle inferior (source) del job padre
  2. 2
    Arrastra hasta el handle superior (target) del job hijo
  3. 3
    Suelta para crear la conexión
  4. 4
    La dependencia se refleja en el YAML generado

Edit Configuration

Modifica la configuración de un job existente

  1. 1
    Haz hover sobre el job para ver los controles
  2. 2
    Haz clic en el icono Settings
  3. 3
    Modifica la configuración en el dialog
  4. 4
    Guarda los cambios para actualizar el pipeline

View Details

Inspecciona los detalles de configuración de un job

  1. 1
    Los paneles del nodo muestran configuración clave
  2. 2
    Hover para ver tooltips con más información
  3. 3
    Los badges indican características especiales
  4. 4
    Los colores representan diferentes categorías

Conceptos del DAG (Directed Acyclic Graph)

Directed Acyclic Graph (DAG)

Estructura que representa las dependencias entre jobs sin ciclos

  • Cada nodo representa un job del pipeline
  • Las conexiones representan dependencias (needs)
  • El flujo va de arriba hacia abajo
  • No se permiten dependencias circulares

Stages

Agrupaciones lógicas de jobs que se ejecutan en orden

  • prepare: Configuración inicial y cache
  • test: Pruebas y validaciones
  • build: Compilación y empaquetado
  • deploy: Despliegue a entornos

Dependencies

Relaciones que determinan el orden de ejecución

  • needs: Jobs que deben completarse antes
  • dependencies: Artifacts requeridos de otros jobs
  • Paralelización automática cuando es posible
  • Optimización de tiempos de ejecución

Características Avanzadas

Connection Handles

Target Handle (Arriba)

  • • Punto de entrada para dependencias
  • • Recibe conexiones de jobs padre
  • • Representa el concepto "needs" en YAML
  • • Color azul (#1E90FF)

Source Handle (Abajo)

  • • Punto de salida para dependencias
  • • Envía conexiones a jobs hijo
  • • Permite crear flujos de dependencia
  • • Color azul (#1E90FF)

Mejores Prácticas del Editor Visual

Recomendaciones

Organiza por stages:

Agrupa jobs visualmente por prepare → test → build → deploy

Usa dependencias claras:

Conecta jobs solo cuando sea necesario para optimizar paralelización

Nombra descriptivamente:

Usa nombres que expliquen claramente la función del job

Evitar

Dependencias innecesarias:

No conectes jobs que pueden ejecutarse en paralelo

Nodos sobrecargados:

Divide jobs complejos en tareas más pequeñas y específicas

Configuración duplicada:

Usa templates y extends para evitar repetir configuración

¿Listo para crear tu primer pipeline?

Usa el editor visual para crear pipelines CI/CD profesionales en minutos

Abrir EditorVer Más Documentación