Cómo funciona

lote submit <host> <script> hace rsync de tu repo al host, abre una conexión ssh y entrega el script al planificador de ese host a través del ejecutor en host. El mismo script aterriza en una caja sencilla, un clúster slurm o una supercomputadora pbs sin cambios de código, porque lote elige el backend a partir de lo que el host realmente tiene.

flowchart TB
    subgraph control["plano de control (lote, en tu laptop)"]
        direction LR
        SETUP["lote setup<br/>integrar un host"]
        SUBMIT["lote submit<br/>despachar un trabajo"]
        PS["lote ps / reconcile<br/>rastrear cada host"]
    end

    subgraph onhost["ejecutor en host (lote exec, por ssh)"]
        direction LR
        DETECT["sonda de planificador<br/>command -v qsub / sbatch"]
        ADAPT["submit / run / monitor<br/>un script, se adapta"]
    end

    subgraph clients["clientes tipados (envoltorios delgados)"]
        direction LR
        PUEUE["pueue<br/>host sencillo"]
        SBATCH["sbatch<br/>clúster slurm"]
        QSUB["qsub<br/>clúster pbs"]
        BASH["bash<br/>sin planificador"]
    end

    RSYNC(["rsync del repo hacia arriba<br/>lista de permitidos lote.toml"]):::brand
    DB(["almacén de estado<br/>.lote/db.json"]):::brand

    SETUP --> RSYNC
    SUBMIT --> RSYNC
    RSYNC --> DETECT
    DETECT --> ADAPT
    ADAPT --> PUEUE
    ADAPT --> SBATCH
    ADAPT --> QSUB
    ADAPT --> BASH

    SUBMIT --> DB
    PS --> DB

    classDef brand fill:#eab308,stroke:#1a1a1a,stroke-width:2px,color:#1a1a1a;

Las tres capas

Plano de control (lote) corre en tu laptop. Integra hosts con lote setup, despacha trabajos con lote submit y rastrea el estado de las ejecuciones en cada host con lote ps y lote reconcile. Nunca ejecuta un trabajo por sí mismo. Maneja el ejecutor en host por ssh y registra cada despacho en un almacén de estado local.

Ejecutor en host (lote exec) corre en un host. Encuentra el script del trabajo, detecta el planificador que el host realmente tiene, luego envía, ejecuta y monitorea el trabajo, adaptándose automáticamente a ese planificador. También puedes ejecutarlo a mano en un nodo de inicio de sesión, pero lote normalmente lo invoca por ti como chefe run lote exec ....

Clientes tipados son envoltorios delgados sobre las herramientas reales (qsub, sbatch, pueue, rsync). Cada uno parsea la salida de esa herramienta en registros tipados, así que el ejecutor lee el estado de un trabajo de la misma forma en todas partes. Los nuevos backends son nuevas clases, nunca nuevas ramas if host == ....

Detección automática del planificador

lote integra un host una vez con lote setup, sondeándolo en una shell de inicio de sesión para que la cadena de herramientas del clúster esté en PATH. A partir de lo que encuentra, enruta cada trabajo posterior para ese host.

host	qué encuentra lote	backend
un DGX o PC por ssh	sin planificador	pueue
un clúster slurm (p. ej. miyabi)	sbatch	sbatch
un clúster pbs (p. ej. Pegasus)	qsub	qsub
un nodo de inicio de sesión sencillo	nada planificable	bash

El mismo job.sh corre en los cuatro. Los scripts de trabajo protegen module load con command -v module, así que no hacen nada fuera de un clúster, y los argumentos posicionales fluyen a través de una variable de entorno ARGS que el script reenvía a su punto de entrada.

Flujo de despacho

lote setup miyabi              # probe + rsync + chefe install, then cache the host's facts
lote submit miyabi train.sh    # rsync up, pick sbatch, submit, print + record the handle
lote ps                        # the run shows up across every host
lote reconcile miyabi          # compare recorded runs with the live scheduler
lote pull <handle>             # rsync the recorded results path back

Un host se convierte en destino solo después de que chefe install tiene éxito durante la integración, así que una máquina que no puede construir el entorno nunca se convierte en destino. Después de eso, cada despacho es rsync hacia arriba, una llamada ssh a lote exec y una fila escrita en el almacén de estado.

A continuación, la referencia de comandos y la referencia de configuración.