Tu primer trabajo en 15 minutos¶
Esta página te lleva paso a paso desde conectarte hasta ver los resultados de tu primer trabajo. No necesitas saber Slurm. Copia y pega cada comando.
Antes de empezar
Necesitas una cuenta aprobada en un proyecto (Solicitar una cuenta) y tu llave SSH (Conectarse por SSH). Conéctate desde una red de la USACH habilitada o por VPN (ver ¿Desde dónde puedo conectarme?).
La idea en 30 segundos¶
Chuchunco tiene un nodo de entrada (chuchunco) y varios nodos de cómputo. Tú entras al nodo de entrada. Ahí escribes un pequeño archivo, el script, que dice qué quieres ejecutar y qué recursos necesitas. Se lo entregas a Slurm, el gestor de colas. Slurm lo ejecuta en un nodo de cómputo cuando hay espacio y guarda lo que el programa imprime en un archivo.
No ejecutes cálculos directamente en el nodo de entrada: todo cálculo va por Slurm.
1. Conéctate¶
En tu computador (cambia nombre.apellido por tu usuario):
ssh nombre.apellido@158.170.68.170
Si todo va bien, verás un mensaje de bienvenida y una línea que termina en algo como:
nombre.apellido@chuchunco:~$
Ya estás en el nodo de entrada.
2. Mira a tu alrededor¶
¿Qué hay en el clúster? sinfo muestra las particiones (grupos de nodos) y su estado:
sinfo
PARTITION AVAIL TIMELIMIT NODES STATE NODELIST
MEM up 7-00:00:00 1 idle high-ram-n1
CPU* up 7-00:00:00 5 idle cpun[1-5]
GPU up 7-00:00:00 3 idle gpun[1-3]
- El
*marca la partición por defecto (CPU). TIMELIMITes el tiempo máximo de un trabajo: 7 días.STATEpuede seridle(libre),mix(en parte ocupado) oalloc(lleno).
¿En qué proyectos estás? Solo puedes enviar trabajos a nombre de un proyecto aprobado:
sacctmgr show assoc user=$USER format=account%30,qos%20
Account QOS
------------------------------ --------------------
mi-proyecto normal
%30 y %20 dan ancho a las columnas; sin eso, los nombres largos se cortan con un +. En la columna QOS, normal es lo habitual.
Si aparece más de una línea, estás en varios proyectos. Si no aparece ninguna, tu cuenta aún no está asociada a un proyecto: escribe a hpc.fisica@usach.cl.
¿Dónde estás? Tu carpeta personal (home) es la misma en todos los nodos:
pwd
/home/nombre.apellido
¿Dónde van tus datos? Cada proyecto tiene una carpeta compartida con su equipo, con el mismo nombre que el proyecto de arriba:
ls /data/proyectos
Tus datos y resultados grandes van en /data/proyectos/mi-proyecto, no en tu home: la carpeta del proyecto tiene 5 TB para el equipo y tu home, 1 TB. Si te acaban de agregar al proyecto y no puedes entrar en su carpeta, desconéctate y vuelve a entrar. Ver Almacenamiento y datos.
3. Escribe tu primer script¶
Crea una carpeta para practicar y entra en ella:
mkdir -p ~/practica && cd ~/practica
Crea el script con el editor nano:
nano hola.sh
Pega este contenido:
#!/bin/bash
#SBATCH --job-name=hola # nombre del trabajo
#SBATCH --cpus-per-task=1 # 1 CPU
#SBATCH --mem=1G # 1 GB de memoria
#SBATCH --time=00:05:00 # 5 minutos como máximo
#SBATCH --output=%x_%j.out # archivo de salida: hola_<número>.out
echo "Hola desde $(hostname)"
echo "Empecé a las $(date)"
sleep 30
echo "Terminé a las $(date)"
Guarda con Ctrl+O y Enter, y sal con Ctrl+X.
Las líneas que empiezan con #SBATCH le dicen a Slurm qué necesitas. El resto es un script de bash normal.
4. Envíalo¶
sbatch hola.sh
Submitted batch job 1234
1234 es el número del trabajo (job ID). Anótalo: lo usarás para todo lo demás.
5. Míralo en la cola¶
squeue -u $USER
JOBID PARTITION NAME USER ST TIME NODES NODELIST(REASON)
1234 CPU hola nombre.a R 0:05 1 cpun1
STes el estado:PD= pendiente (esperando),R= ejecutándose.NODELIST(REASON)dice en qué nodo corre o, si está pendiente, por qué espera.
Cuando el trabajo termina, desaparece de squeue. Este tarda unos 30 segundos.
6. Lee el resultado¶
cat hola_1234.out
Hola desde cpun1
Empecé a las mar 27 oct 2026 15:02:10 -03
Terminé a las mar 27 oct 2026 15:02:40 -03
Tu script corrió en cpun1, un nodo de cómputo, no en el nodo de entrada. (El nodo, las horas y los números de esta página son de ejemplo: los tuyos serán otros.)
7. Revisa qué usó¶
sacct -j 1234 -o JobID,Elapsed,MaxRSS,ReqMem,State
JobID Elapsed MaxRSS ReqMem State
------------ ---------- ---------- ---------- ----------
1234 00:00:30 1G COMPLETED
1234.batch 00:00:30 1500K COMPLETED
Elapsed: cuánto duró.MaxRSS: la memoria máxima que usó (en la línea.batch).ReqMem: la memoria que pediste.State:COMPLETEDes que terminó bien.FAILED,TIMEOUTuOUT_OF_MEMORYindican un problema (ver Preguntas frecuentes).
Usa esto para ajustar tus próximos trabajos: pide un poco más de lo que usaste, no mucho más.
8. Ahora con Python¶
Crea un programa pequeño:
nano calculo.py
import math
import os
n = int(os.environ.get("SLURM_CPUS_PER_TASK", "1"))
print(f"Tengo {n} CPU(s) asignadas")
total = sum(math.sqrt(i) for i in range(10_000_000))
print(f"Suma de raíces: {total:.2f}")
Y su script:
nano calculo.sh
#!/bin/bash
#SBATCH --job-name=calculo
#SBATCH --cpus-per-task=2
#SBATCH --mem=2G
#SBATCH --time=00:10:00
#SBATCH --output=%x_%j.out
python3 calculo.py
Envíalo y revisa, igual que antes:
sbatch calculo.sh
squeue -u $USER
cat calculo_*.out
Tengo 2 CPU(s) asignadas
Suma de raíces: 21081849486.44
Este ejemplo solo usa la biblioteca estándar de Python. Para usar NumPy, SciPy, Matplotlib u otras, crea tu propio entorno: Software y Python.
Si estás en varios proyectos¶
Elige a qué proyecto se carga el trabajo con -A:
sbatch -A mi-proyecto hola.sh
O dentro del script: #SBATCH -A mi-proyecto.
Qué pasa si no pides algo¶
Si no lo indicas, Slurm usa estos valores:
| Si no pones… | Slurm usa |
|---|---|
--partition |
CPU |
--time |
4 horas |
--mem |
2,9 GB por CPU en CPU · 3,9 GB en MEM · 5 GB en GPU |
Si tu trabajo pasa del tiempo, Slurm lo detiene (TIMEOUT). Si usa más memoria de la que pidió, también lo detiene (OUT_OF_MEMORY).
Siguientes pasos¶
- Slurm: colas y límites: particiones, límites, prioridad y por qué un trabajo espera.
- Software y Python: instalar tus paquetes.
- Ejemplos de trabajos: multihilo, MPI en un nodo, mucha memoria, arreglos.
- GPUs y Contenedores.