Saltar al contenido principal

Capítulo 10.3 - Templates Avanzados y Hooks

Objetivos de Aprendizaje​

Al final de este capítulo, usted será capaz de:

  • Utilizar las funciones avanzadas de los templates Go
  • Implementar condiciones y bucles
  • Utilizar los Hooks Helm
  • Gestionar las dependencias entre recursos
  • Crear templates reutilizables
  • Optimizar los Charts

Introducción​

Los templates Helm permiten crear configuraciones Kubernetes dinámicas y reutilizables. Los Hooks permiten ejecutar acciones en momentos específicos del ciclo de vida.

Funciones Avanzadas de los Templates​

Condiciones​

{{- if .Values.ingress.enabled }}
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: {{ .Release.Name }}-ingress
spec:
  ...
{{- end }}

Bucles​

{{- range .Values.env }}
- name: {{ .name }}
  value: {{ .value }}
{{- end }}

Valores por Defecto​

replicas: {{ .Values.replicaCount | default 3 }}
image: {{ .Values.image.repository | default "nginx" }}

Concatenación​

name: {{ printf "%s-%s" .Release.Name .Chart.Name }}

Include​

{{- include "my-chart.labels" . | nindent 4 }}

Hooks Helm​

Los Hooks permiten ejecutar Jobs o Pods en momentos específicos.

Tipos de Hooks​

  • pre-install: Antes de la instalación
  • post-install: Después de la instalación
  • pre-upgrade: Antes de la actualización
  • post-upgrade: Después de la actualización
  • pre-delete: Antes de la eliminación
  • post-delete: Después de la eliminación
  • pre-rollback: Antes del rollback
  • post-rollback: Después del rollback

Ejemplo: Pre-install Hook​

apiVersion: batch/v1
kind: Job
metadata:
  name: {{ .Release.Name }}-pre-install
  annotations:
    "helm.sh/hook": pre-install
    "helm.sh/hook-weight": "-5"
    "helm.sh/hook-delete-policy": before-hook-creation
spec:
  template:
    spec:
      containers:
      - name: pre-install
        image: busybox:1.35
        command: ["/bin/sh", "-c", "echo 'Pre-install hook'"]
      restartPolicy: Never

Ejemplo: Post-install Hook​

apiVersion: batch/v1
kind: Job
metadata:
  name: {{ .Release.Name }}-post-install
  annotations:
    "helm.sh/hook": post-install
    "helm.sh/hook-weight": "5"
spec:
  template:
    spec:
      containers:
      - name: post-install
        image: busybox:1.35
        command: ["/bin/sh", "-c", "echo 'Post-install hook'"]
      restartPolicy: Never

Anotaciones de Hooks​

hook-weight​

Controla el orden de ejecución:

"helm.sh/hook-weight": "-5"  # Ejecutado primero
"helm.sh/hook-weight": "5"   # Ejecutado al final

hook-delete-policy​

Cuándo eliminar el Hook:

  • before-hook-creation: Antes de la creación de un nuevo hook
  • hook-succeeded: Si el hook tiene éxito
  • hook-failed: Si el hook falla
"helm.sh/hook-delete-policy": "before-hook-creation,hook-succeeded"

Ejemplo Completo: Migración de Base de Datos​

Pre-upgrade Hook: Backup​

apiVersion: batch/v1
kind: Job
metadata:
  name: {{ .Release.Name }}-pre-upgrade-backup
  annotations:
    "helm.sh/hook": pre-upgrade
    "helm.sh/hook-weight": "-10"
spec:
  template:
    spec:
      containers:
      - name: backup
        image: postgres:14
        command:
        - /bin/bash
        - -c
        - |
          pg_dump -h {{ .Release.Name }}-postgres mydb > /backup/backup-$(date +%Y%m%d).sql
          aws s3 cp /backup/backup-$(date +%Y%m%d).sql s3://backups/
        env:
        - name: PGPASSWORD
          valueFrom:
            secretKeyRef:
              name: {{ .Release.Name }}-postgres-secret
              key: password
        volumeMounts:
        - name: backup
          mountPath: /backup
      volumes:
      - name: backup
        emptyDir: {}
      restartPolicy: Never

Post-upgrade Hook: Migración​

apiVersion: batch/v1
kind: Job
metadata:
  name: {{ .Release.Name }}-post-upgrade-migrate
  annotations:
    "helm.sh/hook": post-upgrade
    "helm.sh/hook-weight": "10"
spec:
  template:
    spec:
      containers:
      - name: migrate
        image: my-app:{{ .Values.appVersion }}
        command: ["/app/migrate.sh"]
        env:
        - name: DATABASE_URL
          value: postgresql://postgres:5432/mydb
      restartPolicy: OnFailure

Templates Reutilizables​

_helpers.tpl Avanzado​

{{/*
Labels comunes
*/}}
{{- define "my-chart.labels" -}}
app.kubernetes.io/name: {{ include "my-chart.name" . }}
app.kubernetes.io/instance: {{ .Release.Name }}
app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
app.kubernetes.io/managed-by: {{ .Release.Service }}
{{- end }}

{{/*
Selector labels
*/}}
{{- define "my-chart.selectorLabels" -}}
app.kubernetes.io/name: {{ include "my-chart.name" . }}
app.kubernetes.io/instance: {{ .Release.Name }}
{{- end }}

{{/*
Nombre del Chart
*/}}
{{- define "my-chart.name" -}}
{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
{{- end }}

{{/*
Nombre completo
*/}}
{{- define "my-chart.fullname" -}}
{{- if .Values.fullnameOverride }}
{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
{{- else }}
{{- $name := default .Chart.Name .Values.nameOverride }}
{{- if contains $name .Release.Name }}
{{- .Release.Name | trunc 63 | trimSuffix "-" }}
{{- else }}
{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
{{- end }}
{{- end }}
{{- end }}

Buenas Prácticas​

1. Utilizar los Helpers​

Crear helpers reutilizables en _helpers.tpl.

2. Condiciones Apropiadas​

Utilizar condiciones para hacer los templates flexibles.

3. Hooks Adecuados​

Utilizar los hooks solo cuando sea necesario (migraciones, backups).

4. Documentación​

Documentar los hooks y su propósito.

5. Pruebas​

Probar los hooks con --dry-run.

Resumen​

En este capítulo, usted ha aprendido:

Funciones avanzadas: Condiciones, bucles, valores por defecto, concatenación
Hooks: Pre/post install/upgrade/delete/rollback
Anotaciones: hook-weight, hook-delete-policy
Casos de uso: Migraciones, backups, inicialización
Templates reutilizables: Helpers en _helpers.tpl
Buenas prácticas: Helpers, condiciones, hooks adecuados, pruebas

Próximos Pasos​

Módulo 11: Monitoreo y Observabilidad
Lab 10.4: Helmfile y Multi-ambientes

Capítulo creado el: Diciembre 2024