Set-OPS-Public/roles/serveur_grafana/tasks/main.yml
Daniel Allaire f2c580235d observabilite : le site cesse de ne rien voir de lui-meme
D-87 disait que l hebergeur n a pas le droit de voir les journaux de ses
locataires. La decision avait une face cachee : a force de refuser de voir
ceux des autres, le site s etait prive des siens. Ses sept machines
n expediaient nulle part.

Il prend donc sa propre pile : prometheus, loki et grafana sur site-mon-01,
sans aucun lien avec ceux d un tenant. L exemption qui bloquait portait sa
propre condition de levee, ecrite cinq jours plus tot dans le plan.

Grafana au site n a pas de SSO, et le role l ignorait : il reclamait l IdP
avant de regarder s il en voulait un. L interrupteur existait, il n etait
pas honore. Le role refuse desormais SSO eteint ET formulaire local eteint
- la combinaison deploie un Grafana en sante ou personne ne peut entrer -
et le reglage du formulaire sort du if du SSO, ou il disparaissait en
laissant le defaut amont decider en silence.

Deux manques se cachaient l un l autre dans le devis de la frontiere, et
Prometheus voyait 1 cible sur 7 :

  - le devis derivait les groupes d une machine du site de applications.yml
    seul, et ne voyait donc aucune integration universelle - alors que
    client_metrique ouvre un port d ecoute ;
  - une sortie vers un role du site visait !SETOPS_INTERNES, qui exclut
    precisement la machine nommee. Le devis autorisait a expedier les
    journaux du site a n importe quel Loki du monde, et a nul autre endroit
    qu a celui-la. Neuf flux dans ce cas.

Et deux declarations justes ne font qu une regle : appliquer_opnsense pose
tout en direction: in (D-61).

Les deux agents se supervisent enfin eux-memes. La sonde des journaux ne
demande pas si Alloy tourne, elle lit ce qu il a du JETER. Elle a fait ses
preuves le jour meme : Alloy actif, /-/ready a 200, et cinquante lignes
perdues sur six machines.

Mesure : metriques 7/7 vert, journaux 1/7 - les six autres attendent la
regle de frontiere, et le disent. prouver 64 OK, ansible-lint 0 defaut.

Reste a la main de l exploitant : make frontiere-appliquer CONFIRMER=true,
et le secret vault_grafana_admin a deposer dans underlay.vault.yml.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Crgis8CxCWkAGFA1ecBz3q
2026-09-10 04:43:01 -04:00

261 lines
10 KiB
YAML

---
# UNE PORTE AU MOINS. Sans SSO et sans formulaire local, Grafana demarre, se porte
# bien, et personne n'entre. Les deux reglages sont independants et se sont deja
# retrouves a `false` ensemble : la combinaison se refuse ici, pas apres le
# deploiement, quand plus aucun chemin ne mene a la console.
- name: Exiger au moins un chemin de connexion
ansible.builtin.assert:
that:
- (serveur_grafana_oidc_actif | bool) or (serveur_grafana_connexion_locale | bool)
fail_msg: >-
Ni SSO (`serveur_grafana_oidc_actif`) ni formulaire local
(`serveur_grafana_connexion_locale`) : Grafana n'aurait aucune porte d'entree.
# L'URL PUBLIQUE de l'IdP se derive de l'exposition declaree au plan, elle ne se
# fabrique pas : `keycloak.<domaine>` n'est publie nulle part (voir resoudre_idp).
#
# ON NE RESOUT QUE CE QU'ON UTILISE. Le role reclamait l'IdP AVANT de regarder s'il
# en voulait un : au site, qui n'a ni Keycloak ni `domaines.yml` (D-87 : l'identite
# ne monte pas), le deploiement echouait sur un registre absent — pour derive une URL
# qu'aucun gabarit n'allait ecrire. L'interrupteur existait, il n'etait pas honore.
- name: Resoudre le fournisseur d'identite (role partage)
ansible.builtin.include_role:
name: resoudre_idp
vars:
resoudre_idp_realm: "{{ serveur_grafana_oidc_realm }}"
when: serveur_grafana_oidc_actif | bool
- name: Exiger le mot de passe admin Grafana (Vault)
ansible.builtin.assert:
that:
- serveur_grafana_admin_password | length > 0
fail_msg: "serveur_grafana_admin_password est requis (Ansible Vault)."
- name: Assurer le repertoire des trousseaux apt
ansible.builtin.file:
path: /etc/apt/keyrings
state: directory
owner: root
group: root
mode: "0755"
# Recuperee UNE FOIS. Sans garde, chaque deploiement recontactait le serveur du
# fournisseur : cinq cles x quatorze hotes = soixante-dix allers-retours externes pour
# des cles deja installees, et autant d'occasions qu'un tiers lent fasse tomber le
# deploiement. Arbitrage rendu le 2026-08-09 : une plateforme souveraine ne depend pas
# de six serveurs etrangers pour redeployer ce qu'elle possede deja.
#
# CONSEQUENCE ASSUMEE : une rotation de cle amont n'est plus recuperee toute seule. Elle
# ne passe pas inapercue pour autant — `apt` refuse alors le depot, bruyamment. Pour
# forcer le rafraichissement : supprimer le fichier et rejouer le role.
- name: Cette ressource est-elle deja recuperee ? (Telecharger la cle de signature Gr)
ansible.builtin.stat:
path: "{{ serveur_grafana_depot_cle_fichier }}"
register: telecharger_la_cle_de_signature_grafana_present
- name: Telecharger la cle de signature Grafana
when: not telecharger_la_cle_de_signature_grafana_present.stat.exists
ansible.builtin.get_url:
url: "{{ serveur_grafana_depot_cle_url }}"
dest: "{{ serveur_grafana_depot_cle_fichier }}"
owner: root
group: root
mode: "0644"
- name: Ajouter le depot apt Grafana
ansible.builtin.apt_repository:
repo: "{{ serveur_grafana_depot_source }}"
filename: grafana
state: present
# LE CACHE DU CONTROLEUR D'ABORD, LE DEPOT DISTANT POUR LE RESTE (2026-09-03).
#
# Les depots tiers sont en HTTPS, et `client_artefacts` pose
# `Acquire::https::Proxy "DIRECT"` — ils CONTOURNENT donc le cache du site et sortent sur
# Internet a chaque construction de VM. `make cacher-paquets` les tire une fois, versions
# epinglees et empreintes verifiees ; ce role les depose depuis ce cache.
- name: Poser les paquets tiers depuis le cache du controleur
ansible.builtin.include_role:
name: paquets_tiers
vars:
paquets_tiers_noms: "{{ serveur_grafana_paquets }}"
- name: Installer Grafana
ansible.builtin.apt:
# CE QUE LE CACHE N'A PAS FOURNI, ET RIEN D'AUTRE. Les dependances Debian passent
# par le cache du site en HTTP ; seuls les paquets tiers non caches exigent Internet.
# Reinstaller ce que le cache vient de poser ferait un `update_cache` inutile — et
# hors ligne, il echouerait APRES un travail deja fait.
name: "{{ serveur_grafana_paquets | difference((paquets_tiers_disponibles | default({})).keys() | list) }}"
state: present
update_cache: true
when: (serveur_grafana_paquets
| difference((paquets_tiers_disponibles | default({})).keys() | list)) | length > 0
- name: Provisionner les datasources (Prometheus + Loki)
ansible.builtin.template:
src: datasources.yaml.j2
dest: /etc/grafana/provisioning/datasources/setops.yaml
owner: root
group: grafana
mode: "0640"
notify: Redemarrer grafana
- name: Assurer le repertoire des dashboards
ansible.builtin.file:
path: "{{ serveur_grafana_dashboards_dir }}"
state: directory
owner: root
group: grafana
mode: "0750"
- name: Deployer le provisioning des dashboards
ansible.builtin.template:
src: dashboards.yaml.j2
dest: /etc/grafana/provisioning/dashboards/setops.yaml
owner: root
group: grafana
mode: "0640"
notify: Redemarrer grafana
- name: Deployer les dashboards Set-OPS
ansible.builtin.copy:
src: dashboards/
dest: "{{ serveur_grafana_dashboards_dir }}/"
owner: root
group: grafana
mode: "0640"
directory_mode: "0750"
notify: Redemarrer grafana
- name: Assurer le repertoire de drop-in systemd
ansible.builtin.file:
path: /etc/systemd/system/grafana-server.service.d
state: directory
owner: root
group: root
mode: "0755"
- name: Deployer la configuration d'environnement (domaine + secret)
ansible.builtin.template:
src: setops.conf.j2
dest: /etc/systemd/system/grafana-server.service.d/setops.conf
owner: root
group: root
mode: "0600"
no_log: true
notify: Redemarrer grafana
- name: Activer et demarrer Grafana
when: not ansible_check_mode
ansible.builtin.systemd:
name: "{{ serveur_grafana_service }}"
enabled: true
state: started
daemon_reload: true
# --- ROTATION DU COMPTE DE SECOURS -------------------------------------------
# `GF_SECURITY_ADMIN_PASSWORD` n'agit qu'a la CREATION du compte : changer la voute
# ne changeait rien, et la voute se mettait a mentir en silence. Le runbook de
# reprise (docs/autorisation.md §6) promet pourtant cette rotation — c'est ce qui
# transforme une livraison en transfert. Constate le 2026-08-07.
#
# Idempotence par EMPREINTE : on garde le sha256 du secret applique. Tant qu'il ne
# change pas, on ne touche a rien ; des qu'il change, on reapplique. On ne peut pas
# lire le mot de passe en place, donc on memorise ce qu'on a pose.
# EXIGER QUE LE SERVEUR REPONDE AVANT DE TOUCHER A SA BASE. La CLI qui suit echouait
# sinon cinq fois de suite sous `no_log`, en annoncant « the output has been hidden » —
# alors que la vraie cause etait ailleurs et parfaitement lisible : `grafana-server` ne
# demarrait pas, sa base ayant echoue une migration au premier lancement (2026-08-10,
# `no such column: uid`). Cinq reprises censurees contre un message clair : on prefere
# le message.
- name: Attendre que Grafana réponde avant de toucher au compte de secours
ansible.builtin.wait_for:
host: 127.0.0.1
port: "{{ serveur_grafana_port | default(3000) }}"
timeout: 120
register: serveur_grafana_pret
failed_when: false
when: not ansible_check_mode
- name: Dire que Grafana ne répond pas, plutôt que d'échouer sur sa CLI
ansible.builtin.fail:
msg: >-
Grafana n'écoute pas sur le port {{ serveur_grafana_port | default(3000) }} après
120 s : la rotation du compte de secours ne peut pas aboutir, et sa CLI ne dirait
rien d'utile. Regarder `journalctl -u grafana-server` — et y chercher la PREMIÈRE
erreur, pas la dernière : `Restart=on-failure` en empile plusieurs.
when:
- not ansible_check_mode
- serveur_grafana_pret is failed
- name: Empreinte du mot de passe admin en place
ansible.builtin.slurp:
src: "{{ serveur_grafana_marqueur_admin }}"
register: serveur_grafana_marque
failed_when: false
changed_when: false
no_log: true
- name: Appliquer le mot de passe du compte de secours (rotation)
ansible.builtin.command:
argv:
- grafana-cli
- "--homepath={{ serveur_grafana_homepath }}"
# `paths.data` DOIT etre impose : la CLI le prend par defaut a
# `<homepath>/data`, alors que le paquet Debian range la base dans
# /var/lib/grafana. Sans lui, la CLI cree une base FANTOME, y ecrit, et
# annonce « Admin password changed successfully » — pendant que le serveur
# lit l'autre. Constate le 2026-08-07 : le compte n'avait pas bouge depuis
# le deploiement initial, malgre quatre reinitialisations « reussies ».
- "--configOverrides=cfg:default.paths.data={{ serveur_grafana_donnees }}"
- admin
- reset-admin-password
- "{{ serveur_grafana_admin_password }}"
no_log: true
# La tache ne s'execute QUE si l'empreinte differe : quand elle tourne, elle
# change reellement le mot de passe.
changed_when: true
# PATIENTE : sur une machine neuve, cette commande suit de peu le premier
# demarrage de grafana-server, qui cree encore sa base. La CLI echoue alors sur
# une base absente ou verrouillee. Constate le 2026-08-08 pendant la premiere
# reconstruction from-zero ; rejouee seule quelques minutes plus tard, la meme
# commande passe. Meme classe que l'ecriture Keycloak qui suit la synchro LDAP :
# une COURSE de premier demarrage, pas une panne. On attend une condition, pas
# une duree.
register: serveur_grafana_reset
retries: 5
delay: 10
until: serveur_grafana_reset is succeeded
when: >-
(serveur_grafana_marque.content | default('') | b64decode | trim)
!= (serveur_grafana_admin_password | hash('sha256'))
notify: Redemarrer grafana
- name: Retenir l'empreinte appliquee
ansible.builtin.copy:
content: "{{ serveur_grafana_admin_password | hash('sha256') }}\n"
dest: "{{ serveur_grafana_marqueur_admin }}"
owner: root
group: root
mode: "0600"
no_log: true
# --- Sonde de supervision (docs/supervision-conception.md) --------------------------
# Le role qui possede la verite depose sa propre sonde ; le porteur (`client_sante`) la
# fait tourner et pousse le verdict, sans savoir ce qu'elle mesure.
- name: Assurer le repertoire des sondes de supervision
ansible.builtin.file:
path: /usr/local/lib/setops/sondes
state: directory
owner: root
group: root
mode: "0755"
- name: Deposer la sonde « tableaux »
ansible.builtin.template:
src: sonde-tableaux.sh.j2
dest: /usr/local/lib/setops/sondes/tableaux.sh
owner: root
group: root
mode: "0750"