# Helm

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

> Helm empaqueta manifiestos de Kubernetes en charts. Un chart es un directorio de YAML con templates de Go más un values.yaml con los valores por defecto.

> **Tiempo estimado:** 4 horas.
> **Requisitos previos:** labs 02, 03, 04.

Helm empaqueta manifiestos de Kubernetes en **charts**. Un chart es un
directorio de YAML con templates de Go más un `values.yaml` con los valores por defecto.
Instalás un chart para producir un **release** — un despliegue con nombre del
chart en un clúster/namespace específico. Los releases están versionados, así que
podés hacer rollback.

## Objetivos de aprendizaje

1. Instalar un chart público, sobreescribir valores, hacer upgrade y rollback.
2. Inspeccionar un chart renderizado con `helm template`.
3. Escribir un chart desde cero con un Deployment, un Service y un
   Ingress condicional.
4. Entender la diferencia entre `helm template`, `helm install`
   y `kubectl apply` — y cuándo Helm es la respuesta equivocada.

## Contexto

### Qué hace Helm en realidad

1. `helm install` renderiza los templates del chart con tus values + un
   contexto `Release.*` incorporado.
2. Manda cada recurso renderizado al clúster a través de la API, y
   guarda un *manifiesto del release* como Secret (o ConfigMap) en el
   namespace.
3. `helm upgrade` calcula un patch de tres vías (manifiesto viejo, estado
   real, manifiesto nuevo), lo aplica y guarda una nueva revisión del release.
4. `helm rollback` vuelve el clúster a un manifiesto guardado
   anterior.

Si lo único que necesitás es el YAML renderizado, `helm template ... | kubectl apply -f -`
es una alternativa legítima — al costo de perder la posibilidad de hacer rollback.

## Recorrido guiado

### 1. Instalá un chart público

```bash
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm install demo bitnami/nginx -n lab-11 --create-namespace \
  --set service.type=ClusterIP --set replicaCount=2
helm list -n lab-11
kubectl -n lab-11 get all
```

### 2. Hacé upgrade y rollback

```bash
helm upgrade demo bitnami/nginx -n lab-11 --set replicaCount=3 --reuse-values
helm history demo -n lab-11
helm rollback demo 1 -n lab-11
```

### 3. Renderizá sin aplicar

```bash
helm template demo bitnami/nginx --set replicaCount=3 | less
```

### 4. Tu propio chart

Hay un chart de referencia en `solutions/podinfo/`. Solo renderizalo — no
lo instales; en C2 vas a instalar tu propio chart como `myapp`:

```bash
helm template solutions/podinfo --set replicaCount=2 --set image.tag=6.7.1
```

## Desafíos

### C1. Un release a partir de un chart público

Instalá Bitnami NGINX en `lab-11` con el nombre de release `demo`, con
`replicaCount=2`, `service.type=ClusterIP`. El verificador lee la
metadata del release de helm.

### C2. Escribí un chart

En `labs/11-helm/charts/podinfo/` (lo creás vos) armá un chart para
podinfo con:

- `Chart.yaml` con `apiVersion: v2`, `name: podinfo`, `version: 0.1.0`,
  `appVersion: "6.7.1"`
- `values.yaml` que exponga al menos `replicaCount`, `image.repository`,
  `image.tag`, `service.port`, `ingress.enabled`, `ingress.host`
- templates: `deployment.yaml`, `service.yaml` e
  `ingress.yaml` protegido por `{{- if .Values.ingress.enabled }}`
- Un archivo `_helpers.tpl` con un template `podinfo.labels` que se use en
  cada recurso

Instalalo como release `myapp` en `lab-11` con `replicaCount=2`,
`image.tag=6.7.1`, `ingress.enabled=false`.

## Verificación

```bash
make verify LAB=11
```

## Lecturas recomendadas

- [Documentación de Helm](https://helm.sh/docs/).
- [*Helm Chart Best Practices*](https://helm.sh/docs/chart_best_practices/).


## 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/11-helm`:

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