Dépôts, demandes de fusion avec relecture en ligne, tickets, wikis, releases, webhooks signés et un moteur de CI/CD. Un processus, un PostgreSQL, sur votre serveur.
$docker compose up -d --buildUn seul binaire et une base de données. Aucun compte chez un tiers, aucune télémétrie envoyée nulle part. Voir comment c'est fait.
Illustration d'une demande de fusion dans FerrisGit, du push à la fusion : un push en HTTPS crée la demande, une relectrice suggère une modification sur une ligne, l'auteur l'applique en un clic, la relectrice approuve, la demande est fusionnée. La fusion déclenche le pipeline du dépôt : format et clippy s'exécutent, puis test, et les trois réussissent.
/api, chacune documentéeChaque tuile est un morceau du vrai produit. L'interface est en français pour l'instant ; cinq langues sont prévues pour la 0.2.
src/webhooks/dispatch.rs:48 Ouvert
Un commentaire reste attaché à sa ligne. Un relecteur peut écrire une suggestion que l'auteur applique en un clic, sous forme de commit. Les approbations sont comptées, les conflits détectés.
Après chaque push, FerrisGit lit le fichier sur la branche par défaut et crée un pipeline. Les étapes sont des barrières, needs des dépendances ; les jobs tournent dans des conteneurs Docker via un petit runner, ou dans des Pods Kubernetes.
Étiquettes, jalons, assignation et quatre états. Glissez une carte pour changer son état, ou passez par le menu de la carte, au clavier.
| Action | Lect. | Contrib. | Maint. |
|---|---|---|---|
| Parcourir, cloner, lire | |||
| Pousser, ouvrir tickets et demandes, relire | |||
| Fusionner, publier, réglages, collaborateurs |
Un rôle donné sur un groupe s'applique à tout ce qu'il contient. Le rôle le plus élevé l'emporte.
Douze événements sur les demandes de fusion, les tickets, les pipelines et les collaborateurs. Chaque envoi porte une signature HMAC-SHA256 de son corps brut ; le secret est chiffré au repos.
Les visiteurs parcourent le catalogue, le README, les fichiers, les commits et les releases des dépôts publics, et les clonent. Un interrupteur d'administration éteint les pages publiques.
Aucun compte ne peut s'en passer. Applications d'authentification (TOTP), clés d'accès (WebAuthn) et dix codes de secours à usage unique.
Dépôts, tickets, demandes de fusion et utilisateurs, pendant la frappe. Les notifications dans l'application vous disent ce qui vous concerne.
Décrivez les jobs dans .ferrisgit-ci.yml à la racine du dépôt. Après chaque push réussi, FerrisGit lit le fichier sur la branche par défaut et crée un pipeline. Basculez l'interrupteur pour voir ce que fait l'ordonnanceur quand un job échoue.
stages: [lint, test]
jobs:
format:
stage: lint
image: rust:1
script:
- rustup component add rustfmt
- cargo fmt --all -- --check
clippy:
stage: lint
image: rust:1
script:
- rustup component add clippy
- cargo clippy --all-targets -- -D warnings
test:
stage: test
image: rust:1
needs: [format, clippy]
script:
- cargo test --all-targets
Pipeline réussi
lint
test
format et clippy démarrent ensemble ; test déclare needs: [format, clippy] et démarre quand les deux ont réussi.
ferrisgit-runner interroge le serveur et exécute chaque job dans un conteneur. Ou Kubernetes : le serveur crée un Pod par job dans votre cluster.FerrisGit est une image de conteneur avec PostgreSQL à côté. Essayez-le avec Docker Compose, installez le chart Helm sur Kubernetes, ou lancez-le depuis les sources.
git clone https://github.com/Masmarino/FerrisGit.git
cd FerrisGit
cp .env.example .env
# set POSTGRES_PASSWORD, JWT_SECRET, SETTINGS_ENCRYPTION_KEY and the admin password in .env
docker compose up -d --build
Compose construit l'image depuis les sources. Pour utiliser l'image publiée, remplacez build: . par image: masmarino/ferrisgit:0.1.1 dans docker-compose.yml.
git clone https://github.com/Masmarino/FerrisGit.git
cd FerrisGit
helm upgrade --install ferrisgit ./helm/ferrisgit \
--namespace ferrisgit --create-namespace \
--set image.tag=0.1.1 \
--set ingress.host=git.example.com \
--set-string ferrisgit.trustedProxyCidrs=10.42.0.0/16
kubectl -n ferrisgit rollout status deployment/ferrisgit
Laissées vides, le chart génère le mot de passe de la base, JWT_SECRET, SETTINGS_ENCRYPTION_KEY et le mot de passe du premier administrateur dans le Secret ferrisgit-secrets. La release doit s'appeler ferrisgit.
git clone https://github.com/Masmarino/FerrisGit.git
cd FerrisGit
cp .env.example .env # then set real secrets
./scripts/dev.sh # PostgreSQL via Compose, cargo run on :8080, ng serve on :4201
Il faut rustup, Node.js 26, Docker avec Compose et git dans le PATH. Le script démarre PostgreSQL, applique les migrations et lance le backend sur le port 8080 et le serveur de développement Angular sur le port 4201.
Un processus, cinq crates, une architecture hexagonale : le domaine ignore tout de la base de données, les adaptateurs ignorent tout des cas d'usage.
Fig. 1 Une instance. La ligne orange suit un push, du client jusqu'aux jobs qu'il déclenche.
Ce qui protège une instance, nommé précisément. Les données ne quittent jamais votre serveur.
SETTINGS_ENCRYPTION_KEY.X-Frame-Options: DENY, et les routes de connexion sont limitées en débit par IP.Cinq versions, aucune livrée. Un point n'est coché que lorsqu'il est livré.
L'instance publique montre le produit. Votre instance garde votre code.
camille · 2 min
Attente exponentielle, pour qu'un point de terminaison instable ne soit plus martelé.