# Jobs y CronJobs

Lab de K8s 07 · Laboratorios de Kubernetes · Sistemas Operativos
Page: https://alfonsocampodonico.com/classes/operating-systems/kubernetes-07-jobs?lang=es
Code: https://github.com/AlfonsoCampodonico/k8s-labs/tree/main/labs/07-jobs (`gh repo clone AlfonsoCampodonico/k8s-labs`)

> No toda carga de trabajo es un servidor que corre indefinidamente. El procesamiento batch, los backups, las migraciones y los reportes programados necesitan un controlador cuya condición de éxito sea "corre hasta terminar". Eso es un Job.

> **Tiempo estimado:** 3 horas.
> **Requisitos previos:** lab 01.

No toda carga de trabajo es un servidor que corre indefinidamente. El
procesamiento batch, los backups, las migraciones y los reportes
programados necesitan un controlador cuya condición de éxito sea
"corre hasta terminar". Eso es un **Job**. Un **CronJob** es un
scheduler que crea Jobs según un cronograma de cron.

## Objetivos de aprendizaje

1. Correr un Job de una sola ejecución y observar `completions` y `backoffLimit`.
2. Usar `parallelism` y `completions` juntos para cargas
   trivialmente paralelizables, y usar `completionMode: Indexed` para
   patrones de cola de trabajo por índice.
3. Configurar un CronJob con `concurrencyPolicy` y
   `startingDeadlineSeconds`.
4. Debuggear un Job que falla y entender la diferencia entre un pod
   que falló y un Job que falló.

## Contexto

- El `restartPolicy` de un Job tiene que ser `OnFailure` o `Never`;
  `Always` no tiene sentido para una carga batch.
- `backoffLimit` limita los reintentos de un Job (por defecto 6).
  Después de eso, el Job queda marcado como `Failed`.
- `ttlSecondsAfterFinished` dispara la limpieza automática de los pods
  de los Jobs terminados y del propio objeto Job. Sin eso, los Jobs se
  acumulan.
- El `concurrencyPolicy` de un CronJob puede ser `Allow`, `Forbid` o
  `Replace`. `Forbid` es lo que querés para la mayoría de los jobs
  nocturnos.

## Recorrido guiado

### 1. Un Job de una sola vez

```bash
kubectl apply -f manifests/job-simple.yaml
kubectl get jobs
kubectl logs job/pi
```

### 2. Un Job paralelo

```bash
kubectl apply -f manifests/job-parallel.yaml
kubectl get pods -l job-name=mapreduce -w
```

### 3. Un Job Indexed

```bash
kubectl apply -f manifests/job-indexed.yaml
kubectl get pods -l job-name=shards --sort-by=.metadata.name
kubectl logs -l job-name=shards,batch.kubernetes.io/job-completion-index=0
kubectl logs -l job-name=shards,batch.kubernetes.io/job-completion-index=3
```

### 4. Un CronJob

```bash
kubectl apply -f manifests/cronjob.yaml
# Mirá durante un minuto...
kubectl get cronjobs
kubectl get jobs
```

## Desafíos

### C1. Job `report`

En `lab-07`, creá un Job `report` que:

- use la imagen `busybox:1.36`
- corra `sh -c 'echo report-ok; sleep 2'`
- tenga `completions=4`, `parallelism=2`
- tenga `backoffLimit=0` (el Job falla apenas falla cualquier pod)
- tenga `ttlSecondsAfterFinished=300` (el Job se borra solo 5 minutos
  después de terminar: corré el verificador dentro de esos 5 minutos)

### C2. CronJob `nightly`

Un CronJob `nightly` en `lab-07` que:

- se programe con `*/2 * * * *` (cada 2 minutos, así el verificador puede observarlo)
- tenga `concurrencyPolicy: Forbid`
- cuyo template de Job corra `busybox:1.36` con `sh -c 'date; exit 0'`
- tenga `successfulJobsHistoryLimit=1`, `failedJobsHistoryLimit=1`

### C3. Un Job que reintenta y finalmente se rinde

Un Job `flaky` en `lab-07` que siempre sale con 1, con `backoffLimit=2`.
El verificador busca `.status.failed >= 3` (el intento inicial + 2
reintentos) y la condición `Failed` del Job; mientras el Job sigue
reintentando, solo avisa.

## Verificación

```bash
make verify LAB=07
```

## Lecturas recomendadas

- [Kubernetes Jobs](https://kubernetes.io/docs/concepts/workloads/controllers/job/).
- [CronJobs](https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/).


## Correrlo

Con Docker, kind y kubectl instalados, corré los targets de `make` desde la
raíz del repositorio; para los comandos del recorrido, que usan rutas
relativas al lab, primero `cd labs/07-jobs`:

```sh
./bin/preflight.sh
make cluster
make lab LAB=07
make verify LAB=07
```
