Qu'est-ce que Forgejo Runner ?
Forgejo Runner est le runner CI pour Forgejo Actions. C'est un démon léger qui se connecte à votre instance Forgejo, récupère les tâches de workflow en attente et les exécute sur votre propre infrastructure — via Docker, LXC ou directement sur l'hôte — pour vous offrir un pipeline CI/CD entièrement auto-hébergé et compatible GitHub Actions.
⚡ Fonctionnalités clés de Forgejo Runner
🔁 Compatible Actions
Exécute les workflows en utilisant la même syntaxe et le même écosystème d'actions que GitHub Actions.
🐳 Exécution flexible
Exécutez les tâches dans des conteneurs Docker, en LXC, ou directement sur la machine hôte.
🔐 Auto-hébergé
Gardez votre CI/CD entièrement sur votre propre infrastructure, sans dépendance à un tiers.
⚖️ Évolutif
Enregistrez plusieurs runners avec des étiquettes pour répartir et cibler les charges de travail.
🎯 Pourquoi Forgejo Runner ?
- Maîtrisez votre CI : Exécutez vos pipelines sur du matériel que vous contrôlez
- Écosystème Actions : Réutilisez les définitions de workflow existantes de style GitHub
- Isolation flexible : Exécution via Docker, LXC ou sur l'hôte selon vos besoins
- Léger : Un seul binaire Go simple à déployer
🆕 Points forts
- Exécution des tâches : Exécute les workflows Forgejo Actions en attente
- Étiquettes : Ciblez des tâches vers des runners spécifiques
- Support des conteneurs : Builds isolés via Docker
- Mode démon : Fonctionne en continu en tant que service
📦 Installation depuis deb.griffo.io
Étape 1 : Ajouter le dépôt
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Il existe un miroir gratuit pour toujours. deb-free.griffo.io distribue des paquets gratuitement pour toujours — sans compte, sans abonnement, au plus 2 mois derrière l'upstream, correctifs de sécurité immédiats. Il contient aujourd'hui cliamp, Ghostty, lazydocker, Oh My Posh et Zed ; Forgejo Runner n'en fait pas partie, le dépôt ci-dessus reste donc le seul moyen de l'installer — demandez-le et il pourra y être ajouté.
🧩 À propos de l'option extrepo. extrepo est l'outil de Debian pour les dépôts externes : il écrit le fichier de sources et installe la clé de signature à votre place, après l'avoir vérifiée face à des métadonnées signées. Ce dépôt y est enregistré sous le nom griffo, et le miroir gratuit à vie sous griffo-free ; sur Debian (bookworm, trixie, forky et sid), les commandes ci-dessus constituent donc toute l'installation.
extrepo ne met en place que le fichier de sources et la clé : les identifiants d'un abonnement vont toujours dans /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu n'est pas couvert, car extrepo ne publie de métadonnées que pour les suites Debian : utilisez-y les commandes avec sudo ou en root.
Étape 2 : Installer forgejo-runner
# Install latest forgejo-runner
sudo apt install forgejo-runner
# Verify installation
forgejo-runner --version# Install latest forgejo-runner
apt install forgejo-runner
# Verify installation
forgejo-runner --version🎯 Exemples d'utilisation de base
# Show version
forgejo-runner --version
# Generate a default config file
forgejo-runner generate-config > config.yaml
# Register the runner with your Forgejo instance
forgejo-runner register --instance https://forgejo.example.com --token <TOKEN>
# Start the runner daemon
forgejo-runner daemon🚀 Pourquoi choisir deb.griffo.io ?
- Debian officiel : Souvent en retard de plusieurs mois, sans les dernières fonctionnalités
- deb.griffo.io : Dernière version quelques heures après sa publication
- Installation manuelle : Téléchargements manuels et configuration du PATH requis
- Notre dépôt : Paquets précompilés, prêts à l'emploi
- ✅ Dernières fonctionnalités : Obtenez immédiatement les dernières fonctionnalités et améliorations de Forgejo Runner
- ✅ Aucune installation manuelle : Binaires précompilés, installés et mis à jour via apt
- ✅ Mises à jour automatiques : Paquets mis à jour quelques heures après les versions amont
- ✅ Dépendances correctes : Correctement empaqueté avec toutes les bibliothèques requises
- ✅ Multi-distribution : Fonctionne sur Bookworm, Trixie et Sid
- ✅ Maintenance facile : Simples commandes apt pour les mises à jour
📦 Dépôt de construction de paquets
Les paquets Debian sont automatiquement construits et maintenus dans ce dépôt GitHub :
- 📁 forgejo-runner-debian - Dernières versions publiées
🔗 Paquets associés
Également disponibles depuis deb.griffo.io :
- Forgejo - Forge logicielle légère auto-hébergée
- Garage - Stockage d'objets distribué compatible S3
- Headscale - Serveur de contrôle Tailscale auto-hébergé
💝 Soutenir ce projet
Si ce dépôt vous fait gagner du temps et des efforts, veuillez envisager de le soutenir !