Le site portait trois services sur les sept du modele `origine`. Sa forge servait LE
GENOME EN CLAIR et aucune de ses machines n'avait de certificat — donc aucun chiffrement
est-ouest, ce que la doctrine zero-confiance interdit. site-pki-01 (step-ca) et
site-dns-01 (PowerDNS + resolveur colocalises) rejoignent les trois autres.
Quatre defauts que le site a fait tomber, chacun invisible chez un tenant :
- DNS bloque par notre propre default-deny. Un tenant a son resolveur DANS son reseau
et ne traverse jamais la frontiere ; le site interroge la sienne. La regle est derivee
de `site.dns_amorcage`, destination declaree, jamais `any`.
- serveur_cache_site n'installe rien : il marque un cache et lit les variables de
serveur_artefacts. Les defauts d'un role ne sont en portee que dans le play qui
l'inclut — une dependance de role regle l'ordre ET la portee.
- resoudre_idp partait meme avec OIDC desactive, et exigeait un plan. La resolution
suit desormais l'usage.
- le plancher /etc/hosts etait VIDE : `hotes_actifs` n'existait pas dans l'inventaire
du site. Un role qui reussit en n'ecrivant rien est la pire forme d'echec.
Une machine du site peut desormais se configurer (`variables:`), appliquee en dernier :
ce qu'une machine declare d'elle-meme prime sur ce que le site declare pour toutes.
Verifie et non suppose : systemd disait `active` mais rien n'ecoutait sur 443 — step-ca
sert sur 8443. La zone souveraine resout et la recursion marche, mesurees sur la machine.
42 preuves vertes, ansible-lint profil production.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
||
|---|---|---|
| .. | ||
| defaults | ||
| files | ||
| handlers | ||
| meta | ||
| tasks | ||
| templates | ||
| README.md | ||
serveur_forgejo
Forge Git Forgejo (binaire officiel) — dépôts Git, CI, revue de code.
Rôle
- Installe le binaire Forgejo (version épinglée, lien symbolique courant), utilisateur
git. - Crée l'arborescence (
/var/lib/forgejo,/etc/forgejo). - Base PostgreSQL via le registre (
instance/plan/bases-donnees.yml, entréeforgejo). app.ini: serveur derrière nginx (HTTP_ADDR=127.0.0.1,ROOT_URLhttps), DB, secrets, mailer versserveur_postfix, inscription désactivée,INSTALL_LOCK(pas d'assistant web).- Service systemd + création du compte administrateur initial (une fois).
Secrets requis (Vault)
serveur_forgejo_secret_key: "{{ vault_forgejo_secret_key }}" # forgejo generate secret SECRET_KEY
serveur_forgejo_internal_token: "{{ vault_forgejo_internal_token }}" # forgejo generate secret INTERNAL_TOKEN
serveur_forgejo_admin_password: "{{ vault_forgejo_admin }}"
vault_bd_forgejo: "..." # mot de passe BD (partage avec serveur_postgresql)
Variables principales
| Variable | Défaut | Rôle |
|---|---|---|
serveur_forgejo_version |
10.0.0 |
Version (à vérifier/bumper) |
serveur_forgejo_hostname |
forge.exemple.internal |
Domaine (via nginx) |
serveur_forgejo_db_host |
10.0.13.11 |
data-01 |
Identité visuelle (thème Alliance Boréale)
Désactivée par défaut : serveur_forgejo_branding: false. À true, le rôle copie
files/custom/ vers {{ serveur_forgejo_data }}/custom/ — logo, favicon, page
d'accueil et la feuille public/assets/css/alliance.css, injectée sur toutes les
pages par templates/custom/header.tmpl.
Le wiki n'a donc pas de thème distinct : Forgejo le rend avec le même habillage, et la feuille le couvre au même titre que les dépôts, les tickets et les README.
alliance.css est en deux sections, de risque différent :
| Section | Contenu | Risque | État |
|---|---|---|---|
| §1 Variables | surcharge des variables de couleur officielles (--color-primary, --color-body…) |
Sûr — aucune classe interne touchée, résiste aux mises à jour | Éprouvé sur forge-01 (CHANGELOG 2026-07-03 : alliance.css servi, cyan aurore rendu) |
| §2 Décor | fond aurore (body), filet sous les titres, citations, tableaux et code en ligne du contenu rendu (.markup) |
Fragile — sélecteurs internes de Forgejo, à revérifier après chaque montée de version majeure | Jamais rendu — ajouté le 2026-07-21, validé en syntaxe CSS seulement |
Supprimer §2 ramène au thème sobre d'origine : §1 se suffit à elle-même.
Le ciel nocturne ne s'applique qu'aux thèmes sombres (theme-forgejo-dark,
theme-forgejo-auto) pour ne pas casser le thème clair.
Pour une forge hors flotte (instance Forgejo non gérée par Set-OPS), la pose manuelle
des mêmes fichiers est décrite dans docs/theme-forgejo-hors-flotte.md.
Notes / limites
- Version à confirmer sur forgejo.org/download ; l'URL suit le motif officiel des releases.
- Le site nginx publiant Forgejo se déclare côté
serveur_nginx. - Mailer en SMTP simple vers le relais interne (sans TLS pour l'instant).
- forge-01 a existé, puis a été supprimée. L'hôte est donc
etat: planifiedansinstance/plan/serveurs.yml(état actuel) alors queCHANGELOG.md(2026-07-03) affirme le branding « prouvé sur forge-01 » (état passé, accueil 200,alliance.cssservi). Les deux disent vrai : ce n'est pas une contradiction, c'est un enregistrement historique face à un état courant. La preuve reste valable — elle ne sera simplement rejouable qu'après recréation de l'hôte.
Prérequis
- Dépendances
serveur_postgresql,serveur_nginx,serveur_postfix(cf.docs/dependances-groupes.yml).
Quelle base de données — serveur_forgejo_bd
| Valeur | Ce que ça donne |
|---|---|
postgres (défaut) |
la base vit dans le registre du plan, sur un serveur dédié : une VM, une zone, un secret, une sauvegarde |
sqlite |
un fichier sous serveur_forgejo_data — aucun serveur, aucun secret de base, aucune entrée au registre |
sqlite est le défaut documenté de Forgejo pour une petite instance. Il a été ajouté le
2026-08-22 parce qu'une offre forge destinée à un petit organisme exigeait une VM
PostgreSQL entière pour une base que trois personnes sollicitent.
Ce que ça change ailleurs : rien. Le job de sauvegarde serveur_forgejo emporte déjà
serveur_forgejo_data, où le fichier se trouve. Et P35 lit l'interrupteur : elle
n'attend aucune entrée de registre quand la base est un fichier.
Une valeur inconnue est refusée au début du rôle, plutôt que de retomber en silence sur PostgreSQL — qui déploierait le contraire de ce qu'on croyait choisir.