Application deployment using GitOps and  Flux

Hola a todos,

El diagrama representa un modelo GitOps pull-based con Flux v2 sobre AKS. El desarrollador realiza cambios en código, manifiestos Kubernetes, Helm charts o configuraciones Kustomize y los publica en Git. Flux, instalado dentro del clúster mediante la extensión microsoft.flux, consulta continuamente el repositorio, compara el estado deseado con el estado real del clúster y aplica los cambios necesarios. Microsoft soporta este patrón tanto en AKS como en Kubernetes habilitado con Azure Arc. Microsoft Learn

Flux instala por defecto controladores para Source, Kustomize, Helm y Notification, y puede ampliar capacidades con image-automation e image-reflector. El resultado es un modelo declarativo, versionado, auditable y con reconciliación continua, en el que Git se convierte en la fuente de verdad. Microsoft Learn

2.- Configuración paso a paso detallada

Paso 1. Preparar AKS

Parte de un clúster AKS existente y operativo.

RG="rg-aks-prod"
AKS="aks-prod"
az aks show \
--resource-group $RG \
--name $AKS \
--output table

Para una arquitectura enterprise conviene acompañarlo de Private AKS, Microsoft Entra ID, Azure RBAC, Workload Identity, Azure CNI y Network Policies.

Paso 2. Preparar el repositorio Git

Git será el source of truth.

Una estructura posible:

gitops/
├── apps/
│ ├── frontend/
│ │ └── kustomization.yaml
│ └── backend/
│ └── kustomization.yaml
│
├── helm-charts/
│ └── my-app/
│ ├── Chart.yaml
│ └── values.yaml
│
└── clusters/
├── dev/
├── test/
└── prod/

Flux admite Git, Helm, buckets y Azure Blob Storage como orígenes, además de YAML, Helm y Kustomize como formatos de despliegue. Microsoft Learn

Paso 3. El desarrollador realiza Commit / PR

El flujo inicial es:

Developer
↓
Commit / Pull Request
↓
Git Repository

Ejemplo:

git add .
git commit -m "Update backend deployment"
git push origin feature/backend-v2

Para producción:

Feature Branch
↓
Pull Request
↓
Review
↓
Approval
↓
Merge

Paso 4. Habilitar Flux v2 en AKS

Flux se habilita mediante la extensión:

Microsoft.KubernetesConfiguration/extensions/microsoft.flux

La extensión puede instalarse automáticamente al crear la primera fluxConfiguration, o manualmente. Microsoft Learn

Ejemplo:

az k8s-extension create \
--name flux \
--extension-type microsoft.flux \
--cluster-type managedClusters \
--cluster-name $AKS \
--resource-group $RG

Paso 5. Crear la Flux Configuration

La fluxConfiguration conecta AKS con Git.

Ejemplo:

az k8s-configuration flux create \
--resource-group $RG \
--cluster-name $AKS \
--cluster-type managedClusters \
--name flux-prod \
--namespace flux-system \
--scope cluster \
--kind git \
--url https://github.com/company/platform-gitops \
--branch main \
--kustomization name=prod path=./clusters/prod prune=true

El comando az k8s-configuration flux create está soportado en GA para administrar configuraciones Flux v2. Microsoft Learn

Paso 6. Entender los controladores de Flux

La extensión instala normalmente:

Flux
├── source-controller
├── kustomize-controller
├── helm-controller
└── notification-controller

Funciones:

source-controller
→ obtiene contenido desde Git, Helm, OCI, etc.
kustomize-controller
→ construye y aplica manifiestos Kustomize
helm-controller
→ gestiona HelmRelease
notification-controller
→ eventos, alertas y notificaciones

Opcionalmente:

image-reflector-controller
image-automation-controller

para automatización de imágenes. Microsoft Learn

Paso 7. Flux realiza Sync mediante Pull

El modelo es:

Git Repository
↑
│ Pull
│
Flux Controllers
↓
AKS

Este es uno de los puntos más importantes del diseño: Git no necesita conectarse al API Server del clúster. Los controladores ejecutándose dentro de AKS extraen la configuración. Microsoft Learn

Paso 8. Aplicar Kustomize

Flux puede utilizar una Kustomization.

Conceptualmente:

Git
↓
source-controller
↓
kustomize-controller
↓
AKS resources

Ejemplo de estructura:

clusters/prod/
└── kustomization.yaml

y recursos:

Deployment
Service
Ingress
ConfigMap
Namespace

Microsoft documenta explícitamente el uso del controlador Kustomize para administrar configuración del clúster. Microsoft Learn

Paso 9. Desplegar Helm Charts

Flux también puede administrar Helm.

Flujo:

Git / Helm Repository
↓
source-controller
↓
helm-controller
↓
HelmRelease
↓
AKS

Esto permite versionar:

Chart version
Values
Environment configuration

Microsoft soporta la administración de releases Helm mediante Flux v2. Microsoft Learn

Paso 10. Aplicar el estado deseado

Flux compara:

Desired State
↑
Git
vs.
Actual State
↑
AKS

Si detecta diferencias:

Git changed
↓
Flux detects change
↓
Apply
↓
AKS updated

Paso 11. Reconciliación continua

El proceso no termina después del deploy.

Flux mantiene un loop:

Git
↓
Flux
↓
AKS
↑
Compare
└───────── Continuous Reconciliation

Microsoft describe esta reconciliación continua como una de las principales ventajas del modelo GitOps con Flux. Microsoft Learn

Paso 12. Detectar Drift

Si alguien modifica manualmente:

Deployment replicas: 3

a:

Deployment replicas: 7

pero Git sigue declarando:

replicas: 3

Flux detectará drift:

Actual state != Desired state
↓
Flux reconciliation
↓
replicas restored to 3

Esto proporciona self-healing.

Paso 13. Habilitar Prune

Cuando un recurso desaparece de Git, puede configurarse prune=true.

Ejemplo:

Git:
service-old.yaml removed
↓
Flux
↓
Service removed from AKS

Así Git sigue siendo la única fuente de verdad.

Paso 14. Separar entornos

Una estructura recomendable:

clusters/
├── dev/
│ └── kustomization.yaml
├── test/
│ └── kustomization.yaml
└── prod/
└── kustomization.yaml

Puedes crear una fluxConfiguration por entorno o clúster.

Paso 15. Aplicar dependencias

Flux permite definir dependencias entre Kustomizations.

Ejemplo:

Infrastructure
↓
Namespaces
↓
Platform Services
↓
Applications

Esto ayuda a garantizar orden de despliegue. Microsoft incluye este escenario en su tutorial oficial de Flux v2. Microsoft Learn

Paso 16. Gestionar secretos con SOPS

Para secretos en Git evita almacenar valores sin cifrar.

Un patrón:

Secret
↓
SOPS encrypted file
↓
Git
↓
Flux
↓
Decrypt in cluster
↓
Kubernetes Secret

Así el repositorio mantiene la configuración versionada sin exponer secretos.

Paso 17. Integrar Workload Identity

Flux puede utilizar Workload Identity para autenticarse contra recursos compatibles.

El comando flux create incluye soporte para:

--use-workload-identity
``` citeturn147775search0turn147775search2
Conceptualmente:
```text
Flux Pod
↓
Service Account
↓
OIDC federation
↓
Microsoft Entra ID
↓
Azure resource

Esto evita credenciales persistentes.

Paso 18. Automatización de imágenes

Opcionalmente instala:

image-reflector-controller
image-automation-controller

El patrón puede ser:

CI Pipeline
↓
Build image
↓
ACR
↓
Flux Image Reflector
↓
Detect new tag
↓
Update Git manifest
↓
Flux reconciliation
↓
AKS

Los controladores de image automation están soportados como componentes opcionales de la extensión Flux. Microsoft Learn

Paso 19. Separar CI de CD

Una arquitectura madura usa:

CI
Developer
↓
Pipeline
↓
Build / Test
↓
ACR

y:

CD / GitOps
Git Repository
↓
Flux
↓
AKS

Esta separación es uno de los patrones recomendados por Microsoft en sus arquitecturas CI/CD con GitOps. Microsoft Learn

Paso 20. Monitorizar Flux

Puedes monitorizar:

Reconciliation status
Git connectivity
HelmRelease health
Kustomization errors
Sync duration
Drift

y enviarlo a tu stack:

Flux
↓
Azure Monitor
↓
Managed Prometheus
↓
Managed Grafana

Paso 21. Configurar notificaciones

El notification-controller puede enviar eventos relacionados con reconciliación.

Por ejemplo:

Flux event
↓
Notification Controller
↓
Teams / Email / Webhook

Esto es útil para:

Failed reconciliation
Helm failure
Git unavailable
Deployment drift

Paso 22. Diseñar multi-tenancy

En AKS compartido:

AKS
├── team-a
├── team-b
└── platform

Combina:

Namespaces
RBAC
Service Accounts
Workload Identity
Flux configurations
Network Policies

Flux admite escenarios multi-tenant y está diseñado para separar lógicamente el plano de control por clúster. Microsoft Learn

Paso 23. Validar Flux

Ver configuraciones:

az k8s-configuration flux list \
--resource-group $RG \
--cluster-name $AKS \
--cluster-type managedClusters \
--output table

Ver una configuración:

az k8s-configuration flux show \
--resource-group $RG \
--cluster-name $AKS \
--cluster-type managedClusters \
--name flux-prod

Microsoft dispone también de comandos para ver los objetos desplegados asociados a una configuración Flux. Microsoft Learn

Paso 24. Validar dentro de AKS

Puedes comprobar:

kubectl get pods -n flux-system

y recursos Flux:

kubectl get gitrepositories -A
kubectl get kustomizations -A
kubectl get helmreleases -A

El estado esperado debería ser:

Ready=True

Paso 25. Flujo end-to-end

El diagrama se puede resumir así:

Developer
│
│ 1. Commit / PR
▼
Git Repository
│
│ 2. Pull
▼
Flux
├── Source Controller
├── Kustomize Controller
├── Helm Controller
└── Notification Controller
│
│ 3. Apply
▼
AKS
├── Deployments
├── StatefulSets
├── Services
├── ConfigMaps
└── Ingress
│
│ 4. Continuous reconciliation
└──────────────────────► Git Desired State

Si hay drift:

Manual change
↓
AKS differs from Git
↓
Flux detects difference
↓
Self-healing
↓
AKS returns to Git state

3.- Reflexiones finales

Flux convierte Git en la fuente de verdad del clúster y cambia el modelo tradicional de push deployment por un modelo pull + continuous reconciliation. Esto mejora seguridad, trazabilidad, rollback y consistencia operacional porque el clúster no depende de que un pipeline externo tenga acceso directo a su API Server.

Para una plataforma AKS empresarial, el patrón más sólido sería CI → ACR para construir imágenes y Git → Flux → AKS para desplegarlas, complementado con Workload Identity, RBAC, SOPS, Network Policies, observabilidad y separación por entornos. Flux v2 sigue siendo una opción GitOps nativa y plenamente soportada por Microsoft para AKS. Microsoft Learn

Deja una respuesta