Define Secrets (AKS)

En los secrets almacenamos los valores sensibles, como cadenas de conexión y API keys. Los secretos mantienen estos valores fuera del control de versiones y de las container images

Crear un secreto

Se puede crear un secreto directamente con kubectl create secret o desde ficheros secret.yaml

K8s ofrece diferentes tipos de secretos

  • kubernetes.io/dockerconfigjson para container registry credentials
  • kubernetes.io/tls para certificados TLS y keys
kubectl create secret generic app-secrets \
  --from-literal=DB_CONNECTION="Host=db;User=app;Password=secure" \
  --from-literal=API_KEY="your-api-key"

Referenciar secret values en un deployment

Después de crear un secreto se referencia en el manifest del Deployment. Podemos usar el valor valueFrom con secretKeyRef para referenciar a specific keys en el secreto.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-api
spec:
  replicas: 2
  selector:
    matchLabels:
      app: web-api
  template:
    metadata:
      labels:
        app: web-api
    spec:
      containers:
      - name: api
        image: myregistry.azurecr.io/web-api:v1
        env:
        - name: DB_CONNECTION
          valueFrom:
            secretKeyRef:
              name: app-secrets
              key: DB_CONNECTION
        - name: API_KEY
          valueFrom:
            secretKeyRef:
              name: app-secrets
              key: API_KEY

Verificar con kubectl

Listar y hacer un describe de los recursos para confirmar que el secreto existe y que el pod recibe la conf

kubectl get secrets
kubectl describe secret app-secrets
kubectl describe deployment web-api

Integrar con Azure services para centralizar secret management

Best practices

  • Restringir acceso con RBAC: dar permisos de secret view y modify
  • Evitar source control exposure: no hacer commit de secret manifest que tengan valores literales
  • Rotar credenciales
  • Integrar con Azure Key Vault para PROD: Se pueden rotar automáticamente con Key Vault CSI driver
  • Centralizar secret mappings con App Configuration: Usar App Configuration con referencias a Key Vault para mantener los secretos en un lugar centralizado