1 h 30 (S9.1 : 45 min · S9.2 : 45 min)
M08 terminé (flotte-web en Rollout)
un composant flotte-api packagé par Helm, flotte-web décrit une fois et décliné en dev, recette, prod
45 min
flotte-api-devArgoCD + Helm = helm template (repo-server) + apply (contrôleur)| Aspect | helm install |
Chart via ArgoCD |
|---|---|---|
| Historique | Secrets de release Helm | Historique ArgoCD (M06) |
helm list |
Release visible | Vide |
| Retour arrière | helm rollback |
git revert ou app rollback |
| Hooks Helm | Exécutés par Helm | Traduits en hooks ArgoCD |
| Dérive | Non détectée | Détectée, corrigée (self-heal) |
source:
repoURL: https://stefanprodan.github.io/podinfo # dépôt de charts HTTP
chart: podinfo
targetRevision: 6.17.0 # version du chart
helm:
releaseName: flotte-apirepoURL: <REGISTRE>/<CHEMIN> sans oci:// ; privé : Secret avec enableOCIChart.yaml : path au lieu de chartsourceRepos du projetparameters > valuesObject > values > valueFiles > values.yaml du chart| Champ | Forme | Usage |
|---|---|---|
valueFiles |
Fichiers (chart ou $values) |
Valeurs par environnement, versionnées |
values |
Bloc de texte YAML | Historique, à éviter |
valuesObject |
Objet YAML validé | Quelques valeurs dans l'Application |
parameters |
Liste nom / valeur | Surcharge ponctuelle (--helm-set) |
valueFiles (1) < valuesObject (3) < parameters (2) → 2 réplicas$valuesflowchart LR Chart["Dépôt de charts<br/>podinfo 6.17.0"] --> App["Application<br/>flotte-api-dev"] Cfg["flotte-config<br/>helm/flotte-api/"] -- "ref: values" --> App App --> K8s["flotte-dev"]
flotte-config/helm/flotte-api/, revues comme le reste de la configurationargocd/flotte-api-dev.yaml (extrait)sources:
- repoURL: https://stefanprodan.github.io/podinfo
chart: podinfo
targetRevision: 6.17.0
helm: {valueFiles: [$values/helm/flotte-api/values-common.yaml,
$values/helm/flotte-api/values-dev.yaml]}
- repoURL: https://gitlab.com/<GITLAB_USER>/flotte-config.git
targetRevision: main
ref: valuesflotte-api-dev
argocd app manifests flotte-api-dev | grep -E 'replicas:|UI_MESSAGE|UI_COLOR|image:' -A1Sortie attendue (extrait) :
replicas: 1
- name: PODINFO_UI_MESSAGE
value: Hexa Mobilite - API
- name: PODINFO_UI_COLOR
value: '#2e7d32'
image: ghcr.io/stefanprodan/podinfo:6.17.0Sync Status: Synced to 6.17.0 : révision = version du chart6.17.0), jamais * ni une plagehelm template flotte-api podinfo --repo <URL> -f values-dev.yamlparameters réservés aux surcharges temporaires (non tracées dans Git)valueFiles dans l'ordre alphabétique avec un joker (*.yaml) : le dernier fichier gagne
45 min
devOverlay = Base + écarts explicites de l'environnementflowchart TD B["base/<br/>Rollout, Services, hooks"] --> D["overlays/dev<br/>image 6.17.0, canari"] B --> R["overlays/recette<br/>bleu-vert, 2 réplicas"] B --> P["overlays/prod<br/>4 réplicas"]
path: apps/flotte-web/overlays/devapps/flotte-web/ et apps/flotte-web-recette/ dupliqués (dérive entre copies)apps/flotte-web/base/kustomization.yaml (extrait)configurations: [rollout-transform.yaml] # Kustomize comprend le Rollout
resources: [rollout.yaml, service.yaml, service-canary.yaml, analysis-template.yaml,
hook-presync-migration.yaml, hook-postsync-smoke-test.yaml]
configMapGenerator:
- name: flotte-web-config
literals: ["PODINFO_UI_MESSAGE=Hexa Mobilite - suivi de flotte"]
images:
- {name: ghcr.io/stefanprodan/podinfo, newTag: 6.16.0}rollout-transform.yaml : fourni par Argo Rollouts (version Kustomize 5)dev
resources: [../../base]
configMapGenerator:
- name: flotte-web-config
behavior: merge
literals: ["PODINFO_UI_MESSAGE=Hexa Mobilite - DEV"]
images:
- {name: ghcr.io/stefanprodan/podinfo, newTag: 6.17.0}kubectl kustomize apps/flotte-web/overlays/dev | grep -E 'image: ghcr|config-'Sortie attendue :
name: flotte-web-config-4c48ggb2h2
image: ghcr.io/stefanprodan/podinfo:6.17.0resources: [../../base, service-preview.yaml]
replicas: [{name: flotte-web, count: 2}]
patches:
- target: {group: argoproj.io, kind: Rollout, name: flotte-web}
patch: |-
- op: replace
path: /spec/strategy
value: {blueGreen: {activeService: flotte-web,
previewService: flotte-web-preview, autoPromotionEnabled: false}}op, path) : précis sur une ressource personnaliséereplicas : transformateur Kustomize (Rollout reconnu grâce à rollout-transform.yaml)Avant (M06): message modifié dans la ConfigMap → pods inchangés, ancien message servi
Après (générateur): flotte-web-config-4c48ggb2h2 → flotte-web-config-fckt6km9b8 → nouveaux pods
options:
annotations:
argocd.argoproj.io/sync-wave: "-1"
argocd.argoproj.io/sync-options: Prune=false
argocd.argoproj.io/compare-options: IgnoreExtraneousPrune=false : ancienne ConfigMap supprimée alors que la version stable l'utiliseflotte-web-devConfigMap flotte-dev flotte-web-config-4c48ggb2h2 OutOfSync ignored (no prune)
ConfigMap flotte-dev flotte-web-config-fckt6km9b8 Synced createdSynced malgré l'ancienne ConfigMap (IgnoreExtraneous)abort d'un canari : la version stable retrouve sa configuration| Critère | Helm | Kustomize |
|---|---|---|
| Point de départ | Chart paramétré (gabarits) | YAML brut + patchs |
| Logiciel tiers | Format standard des éditeurs | Rare |
| Variantes par environnement | Fichiers de valeurs | Overlays |
| Lisibilité du rendu | Gabarits Go | Proche du YAML final |
helmCharts) : kustomize.buildOptions: --enable-helm dans argocd-cmhelm template), cycle de vie géré par ArgoCDparameters > valuesObject > values > valueFiles ; $values pour des valeurs dans GitconfigMapGenerator : changement de configuration = pods redémarrésPrune=false + IgnoreExtraneous (documentation ArgoCD)helm list est-il vide pour une application Helm déployée par ArgoCD ?helm template) sans créer de release Helmhelm template, aucune release Helm n'est créée.valueFiles, valuesObject et parameters. Laquelle s'applique ?valueFilesvaluesObjectparametersvalues.yaml du chartparameters a la priorité la plus haute.ref: values ?$values/...ref: values expose le dépôt aux autres sources sous $values/.kustomization.yaml ?configMapGenerator redémarre-t-il les pods à chaque changement ?rollout restartrollout-transform.yaml à la base ?rollout-transform.yaml décrit à Kustomize les chemins d'un Rollout (références, images, réplicas).Prune=false ?