From c3bea8a3b74b3a348e60464c33e9f7a881b48bde Mon Sep 17 00:00:00 2001 From: Anya Tokugawa Date: Sun, 27 Sep 2026 17:34:35 +0900 Subject: [PATCH] Document runner host mapping and check Gitea connectivity --- .gitea/workflows/images.yml | 12 ++++++ docs/operations/gitea-images.md | 72 ++++++++++++++++++++++++++++++++- 2 files changed, 82 insertions(+), 2 deletions(-) diff --git a/.gitea/workflows/images.yml b/.gitea/workflows/images.yml index e3c816e..8279673 100644 --- a/.gitea/workflows/images.yml +++ b/.gitea/workflows/images.yml @@ -24,6 +24,18 @@ jobs: DOCKER_BUILD_SUMMARY: 'false' DOCKER_BUILD_RECORD_UPLOAD: 'false' steps: + - name: Check Gitea HTTPS connectivity before checkout + shell: bash + env: + GITEA_SERVER_URL: ${{ github.server_url }} + run: | + set -euo pipefail + if ! curl --fail --silent --show-error --connect-timeout 5 --max-time 15 \ + --output /dev/null "${GITEA_SERVER_URL%/}/api/v1/version"; then + echo 'Gitea HTTPS is unreachable from the job environment. Check runner-host DNS and container.options --add-host=git.anya.jp:172.18.0.10; see docs/operations/gitea-images.md.' >&2 + exit 1 + fi + - name: Check runner and publication configuration id: config shell: bash diff --git a/docs/operations/gitea-images.md b/docs/operations/gitea-images.md index 3734355..70f6ec3 100644 --- a/docs/operations/gitea-images.md +++ b/docs/operations/gitea-images.md @@ -46,7 +46,7 @@ registry への 3 回の push は原子的ではない。途中で通信・認 runner の実行環境には以下が必要。 -- Linux amd64、bash、git、Docker CLI と利用可能な Docker daemon。 +- Linux amd64、bash、git、curl、Docker CLI と利用可能な Docker daemon。 - Node.js 20 対応の JavaScript Action 実行環境。 - Gitea、GitHub、Docker Hub、Go module proxy、npm registry への疎通。 - 3 イメージとビルドキャッシュを扱えるディスク容量。 @@ -68,7 +68,73 @@ Gitea 1.24 では workflow の `concurrency`、`permissions`、job の 後処理が別ジョブと衝突しないよう、レポジトリ用 runner は同一 daemon で直列実行する。 BuildKit の内部並列度も 2 に制限しているが、これはCPU・メモリの厳密な上限ではない。 -### 3. Registry 認証 +### 3. git.anya.jp を 172.18.0.10 に固定する場合 + +`gitea-runner daemon` をホストで動かしている場合、Compose 化は不要。 +継続運用では同じコマンドを systemd のサービスとして管理すればよい。 +runner のバージョンは Gitea サーバーのバージョンとは別なので、まず +`gitea-runner --version` と `gitea-runner --help` で確認する。 + +名前解決は実行場所ごとに設定する。ホストの `/etc/hosts` はコンテナへ自動継承されない。 + +| 通信元 | 必要な設定 | +| --- | --- | +| ホストで動く runner 本体 | ホストのDNS、または `/etc/hosts` に `172.18.0.10 git.anya.jp` | +| runner が起動するジョブコンテナ | runner 設定の `container.options` に `--add-host=git.anya.jp:172.18.0.10` | +| `docker push` を実行する Docker daemon | daemon が動くホストのDNS/hosts。DinDならdaemonコンテナ自身の `extra_hosts` | + +例として、新規設定が必要なときだけ runner の作業ディレクトリで生成する。 +既存 `config.yaml` を上書きせず、既存の登録ファイル `.runner` も保持する。 + +```bash +gitea-runner generate-config > config.example.yaml +``` + +生成例を参考に、既存設定へ以下をマージする。既存の `container.options` が +ある場合は値を置き換えず、オプションを追記する。 + +```yaml +runner: + capacity: 1 + timeout: 2h +container: + options: "--add-host=git.anya.jp:172.18.0.10" +``` + +実行中のジョブが終わってから、既存の runner を停止して設定ファイル付きで +起動する。二重起動しないこと。登録時と同じ作業ディレクトリから実行するか、 +`runner.file` に登録ファイルへのパスを指定する。 + +```bash +gitea-runner --config /absolute/path/to/config.yaml daemon +``` + +`container.options` は Docker ジョブにのみ作用し、host ラベルのジョブには不要。 +runner 自体をDockerコンテナ化する場合は、そのComposeサービスにも別途 +`extra_hosts: ["git.anya.jp:172.18.0.10"]` を追加する。 +**PagesWikiアプリ側の `docker-compose.yml` に追加してもCIの名前解決は直らない。** + +ホストでの確認: + +```bash +getent ahostsv4 git.anya.jp +curl --fail --connect-timeout 5 --max-time 15 https://git.anya.jp/api/v1/version +``` + +workflowにもcheckoutより前のHTTPS疎通チェックを置いている。ただしrunner自体が +Giteaへ接続できなければジョブは取得できないため、このチェックも実行されない。 +Waitingのままならrunnerのオンライン状態・ラベル・空きスロットも確認する。 + +URLは `https://git.anya.jp` のまま保ち、IPのURLへの変更やTLS検証無効化はしない。 +また `172.18.0.10` と競合するDockerネットワークを作らないこと。特に +`172.18.0.0/16` のようなネットワークで宛先を吸い込む問題はhosts設定では直らない。 +ネットワークが必要なら、実ネットワークと非重複のアドレス帯から `/27` 等を選ぶ。 +この変更で既存ネットワークの作成・変更は実施しない。 + +2026-09-27の確認では、作業ホストと `--add-host` 付き一時コンテナの両方から +指定IPのGiteaへTLS検証付きで接続できた。実際のrunnerの設定変更・再起動は未実施。 + +### 4. Registry 認証 Repository Settings → Actions → Secrets に次の値を設定する。 @@ -146,3 +212,5 @@ Gitea 上の runner / secrets の設定と実行成功は、ローカル検証 - [Gitea 1.24 Act Runner](https://docs.gitea.com/1.24/usage/actions/act-runner/) - [Gitea 1.24 Actions の互換性・制限](https://docs.gitea.com/1.24/usage/actions/comparison/) - [Gitea Container Registry](https://docs.gitea.com/usage/packages/container/) +- [Gitea Runner設定(runner自身のバージョンに合わせて参照)](https://docs.gitea.com/runner/2/configuration/) +- [DockerコンテナのDNSとhosts](https://docs.docker.com/engine/network/#dns-services)