Instalación

CheatSheets k8s

Comandos disponibles - Kit 26.k1

Referencia rápida de los comandos más habituales para la gestión de Anjana Data Platform con Helm y kubectl.

Gestión del kit (anjana CLI)


anjana horus update --from-env horus.env

Cifra el fichero horus.env y genera secrets/anjana.env.aes.

anjana horus update --from-json payload.json

Genera el bundle cifrado desde un payload JSON (uso en CI/automatización).

anjana setup [namespace]

Crea el namespace, los Secrets Kubernetes (anjanadr, anjana-keystore, anjana-secrets) y certificados TLS. Namespace por defecto: anjana-data.

anjana horus apply [namespace]

Descifra el bundle secrets/anjana.env.aes y crea/actualiza el Secret anjana-secrets en el cluster (sin regenerar TLS ni pull secrets).

NOTA: el CLI carga su configuración de anjana.env (copiar de anjana.env.example, queda fuera de Git) o de variables de entorno. LOCAL_AES_PASSPHRASE es obligatoria para anjana horus update/apply; ANJANA_DR_USER / ANJANA_DR_PASS se usan para el pull secret del registry.

Instalación y actualización (Helm)


helm dependency build

Descarga y empaqueta las dependencias del chart (subcharts anjana-core, anjana-persistences, anjana-plugins).

helm install anjana-platform . -f values-<env>.yaml -n anjana-data

Instalación inicial de la plataforma completa. El hook config-init-job rellena la configuración de servicios automáticamente.

helm upgrade anjana-platform . -f values-<env>.yaml -n anjana-data

Actualiza la plataforma a la versión definida en los values.

helm uninstall anjana-platform -n anjana-data

Desinstala la plataforma (mantiene PVCs y Secrets).

helm rollback anjana-platform -n anjana-data

Revierte al release anterior en caso de fallo en el upgrade.

helm template anjana-platform . -f values-<env>.yaml -n anjana-data

Renderiza los manifiestos sin aplicarlos al cluster (útil para depuración).

helm lint . -f values-<env>.yaml

Valida la sintaxis del chart y los values sin cluster.

helm history anjana-platform -n anjana-data

Historial de releases Helm (versiones, fechas, estado).

helm get values anjana-platform -n anjana-data

Muestra los values activos en el release actual.

Estado del despliegue (kubectl)


kubectl get pods -n anjana-data

Lista todos los pods y su estado actual.

kubectl get pods -n anjana-data -w

Watch en tiempo real del estado de los pods. ✅RECOMENDADO para monitorizar arranques y actualizaciones.

kubectl describe pod <pod> -n anjana-data

Descripción detallada: eventos, condiciones, recursos, initContainers.

kubectl get all -n anjana-data

Lista todos los recursos en el namespace.

Logs


kubectl logs -n anjana-data <pod> -f

Visualización en directo de los logs. Añade -c <container> para pods multi-contenedor.

kubectl logs -n anjana-data <pod> --tail=200

Últimas 200 líneas de log.

kubectl logs -n anjana-data <pod> --since=2h

Logs de las últimas 2 horas.

kubectl logs -n anjana-data <pod> --previous

Logs del contenedor anterior si el pod ha crasheado. ✅RECOMENDADO para diagnosticar crashloops.

Acceso a pods (shell)


kubectl exec -it -n anjana-data horus-0 -- bash

Terminal interactiva en el pod de Horus.

kubectl exec -it -n anjana-data <pod> -- sh

Terminal en pods con shell mínima (frontales, persistencias).

Secrets y configuración


kubectl get secrets -n anjana-data

Lista los Secrets existentes en el namespace.

kubectl get secret anjana-secrets -n anjana-data -o jsonpath='{.data}' \| jq 'keys'

Lista las claves del Secret anjana-secrets sin mostrar valores.

kubectl rollout restart deployment <nombre> -n anjana-data

Reinicia un Deployment de forma ordenada (tras actualizar Secret o ConfigMap).

kubectl rollout restart statefulset horus -n anjana-data

Reinicia Horus (requerido para que tome nueva configuración del Config Server).

Validación


make test

Ejecuta lint + template render del chart (validación local sin cluster).