counterweight
97c7d580bc
jar-lid-archive's CI needs `docker build` and `docker compose`, and job
containers had no Docker at all: config.yml carried the stock
`container.docker_host: "-"`, which is precisely "find a daemon for the
runner and do not let jobs near it".
A docker:dind sidecar now runs on forgejo-runner-box, published on
127.0.0.1 only, and jobs build against that instead of the host daemon.
Following Forgejo's own admin docs, which make the point that this is
THREE settings and not one:
forgejo-dind.service a privileged docker:dind on the host daemon
container.docker_host tcp://127.0.0.1:2376 - where the runner
CREATES job containers
runner.envs.DOCKER_HOST + tcp://forgejo-dind.docker.internal:2375 -
container.options how a job, from INSIDE dind, reaches it
The third is the one that is easy to miss and fails identically to
having done nothing: for a tcp:// docker_host the runner mounts nothing
into the job container, so the job still finds no daemon. The two
addresses differ because they are used from different places - the
runner is a process on the host; a job container is inside dind, where
127.0.0.1 is itself. `host-gateway` is expanded by the daemon creating
the container, which is dind, so it lands on dind's own bridge gateway.
Verified on the box, along the exact path a job takes - a container on a
user-defined network, with the same --add-host and DOCKER_HOST the
runner will set: the name resolves to 172.20.0.1, `docker version`
returns the dind server, and `docker build` succeeds. The host daemon
runs forgejo-dind and nothing else.
config.yml had to become a template to do any of this. It was previously
`generate-config` run once on first deploy and never touched again, so
the repo had no say in its contents. Every value was transcribed from
the live file and diffed against it key by key: with dind disabled, 30
of 30 identical. Two deliberate differences - runner.envs drops
A_TEST_ENV_NAME_1/2, upstream's placeholders, which were being injected
into every job here; and the upstream comment blob is gone. Because the
file is managed now it also gets a restart handler, the absence of which
has bitten this repo before.
Things deliberately chosen rather than defaulted into:
- the flag lives in the playbook, not the role defaults, so the role's
default stays the configuration this host has always run and turning
it off is one line. Disabling it also tears the units down rather than
just skipping them.
- dind is a hard Requires= of forgejo-runner, and its unit stays in
"activating" until the daemon answers. A dead dind is then one red
unit instead of a green runner failing every job it claims.
- the healthcheck and monitored_services learned about dind for the same
reason: runner up + dind down is the interesting failure and it was
previously invisible.
- /var/lib/docker is a named volume, or every image is re-pulled on each
container recreation; a weekly prune keeps that from growing forever.
- dind's network pool is pinned to 172.20.0.0/14. Docker's stock pool
reaches into 192.168.x, and act_runner creates a network per job, so a
job could eventually allocate this LAN's subnet and lose the route to
every box on it.
Note this runner is SHARED - arbret, arbret-biz, arbretdos and
arbret-ops build here too, far more often, and docker_host is per-runner
not per-repo. Their workflows are unchanged but their next run pulls
images into a cold cache. Job images still need a docker client of their
own: node:{20,22}-bookworm ship none.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
71 lines
2.8 KiB
Django/Jinja
71 lines
2.8 KiB
Django/Jinja
#!/bin/bash
|
|
# Forgejo Runner healthcheck — managed by Ansible (roles/forgejo_runner)
|
|
#
|
|
# Answers "is forgejo-runner healthy" and records it two ways: this log, and the
|
|
# exit code. The exit code is the durable artefact — systemd keeps it, so
|
|
# systemctl is-failed {{ healthcheck_service_name }}.service
|
|
# answers the question with no monitoring system involved.
|
|
#
|
|
# Reporting is optional and generic: if a push URL is configured it also pings
|
|
# it. Nothing here knows or cares which monitoring product is on the other end.
|
|
|
|
LOG_FILE="{{ healthcheck_log_file }}"
|
|
# Read from the environment rather than templated in, so the unit file is the
|
|
# only place the token lives and the script is not secret.
|
|
PUSH_URL="${HEALTHCHECK_PUSH_URL:-}"
|
|
PUSH_TOKEN="${HEALTHCHECK_PUSH_TOKEN:-}"
|
|
|
|
log_message() {
|
|
echo "$(date '+%Y-%m-%d %H:%M:%S') - $1" >> "$LOG_FILE"
|
|
}
|
|
|
|
# Gatus external endpoint: a POST with a bearer token and success=true|false.
|
|
#
|
|
# This used to report ONLY success - it exited before pushing when the runner
|
|
# was down - so a failure was invisible until the heartbeat window expired.
|
|
# Reporting the failure is the whole point of having a check.
|
|
report() {
|
|
local ok="$1" msg="$2"
|
|
[ -n "$PUSH_URL" ] || return 0
|
|
curl -s --max-time 15 --retry 2 -o /dev/null -X POST \
|
|
-H "Authorization: Bearer ${PUSH_TOKEN}" \
|
|
"${PUSH_URL}?success=${ok}&error=${msg// /%20}" || true
|
|
}
|
|
|
|
main() {
|
|
if ! systemctl is-active --quiet forgejo-runner; then
|
|
log_message "ERROR: forgejo-runner is not active"
|
|
report false "forgejo-runner is not active"
|
|
exit 1
|
|
fi
|
|
{% if forgejo_runner_dind_enabled %}
|
|
|
|
# An active runner is no longer the whole answer. With container.docker_host
|
|
# pointing at dind, a dead dind means the runner keeps claiming jobs and
|
|
# fails every one of them at container creation - green unit, red CI. So
|
|
# check the daemon jobs actually build on, not just that its unit is up:
|
|
# the unit can be active while dockerd inside it has died.
|
|
if ! systemctl is-active --quiet {{ forgejo_runner_dind_service }}; then
|
|
log_message "ERROR: {{ forgejo_runner_dind_service }} is not active"
|
|
report false "{{ forgejo_runner_dind_service }} is not active"
|
|
exit 1
|
|
fi
|
|
|
|
if ! docker -H tcp://{{ forgejo_runner_dind_bind_address }}:{{ forgejo_runner_dind_host_port }} version >/dev/null 2>&1; then
|
|
log_message "ERROR: dind daemon not answering on {{ forgejo_runner_dind_bind_address }}:{{ forgejo_runner_dind_host_port }}"
|
|
report false "dind daemon not answering"
|
|
exit 1
|
|
fi
|
|
|
|
log_message "forgejo-runner is active and the dind daemon answers"
|
|
report true "active"
|
|
exit 0
|
|
{% else %}
|
|
|
|
log_message "forgejo-runner is active"
|
|
report true "active"
|
|
exit 0
|
|
{% endif %}
|
|
}
|
|
|
|
main
|