Los ConfigMaps se usan para guardar config no sensible como feature flags o service endpoints. Estos ConfigMaps luego se inyectan en las imágenes y el source code.
Define a ConfigMap
Un ConfigMap es un recurso que guarda config data como valores clave-valor.
apiVersion: v1
kind: ConfigMap
metadata:
name: app-settings
data:
FEATURE_X_ENABLED: "true"
SERVICE_ENDPOINT: "https://api.example.com"
# File-like configuration can use multi-line values
app.config: |
log_level=info
timeout_seconds=30
Consumir ConfigMaps en un deployment
Se inyecta la config en los pods a través de las variables de entorno. Podemos mapear valores específicos de un ConfigMap o inyectar directamente todos los valores.
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: FEATURE_X_ENABLED
valueFrom:
configMapKeyRef:
name: app-settings
key: FEATURE_X_ENABLED
- name: SERVICE_ENDPOINT
valueFrom:
configMapKeyRef:
name: app-settings
key: SERVICE_ENDPOINT
# Alternative: load all keys as environment variables
# envFrom:
# - configMapRef:
# name: app-settings
Montar ficheros como ConfigMaps
Podemos montar un fichero como si fuera la config. Esto se apoya en el uso de un Volumen.
# Code fragment - focus on volume mount
volumes:
- name: config-volume
configMap:
name: app-settings
# Optional: select specific keys to mount as files
# items:
# - key: app.config
# path: application.conf
containers:
- name: api
volumeMounts:
- name: config-volume
mountPath: /app/config
readOnly: true
Usar ConfigMaps inmutables
Un ConfigMap se puede marcar como inmutable para protegerlo contra cambios. Si quieres hacer cambios tienes que borrarlo y recrearlo. Esto funciona bien para configuración que no tiene que cambiar durante el runtime y para valores que cuando se cambian, hay que redesplegar.
apiVersion: v1
kind: ConfigMap
metadata:
name: app-settings-v2
data:
FEATURE_X_ENABLED: "true"
SERVICE_ENDPOINT: "https://api.example.com"
immutable: true
Integrar con Azure App Configuration
Se puede integrar AKS con Azure App Configuration para centralizar la config a lo largo de distintas apps y entornos.
Verificar con kubectl
kubectl apply -f configmap.yaml
kubectl apply -f deployment.yaml
kubectl describe configmap app-settings
kubectl describe deployment web-api
# Check if Pod received configuration as environment variables
kubectl exec <pod-name> -- printenv | grep FEATURE