Document runner host mapping and check Gitea connectivity
Test and publish container images / images (push) Failing after 0s

This commit is contained in:
Anya Tokugawa committed 2026-09-27 17:34:35 +09:00
1 parent 02883e404b
commit c3bea8a3b7
2 files changed
+82 -2

No files matched your search

+70 -2
View File
@@ -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)