Timestamp GIT

← Tous les articles

2026-11-13

Horodatage Git auto-hébergé avec Docker Compose

Horodatage Git auto-hébergé avec Docker Compose
timestamp git blockchain proof

Auto-hébergement de l’horodatage Git avec Docker Compose

L’horodatage manuel échoue toujours de la même manière. Quelqu’un rédige un runbook, quelqu’un d’autre le transforme en script, le script tourne pendant trois semaines, un disque se remplit ou un jeton expire, et personne ne s’en aperçoit jusqu’au jour où un avocat demande la preuve que votre dépôt avait un certain état il y a dix-huit mois.

L’ancrage en lui-même n’est pas la partie difficile. La partie difficile, c’est le pipeline qui l’entoure : détecter les commits, regrouper les hachages, survivre aux redémarrages, livrer les reçus et garder l’ensemble vérifiable des années plus tard. C’est exactement ce qu’apporte une stack Compose auto-hébergée — un déploiement reproductible et inspectable où l’automatisation tourne sur votre réseau et où vous possédez le répertoire de données.

Cet article décrit le déploiement de Timestamp GIT sur site avec Docker Compose, la connexion d’une GitHub App une seule fois, puis la mise en place d’un worker nocturne automatisé qui ancre vos hachages de commits dans Bitcoin. Si vous voulez d’abord le contexte conceptuel, lisez Cryptographic Prior Art: The Startup Shield Against Patent Trolls.

Pourquoi auto-héberger l’horodatage Git ?

Exécuter une étape d’horodatage à la main signifie se souvenir de trois corvées par dépôt : faire estampiller les hachages de commits, collecter les fichiers de preuve résultants et les stocker dans un endroit durable et auditable. Ratez-en une et la chaîne a des trous ; ratez l’étape de stockage et vous avez des reçus que personne ne peut localiser.

L’auto-hébergement répond à une autre catégorie d’exigences :

  • Résidence des données. Les équipes de conformité veulent savoir où les métadonnées de commits sont traitées. Avec l’image Docker, la réponse est « sur notre hôte ».
  • Réseaux restreints. Certaines équipes n’accorderont aucun accès en lecture SaaS aux dépôts de code source — même en lecture seule — quelles que soient les promesses d’un fournisseur.
  • Déploiements proches de l’air-gap. Vous pouvez exécuter l’image sur un hôte interne ; seule l’étape d’ancrage nécessite un accès sortant vers les calendriers OpenTimestamps publics.
  • Contrôle opérationnel. Vous décidez de la cadence des mises à jour, du calendrier de sauvegarde et de qui peut accéder à l’assistant de configuration.

Docker Compose est un bon choix parce que le système entier tient en deux conteneurs : l’application et une instance Valkey utilisée comme file de hachages en mémoire. Un pull et un up -d suffisent pour obtenir une instance en marche ; le volume ./data conserve l’état entre les redémarrages ; la mise à jour se fait avec docker compose pull && docker compose up -d.

Point essentiel : l’image Docker embarque la même automatisation que le produit hébergé — détection des commits pilotée par GitHub App, ancrage Bitcoin nocturne, reçus .ots renvoyés dans votre dépôt — mais exécutée sur votre infrastructure.

Configuration initiale : Docker Compose et GitHub App

Prérequis

  • Docker Engine avec le plugin Compose.
  • Un hôte avec une disponibilité fiable et un accès Internet sortant (nécessaire pour l’ancrage Bitcoin via les calendriers OpenTimestamps publics).
  • Une GitHub App que vous pouvez installer sur les dépôts cibles, et un dépôt cible (ou dépôt fantôme) où les branches de preuve peuvent être écrites.
  • Un fichier de licence pour l’instance.

Le fichier Compose

Une configuration Docker Compose de démarrage rapide ressemble à ceci :

services:
  timestampgit:
    image: rue1401/timestampgit:prod
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

  valkey:
    image: valkey/valkey:8
    restart: unless-stopped

Deux choses à noter avant d’aller plus loin. Le montage bind ./data:/app/data constitue l’état durable de l’instance — traitez-le comme une donnée critique, pas comme un cache. Et restart: unless-stopped compte ici plus que d’habitude : le worker de minuit doit être vivant à minuit.

Démarrez la stack :

docker compose pull
docker compose up -d
docker compose logs -f timestampgit

L’application est disponible à l’adresse http://localhost:8080 après le démarrage.

Premier lancement

Au premier lancement, un assistant de configuration vous guide pour connecter votre GitHub App et configurer votre instance. Planifiez les permissions avant de cliquer :

  • Mode Standard. La GitHub App lit uniquement le hachage du commit HEAD de chaque dépôt surveillé et écrit les preuves dans un dépôt cible. Le modèle de permissions de GitHub exige au minimum un accès en lecture seule au dépôt source, plus un accès en lecture-écriture à la cible.
  • Mode Enterprise ZK. Une GitHub Action de 12 lignes s’exécute sur votre infrastructure et ne pousse que le hachage du commit vers l’API. Vous avez besoin d’un accès en lecture-écriture au dépôt cible et d’aucun accès en lecture au dépôt source.

Si vous évaluez cela en 2026 pour une équipe déjà standardisée sur le workflow GitHub App hébergé, les étapes de configuration vous sembleront familières — consultez Automate Git Commit Timestamping With a GitHub App pour cette approche.

Licence

Une licence de démonstration limitée dans le temps pour l’évaluation est disponible en soumettant le formulaire de demande sur la page Docker License avec votre nom, votre entreprise, votre e-mail et, facultativement, votre numéro de téléphone. Vous pouvez télécharger un fichier de licence de démonstration limité dans le temps et le charger lors de la configuration Enterprise.

Si l’instance est joignable depuis autre chose que localhost, placez-la derrière un reverse proxy terminant le TLS et restreignez l’accès au niveau réseau. L’assistant de configuration est une surface d’administration.

Le pipeline automatisé : du commit à la preuve Bitcoin

Une fois la GitHub App connectée, le pipeline tourne tout seul :

  1. Détection des commits. La GitHub App reçoit des webhooks pour les nouveaux commits ou — en mode Enterprise ZK — votre GitHub Action pousse les hachages de commits vers l’API.
  2. File de hachages. Les hachages de commits arrivent dans Valkey, le magasin clé-valeur en mémoire utilisé pour le regroupement.
  3. Worker cron de minuit. Chaque nuit, le worker regroupe tous les hachages en attente, écrit un manifeste .txt par dépôt, construit un arbre de Merkle, crée des preuves OpenTimestamps à l’aide des calendriers OTS publics et ancre la racine de Merkle dans Bitcoin.
  4. Livraison des preuves. Le manifeste et les fichiers de reçu .ots sont renvoyés dans votre dépôt, dans une branche timestamps dédiée ou un dépôt fantôme.
  5. Confirmation. La confirmation Bitcoin prend plusieurs heures — normalement environ trois — donc l’écriture des preuves se termine quelques heures après l’exécution du lot.

La propriété de connaissance nulle est structurelle, pas une déclaration de principe : seuls les hachages de commits sont traités. Que vous utilisiez le mode Standard ou le mode Enterprise ZK, votre code source ne quitte jamais votre réseau. Le déploiement Docker déplace simplement aussi l’étape de traitement des hachages à l’intérieur de votre périmètre.

Comme la racine de Merkle est ancrée dans un bloc Bitcoin via OpenTimestamps, l’horodatage devient immuable une fois confirmé. Aucune entité ne peut le modifier ni le falsifier — ni le fournisseur, ni vous.

Supervision et gestion des défaillances

Un pipeline d’horodatage échoue en silence. Les hachages de commits s’accumulent, aucune erreur n’apparaît, et vous découvrez le trou lors d’un audit. Traitez la supervision comme faisant partie du déploiement.

Santé des conteneurs et de la file. Le contrôle le plus utile est le statut propre à l’application pour un dépôt connu. Pointez votre moniteur de disponibilité dessus :

#!/usr/bin/env bash
set -euo pipefail
BASE="http://localhost:8080"
USER="acme"
REPO="platform"

docker compose ps --status running --quiet timestampgit >/dev/null \
  || { echo "timestampgit container is not running"; exit 1; }

curl -fsS "$BASE/api/statusLast/$USER/$REPO" | jq .

GET /api/statusLast/{user}/{repo} renvoie les informations du dernier bloc Bitcoin ancré. Si ce bloc cesse d’avancer, le worker est bloqué.

Badges de vérification publics. Pour chaque dépôt surveillé, le widget de badge génère du markdown Shields.io intégrable pour votre README. L’extrait est servi par GET /api/badgeLink/{user}/{repo} (authentifié) et ressemble à peu près à ceci :

[![Timestamped in Bitcoin](https://img.shields.io/endpoint?url=https://timestampgit.dev/api/statusSummary/acme/platform)](https://timestampgit.dev/status/acme/platform)

N’importe qui peut suivre le lien pour vérifier l’horodatage via le site web. Pour les dépôts privés, l’URL de statut porte un HMAC chiffré propre à votre instance serveur, de sorte que seuls les utilisateurs autorisés peuvent lire le statut.

Audit et rapports. Récupérez le registre selon un calendrier plutôt qu’à la demande :

curl -fsS -o audit-$(date +%F).csv  "$BASE/api/audit/$USER/$REPO"
curl -fsS -o report-$(date -d yesterday +%F).pdf \
  "$BASE/api/report/$USER/$REPO/$(date -d yesterday +%F)"

Vous obtenez ainsi un registre d’audit CSV et un certificat PDF par date que les équipes juridiques et de conformité peuvent archiver sans toucher elles-mêmes à l’API.

Délais de confirmation. L’ancrage se règle normalement en environ trois heures. Des retards surviennent ; le worker réessaie et livre la preuve .ots une fois l’ancre confirmée. Alertez sur « manifeste écrit mais aucun reçu après 24 heures » plutôt que sur de courts délais, sinon vous vous réveillerez pour la variance normale des blocs Bitcoin.

Sauvegarde et restauration. Sauvegardez ./data selon un calendrier, et montez un volume nommé pour le répertoire /data de Valkey si vous voulez que les hachages en file survivent à une recréation de conteneur. Valkey est un magasin en mémoire par conception — le perdre vous coûte le lot d’une nuit, pas vos preuves existantes, car les preuves livrées vivent dans la branche timestamps.

Bonnes pratiques pour l’horodatage auto-hébergé

  • Dédiez un hôte. Le worker tourne à minuit et a besoin d’une disponibilité stable et d’une connectivité sortante. Partager un hôte avec une ferme de build bruyante, c’est courir au lot manqué.
  • Gardez le volume de données hors du stockage éphémère. Montez ./data en bind sur un disque durable et incluez-le dans votre rotation de sauvegardes.
  • Restreignez la surface d’administration. Placez l’assistant et l’API authentifiée derrière votre VPN ou un reverse proxy avec une authentification forte. N’exposez pas le port 8080 à l’Internet public.
  • Mettez à jour délibérément. Faites docker compose pull selon un calendrier que vous contrôlez ; lisez le changelog avant de tirer une nouvelle image :prod.
  • Préférez le mode Enterprise ZK quand les permissions sont contestées. Si votre équipe sécurité n’accordera pas d’accès en lecture aux dépôts source, l’approche GitHub Action les satisfait sans changer l’automatisation.
  • Documentez le processus pour les auditeurs. Notez où tourne l’instance, qui l’administre, comment les sauvegardes sont vérifiées et où sont stockés les reçus .ots. La preuve est cryptographique ; la chaîne de traçabilité a encore besoin d’un paragraphe.
  • Testez une vérification de bout en bout. Choisissez une date ancrée et parcourez le flux de vérification avant d’en avoir besoin dans un litige, pas pendant. Pour le cadre juridique, consultez Is a Bitcoin Timestamp Admissible as Evidence? A Compliance Guide.

FAQ

Dois-je exposer mon code source à Timestamp GIT ? Non. Timestamp GIT ne traite que les hachages de commits. En mode Standard, la GitHub App lit le hachage du commit HEAD ; en mode Enterprise ZK, une GitHub Action ne pousse que le hachage depuis votre infrastructure. Votre code source ne quitte jamais votre réseau.

Que se passe-t-il si la confirmation Bitcoin prend plus de temps que prévu ? Le worker cron de minuit ancre la racine de Merkle dans Bitcoin via OpenTimestamps. La confirmation prend généralement environ 3 heures. Si la confirmation est retardée, le worker réessaiera et livrera la preuve .ots une fois confirmée.

Puis-je l’utiliser dans un environnement air-gap ? Oui, l’image Docker peut tourner dans un environnement air-gap, mais un accès Internet sortant est nécessaire pour l’ancrage Bitcoin via les calendriers OpenTimestamps publics. Vous pouvez configurer l’accès réseau en conséquence.

Comment vérifier un horodatage de manière indépendante ? Vous pouvez télécharger le fichier .ots et le vérifier avec les outils de vérification OpenTimestamps standard par rapport à la blockchain Bitcoin. Vous pouvez aussi utiliser la page de vérification fournie par Timestamp GIT, qui effectue une vérification locale dans votre navigateur — personne ne voit ce que vous vérifiez.

Conclusion

L’auto-hébergement de l’horodatage git ne relève pas de la méfiance envers un fournisseur ; il s’agit de placer un pipeline automatisé et auditable à l’intérieur d’une frontière que votre équipe de conformité accepte déjà. Deux conteneurs, un fichier de licence, une GitHub App — et ensuite le worker de minuit fait la partie répétitive pendant que vous obtenez un dépôt rempli de reçus .ots et une page de statut publique.

Commencez par demander une licence de démonstration sur la page Docker License, montez la stack Compose sur un hôte de staging et vérifiez une journée ancrée de bout en bout. Si vous préférez vous passer de l’infrastructure, la GitHub App gérée Timestamp GIT vous offre le même ancrage nocturne sans aucune configuration — et vous pourrez migrer vers l’auto-hébergement plus tard sans changer ce qui atterrit dans votre dépôt.

Articles connexes

EU label: AI-generated content