vole

Clone

Read only, no credentials:

https://rodent.software/vole.git

Write over SSH with a registered key:

git clone ssh://git@rodent.software:2222/vole.git

A free and open-source forge that lives in your Git repo.

Code

395 commit(s) on main

Compare History

update readme Keenan Nemetz · 25m ago 32290114

history blame raw 2.7 KiB

1	# Arguments for vole-runner.service. One line, read by systemd and split at
2	# spaces, so it is written the way the command would be typed.
3	#
4	# The packages install this file with the arguments commented out, so enabling
5	# vole-runner without editing it fails with a message saying so.
6	#
7	# Start from this example and keep what applies:
8	#
9	# --remote the instance to lease jobs from. Required.
10	# --container-runtime docker, podman, or nerdctl. Rootless podman is
11	# preferred; see docs/runner.md.
12	# --container-network none (the default) or bridge. A machine without a
13	# network never receives a job that asks for one, and a
14	# job that fetches dependencies needs bridge.
15	# --container-memory what one job may take from RAM, e.g. 4G. Set it: the
16	# runtime's default is the whole machine, and --jobs
17	# multiplies it. Size the machine for --jobs times this.
18	# --container-pids processes one container may have (default 2048).
19	# --container-tmpfs size of the job's /tmp (default 1G). It is a tmpfs, so
20	# it is memory; raise it for a build that writes large
21	# temporary files.
22	# --container-cpus optional CPU cap for one job, e.g. 2.
23	# --disk-reserve free space to keep under --dir (default 2G). A job that
24	# takes the filesystem below it is stopped while it runs,
25	# because a job tree is a host directory with no quota.
26	# --label what this machine is, such as linux or arm64. A job
27	# with runs-on only comes to a runner carrying every
28	# label it asks for.
29	# --dir where checkouts and the cache live.
30	# --known-hosts the file holding the instance's SSH host key. Populate
31	# it once with ssh-keyscan; the runner executes
32	# repository code, so the instance it trusts is a
33	# security boundary.
34	# --repos narrow this machine to named repositories.
35	# --jobs how many jobs to run at once (default 1). Each job
36	# gets its own container, so size the machine for this
37	# many times the container limits.
38	#
39	# VOLE_RUNNER_ARGS=--remote ssh://git@forge.example.com:2222 --container-runtime podman --container-network bridge --container-memory 4G --container-tmpfs 1G --disk-reserve 2G --dir /var/lib/vole-runner --known-hosts /etc/vole/runner_known_hosts --label linux
40