Instalación
26.1 25.2 25.1
26.1 25.2 25.1 Spanish English

CheatSheets k8s

Comandos disponibles - Kit 26.1.1

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 certificados TLS (autofirmados por namespace en anjana-certs/<namespace>/ si no se aportan) y los Secrets anjanadr, anjana-keystore, anjana-secrets y anjana-config. Se para si el certificado no cubre horus.<namespace>.svc.cluster.local. Namespace por defecto: anjana-data.

anjana horus apply [namespace]

Descifra el bundle secrets/anjana.env.aes y crea/actualiza los Secrets anjana-secrets y anjana-config 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 (si falta, se pide); ANJANA_DR_USER / ANJANA_DR_PASS se usan para el pull secret del registry. Para certificados propios: ANJANA_KEYSTORE_P12, ANJANA_CACERTS, ANJANA_FULLCHAIN_PEM, ANJANA_PRIVKEY_PEM y, opcional, ANJANA_CA_PEM.

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. Con PostgreSQL gestionado o externo, el volcado base debe estar cargado antes; con PostgreSQL in-cluster, se carga después (ver Manual de despliegue, "Volcado base de PostgreSQL"). Sin backend cloud, el hook anjana-db-schemas crea los esquemas de PostgreSQL.

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 get secret anjana-config -n anjana-data -o jsonpath='{.data}' \| jq 'keys'

Comprueba que anjana-config tiene la clave application.properties (backend native de Horus).

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).

Horus (Spring Boot Admin y Eureka)


kubectl -n anjana-data port-forward pod/horus-0 9999:9999

Abre el acceso local a horus. El frontal no expone Spring Boot Admin ni Eureka.

https://localhost:9999/admin

Spring Boot Admin (con el port-forward activo).

https://localhost:9999/balancer

Eureka Dashboard (con el port-forward activo).

kubectl -n anjana-data exec -it horus-0 -- curl -sk https://horus:9999/portuno/default \| jq

Configuración efectiva que Horus sirve a un servicio (aquí, portuno).

Validación


make test

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

Last updated: