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 Kustomizehelm-controller→ gestiona HelmReleasenotification-controller→ eventos, alertas y notificaciones
Opcionalmente:
image-reflector-controllerimage-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:
DeploymentServiceIngressConfigMapNamespace
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 versionValuesEnvironment configuration
Microsoft soporta la administración de releases Helm mediante Flux v2. Microsoft Learn
Paso 10. Aplicar el estado deseado
Flux compara:
Desired State ↑ Gitvs.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``` citeturn147775search0turn147775search2Conceptualmente:```textFlux 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-controllerimage-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:
CIDeveloper ↓Pipeline ↓Build / Test ↓ACR
y:
CD / GitOpsGit 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 statusGit connectivityHelmRelease healthKustomization errorsSync durationDrift
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 reconciliationHelm failureGit unavailableDeployment drift
Paso 22. Diseñar multi-tenancy
En AKS compartido:
AKS├── team-a├── team-b└── platform
Combina:
NamespacesRBACService AccountsWorkload IdentityFlux configurationsNetwork 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 -Akubectl get kustomizations -Akubectl 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