Files
pages/docs/operations/pages-cli-runner.md
T

3.3 KiB

cp01d上のpages-cli専用runner

2026-11-06、既存のPagesWiki用runnerを維持したまま、同じcp01ホストへpages-cli用runnerを追加した。Giteaの登録名は cp01d-pages-cli、登録範囲は公開リポジトリ anya/pages-cli のみ。既存の cp01d は anya/wikipages 専用のまま変更していない。

配置と起動

  • SSH接続先は既存設定の cp01。rootful Dockerを使用する。
  • Composeは /var/container/gitea/runner-pages-cli/compose.yml、プロジェクト名は gitea-pages-cli。
  • コンテナ名は gitea-pages-cli-runner、登録情報は runner-pages-cli/data/.runner(0600)。配置ディレクトリは0700。
  • runner設定は runner-pages-cli/config.yaml。capacity=1、timeout=2h、TLS検証有効、ジョブのprivileged=false。
  • イメージは既存と同じrunner v3.5.0のdigest gitea/runner@sha256:66b7da94dc7dcadb2e076bec6928221336a9a637196399281c4b766fe1288242。
  • 既存ネットワーク anya-npm-net と git.anya.jp:172.18.0.10 の名前解決を使用。新規ネットワークやサブネットは作成していない。
# cp01上で実行。既存のGitea・PagesWiki用runnerには影響しない。
sudo docker compose -p gitea-pages-cli \
  -f /var/container/gitea/runner-pages-cli/compose.yml up -d --no-deps runner

# 新規ジョブの引受けを止める場合。実行中ジョブを確認してから行う。
sudo docker compose -p gitea-pages-cli \
  -f /var/container/gitea/runner-pages-cli/compose.yml stop runner

既存Gitea Composeへの依存を避け、追加runnerだけを独立Composeで管理する。restart=unless-stopped。サーバーや既存runnerの再起動・再登録は不要。既存Gitea用のComposeファイルだけを指定した操作では追加runnerは管理されない。

認証と公開ジョブ

登録トークンはCLIリポジトリ専用APIで取得し、暗号化SSHの標準入力から登録時の一時コンテナ環境へ渡した。Compose、Git、通常起動時の環境変数に登録トークンは保存しない。登録後は .runner を使う。.runner はコピー・公開せず、バックアップ時も権限を維持する。

ジョブラベルは ubuntu-latest。公開リポジトリのmain・バージョンタグ・手動実行のみを対象とし、外部PR実行は設定していない。Docker socketを使うため、ジョブにはホストに対する強い権限がある。レビューしていない外部コードをこのrunnerで実行しない。既存runnerとDocker daemonを共有するため、両runnerが同時に各1ジョブを実行できる。今後並列数を増やす場合はCPU・メモリ・ディスク負荷を確認する。

初回の既存待機ジョブrun 29と、NeoMutt移転後のrun 30が成功した。run 30では32件のテストと実ELFによる合成ログイン、メール→タスク、宛先検索、対話シェル、権限検査、ログアウトを確認した。macOS runnerは未接続のため対応ジョブを無効化している。

v0.1.0タグのrun 31ではRelease添付と公開も成功した。Giteaのジョブtokenを利用し、追加PATやActions secretは作成していない。公開後の匿名ダウンロードとSHA256照合、実バイナリの合成API試験も成功した。