Forgejo Runner とは
Forgejo Runner は Forgejo Actions のための CI ランナーです。自分の Forgejo インスタンスに接続してキュー上のワークフロージョブを拾い、自分のインフラ（Docker、LXC、あるいはホスト上で直接）で実行する軽量なデーモンで、完全にセルフホストの GitHub Actions 互換 CI/CD を実現します。
⚡ Forgejo Runner の主な機能
🔁 Actions 互換
GitHub Actions と同じ構文・同じ action エコシステムでワークフローを実行します。
🐳 柔軟な実行方法
ジョブを Docker コンテナ、LXC、あるいはホスト上で直接実行できます。
🔐 セルフホスト
CI/CD を丸ごと自前のインフラに置けます。第三者への依存はありません。
⚖️ スケールする設計
ラベル付きのランナーを複数登録して、処理を分散させたり振り分けたりできます。
🎯 なぜ Forgejo Runner なのか
- CI を自分の手に: 自分で管理するハードウェアでパイプラインを実行
- Actions のエコシステム: 既存の GitHub 形式のワークフロー定義をそのまま流用
- 隔離方法を選べる: Docker、LXC、ホスト実行から用途に合わせて
- 軽量: Go の単一バイナリなので、導入が簡単
🆕 注目の変更点
- ジョブの実行: キューに入った Forgejo Actions のワークフローを実行
- ラベル: ジョブを特定のランナーに振り分け
- コンテナ対応: Docker による隔離ビルド
- デーモンモード: サービスとして常駐
📦 deb.griffo.io からインストールする
ステップ 1: リポジトリを追加する
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🆓 ずっと無料のミラーがあります。 deb-free.griffo.io は、アカウントもサブスクリプションもなしでパッケージをずっと無料で配布しています。上流より最大2か月遅れ、セキュリティ修正は即座に公開されます。現在収録しているのは cliamp、Ghostty、lazydocker、Oh My Posh と Zed です。Forgejo Runner は含まれていないため、今日入手する方法は上のリポジトリだけですが、ご要望があれば追加できます。
🧩 extrepo オプションについて。 extrepo は外部リポジトリを扱う Debian 標準のツールです。署名済みメタデータと照合して鍵を検証したうえで、sources ファイルの作成と署名鍵のインストールを代わりに行います。このリポジトリは griffo、ずっと無料のミラーは griffo-free という名前で登録されているので、Debian（bookworm、trixie、forky、sid）では上のコマンドだけで設定は完了です。
extrepo が用意するのは sources ファイルと鍵だけなので、サブスクリプションの認証情報は引き続き /etc/apt/auth.conf.d/deb.griffo.io.conf に書きます。extrepo は Debian のスイート向けメタデータしか公開していないため Ubuntu は対象外です。Ubuntu では sudo または root のコマンドを使ってください。
ステップ 2: forgejo-runner をインストールする
# 最新の forgejo-runner をインストール
sudo apt install forgejo-runner
# インストールを確認
forgejo-runner --version# 最新の forgejo-runner をインストール
apt install forgejo-runner
# インストールを確認
forgejo-runner --version🎯 基本的な使い方
# バージョンを表示
forgejo-runner --version
# 既定の設定ファイルを生成
forgejo-runner generate-config > config.yaml
# 自分の Forgejo インスタンスにランナーを登録
forgejo-runner register --instance https://forgejo.example.com --token <TOKEN>
# ランナーのデーモンを起動
forgejo-runner daemon🚀 deb.griffo.io を選ぶ理由
- 公式 Debian: 数か月遅れることが多く、最新機能が使えない
- deb.griffo.io: リリースから数時間以内に最新版
- 手動インストール: 手でダウンロードして PATH を設定する必要あり
- このリポジトリ: ビルド済みで、すぐに使えるパッケージ
- ✅ 最新の機能: Forgejo Runner の新機能と改善を、すぐに使えます
- ✅ セットアップ不要: ビルド済みバイナリを apt で導入・更新
- ✅ 自動更新: 上流のリリースから数時間以内にパッケージを更新
- ✅ 依存関係も適切に: 必要なライブラリをすべて含めて正しくパッケージ化
- ✅ マルチディストリビューション: Bookworm、Trixie、Sid で動作
- ✅ 手間のかからない運用: 更新はシンプルな apt コマンドだけ
📦 パッケージのビルドリポジトリ
Debian パッケージは、この GitHub リポジトリで自動的にビルド・管理されています:
- 📁 forgejo-runner-debian - 最新リリースのビルド
🔗 関連パッケージ
deb.griffo.io では、こちらも配布しています:
- Forgejo - セルフホストできる軽量なソフトウェアフォージ
- Garage - S3 互換の分散オブジェクトストレージ
- Headscale - セルフホストできる Tailscale コントロールサーバー