GitHub App et interrupteurs
101Maintain lit et écrit sur GitHub par une GitHub App dédiée. Chaque fonction qui agit à l'extérieur est désactivée par défaut et s'active par une variable. Cette page décrit la préparation de l'App, puis chaque interrupteur.
Qui peut le faire : l'exploitant, avec un propriétaire de l'organisation GitHub pour installer l'App et accepter ses permissions.
Créer la GitHub App#
- Créez une GitHub App dédiée à l'instance, dans l'organisation GitHub concernée.
- Webhook : activez-le, URL
https://maintenance.maintain.example/webhooks/github, secret aléatoire. - Abonnez l'App aux événements Issues.
- Accordez les permissions du tableau ci-dessous, selon les fonctions voulues.
- Générez une clé privée.
- Saisissez dans la ressource Coolify, en secrets :
MVP_GITHUB_APP_ID,MVP_GITHUB_APP_PRIVATE_KEY(multiligne) etMVP_GITHUB_WEBHOOK_SECRET(le secret du webhook). - Installez l'App sur les seuls dépôts à maintenir. Le lien d'installation a la forme
https://github.com/apps/<slug>/installations/new. L'interface le propose quand l'App manque.
Le webhook vérifie la signature avant de lire le contenu. Il refuse les corps de plus de 256 Kio et les événements non pris en charge. La désinstallation de l'App, sa suspension ou le retrait d'un dépôt de l'installation désactivent les rattachements concernés.
Côté utilisateurs, le rattachement d'un dépôt se fait ensuite avec Vérifier et rattacher : voir Lier le dépôt à la GitHub App.
Permissions de la GitHub App#
| Permission | Niveau | Sert à | Nécessaire pour |
|---|---|---|---|
| Metadata | Lecture | Lister et identifier les dépôts installés | Toujours (acquise par toute App) |
| Issues | Lecture | Recevoir et vérifier les issues | Toujours |
| Issues | Écriture | Ouvrir une issue depuis un constat d'audit | MVP_AUDIT_ISSUES_ENABLED |
| Contents | Lecture | Lecture du code par les agents et par les audits | MVP_AGENT_MODE=live, MVP_REPOSITORY_AUDITS_ENABLED |
| Contents | Écriture | Créer la branche de travail et ses commits | MVP_GITHUB_PUBLICATION_ENABLED |
| Pull requests | Écriture | Ouvrir la PR brouillon, demander la revue, suivre la PR | MVP_GITHUB_PUBLICATION_ENABLED |
| Checks | Lecture | Afficher le résultat de la CI dans le suivi | Facultatif : sans elle, la CI s'affiche comme inconnue |
| Dependabot alerts | Lecture | Contrôle des dépendances dans un audit | Facultatif |
| Members (organisation) | Lecture | Proposer les membres comme responsable GitHub | Facultatif : sans elle, saisie manuelle du login |
L'App ne fusionne jamais une PR, ne déclenche aucun déploiement et ne modifie aucune protection de branche.
Interrupteurs de fonctionnalités#
Les variables sont transmises au web et au worker. Après tout changement, redéployez la ressource.
| Variable | Active | Prérequis |
|---|---|---|
MVP_AGENT_MODE=live | Les exécutions de maintenance (cinq agents). Avec off, les demandes restent en attente. | MVP_LANGDOCK_API_KEY, MVP_LANGDOCK_MODEL, App avec Contents et Issues en lecture. |
MVP_PUBLICATION_NOTICES_ENABLED=true | Les notifications avant publication. | Messagerie configurée ou webhook d'équipe (voir ci-dessous). Destinataire réglé sur chaque dépôt. |
MVP_GITHUB_PUBLICATION_ENABLED=true | Les écritures GitHub : branche, PR brouillon, demande de revue, questions. | Contents et Pull requests en écriture. Notifications actives. |
MVP_REPOSITORY_AUDITS_ENABLED=true | Les audits de dépôt. Sans elle, la demande répond 503 repository_audits_disabled. | Contents en lecture. |
MVP_AUDIT_ISSUES_ENABLED=true | L'ouverture d'issues depuis les constats. | Audits activés, Issues en écriture. |
ACTIVE_TESTS_ENABLED=true | Les accords de recette et les contrôles dynamiques. | Profil scanner. |
MVP_BENCHMARK_MODE | Le banc d'essai : simulated (aucun fournisseur) ou live. | Profil benchmark. |
Les fonctions côté utilisateur sont décrites aux chapitres Maintenance assistée et Audits et banc d'essai.
Canal de notification#
- E-mail : utilise la messagerie de l'instance. Voir Messagerie et codes de sécurité.
- Webhook d'équipe :
MVP_NOTICE_WEBHOOK_URL(HTTPS approuvée) etMVP_NOTICE_WEBHOOK_SECRET(32 octets au moins). Le corps JSON est signé en HMAC SHA-256. Le canal ne doit répondre 2xx que s'il accepte la prise en charge. - Rebonds Resend : enregistrez
https://maintenance.maintain.example/webhooks/resend/publicationchez Resend, pour les événementsemail.bounced,email.failedetemail.suppressed, et renseignezMVP_RESEND_BOUNCE_SECRET.
Tarifs du modèle#
MVP_LANGDOCK_RATES contient les tarifs contractuels, par million de jetons, en chaînes décimales. Exemple fictif :
[
{
"model": "modele-exemple",
"currency": "EUR",
"input": "2.00",
"cachedInput": "0.50",
"output": "4.00",
"effectiveFrom": "2026-01-01",
"source": "Contrat exemple"
}
]Le nom du modèle doit correspondre exactement à MVP_LANGDOCK_MODEL. Sans tarif applicable, le coût reste inconnu. Voir Comprendre la consommation.
Profils scanner et benchmark#
Profil scanner#
Le scanner effectue les contrôles dynamiques d'une recette autorisée. Il est isolé : seul le worker peut lui parler, et ses sorties passent par un proxy qui refuse les adresses internes.
- Générez une paire TLS pour le proxy, dans un dossier de l'hôte lisible par l'UID 1000 :
openssl req -x509 -newkey rsa:2048 -nodes -days 825 -subj /CN=scanner-egress -keyout egress-key.pem -out egress-cert.pem -addext subjectAltName=DNS:scanner-egress- Renseignez
SCANNER_EGRESS_TLS_DIRavec ce dossier. - Générez trois secrets distincts :
SCANNER_TOKEN,SCANNER_EGRESS_TOKEN,ZAP_API_KEY. - Renseignez
MVP_SCANNER_URL=http://scanner:8080etACTIVE_TESTS_ENABLED=true. - Ajoutez
scanneràCOMPOSE_PROFILES, puis redéployez.
Les conteneurs du scanner refusent de démarrer sans leurs secrets.
Profil benchmark#
- Placez sur l'hôte une copie de confiance du dossier
bench/du dépôt, lisible par l'UID 1000. - Renseignez
BENCHMARK_FIXTURES_DIRavec ce dossier etMVP_BENCHMARK_MODE(simulatedoulive). - Ajoutez
benchmarkàCOMPOSE_PROFILES, puis redéployez.
Pour continuer#
Surveillez l'instance avec Santé, métriques et alertes.