Document runner host mapping and check Gitea connectivity
Test and publish container images / images (push) Failing after 0s
Test and publish container images / images (push) Failing after 0s
This commit is contained in:
1 parent
02883e404b
commit
c3bea8a3b7
2 files changed
+82
-2
No files matched your search
@@ -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
|
||||
|
||||
@@ -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)
|
||||
Reference in new issue
Block a user