Daniel Allaire aab1bcc83a doc : rangee par lecteur, trois portes d'entree (architecture, setup, usage) et un index

README reduit au role du projet et au demarrage rapide. docs/architecture.md (schemas
Mermaid), docs/setup.md, docs/usage.md (154 cibles en 13 familles), docs/README.md (index).
Documents ranges en conception/, exploitation/, hebergement/, projet/ ; 598 chemins suivis.
QUICKSTART.md, SOLUTION.md, architecture-set-ops.md et la carte fondus puis retires.

Preuves : P48 lit l'index et conception/mecanismes.md ; les gardes parcourent docs/ sous-
dossiers compris (_documents) ; usage.md suit le Makefile dans les deux sens.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-15 01:01:54 -04:00

2 KiB

Raw Blame History

resoudre_base

Rôle utilitaire (pas un groupe déployable) : résout l'entrée de base de données d'un consommateur depuis le registre partagé instance/plan/bases-donnees.yml.

C'est la moitié « binding app→base » de la conception des liaisons — le lien est déclaré côté base (le registre nomme son consommateur), et résolu dans le rôle consommateur, pour que le secret ne quitte jamais ce rôle. Cf. docs/conception/bindings-conception.md §5.

Usage

- name: Résoudre la base depuis le registre (rôle partagé)
  ansible.builtin.include_role:
    name: resoudre_base
  vars:
    resoudre_base_groupe: serveur_keycloak

Entrée

Variable	Rôle
`resoudre_base_groupe`	Le groupe consommateur cherché dans le registre

Sorties (facts, persistent après `include_role`)

Fact	Contenu
`resoudre_base_entree`	L'entrée du registre (`base`, `proprietaire`, `secret`, `serveur`…)
`resoudre_base_db_password`	Mot de passe déréférencé de la voûte (`no_log`)
`resoudre_base_db_host`	FQDN du serveur de base
`resoudre_base_db_port`	Port (défaut `5432`)

Pourquoi le FQDN (et pas le nom court)

Décision d'architecture : non ambigu en fédération (data-sql-01 existe chez plusieurs tenants) et nom canonique pour la vérification TLS verify-full. Résolu par le plancher /etc/hosts (hosts_statiques).

Notes / limites

Le rôle assère la présence d'une entrée (base, proprietaire, secret) : aucun consommateur ne peut être déployé sans sa déclaration dans le plan. Message d'erreur explicite pointant instance/plan/bases-donnees.yml.
Le secret est déréférencé par lookup('vars', <nom>) : le registre ne contient que le nom de la variable de voûte, jamais sa valeur.
Un seul consommateur par entrée (le premier trouvé gagne).

Prérequis

setops_plan_dir défini ; voûte déverrouillée (ANSIBLE_VAULT_PASSWORD_FILE).

2 KiB Raw Blame History