From 09d395f604073b4229808e86af03e6d05d2b5681 Mon Sep 17 00:00:00 2001 From: abyxcos Date: Mon, 29 May 2023 19:43:03 -0400 Subject: [PATCH 1/3] Add a nixos-specific section to the actions runner page. --- admin/actions.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/admin/actions.md b/admin/actions.md index 8247b083..04b0d2f2 100644 --- a/admin/actions.md +++ b/admin/actions.md @@ -140,3 +140,24 @@ If `runs-on` is matched to a label that contains `docker://`, the rest of it is ### LXC If `runs-on` is `self-hosted`, the runner will execute all the steps, as root, within a Debian GNU/Linux `bullseye` LXC container. + +## Host environment + +Certain hosts may require specific configurations for runners to work smoothly. Anything specific to these host environments can be found below. + +### NixOS + +The gitea-actions-runner recipe was release in NixOS 23.05. It can be configured via `services.gitea-actions-runner`. Please note that the `services.gitea-actions-runner.instances..labels` key is not required if only the default forgejo image list is used, however `virtualisation.docker.enable` will need to be set. If podman images are used, `virtualisation.podman.enable` will also need to be set. + +#### IPv6 on docker + +IPv6 support is not enabled by default in docker. The following snippet enables this. + +```nix +virtualisation.docker = { + daemon.settings = { + fixed-cidr-v6 = "fd01::/80"; + ipv6 = true; + }; +}; +``` From 45715d77da317985dfe22bfd3ae91e08c65e49ce Mon Sep 17 00:00:00 2001 From: abyxcos Date: Mon, 29 May 2023 19:54:05 -0400 Subject: [PATCH 2/3] Docker and podman images are exclusive in the labels list. Review @hexa --- admin/actions.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/admin/actions.md b/admin/actions.md index 04b0d2f2..634c603f 100644 --- a/admin/actions.md +++ b/admin/actions.md @@ -147,7 +147,9 @@ Certain hosts may require specific configurations for runners to work smoothly. ### NixOS -The gitea-actions-runner recipe was release in NixOS 23.05. It can be configured via `services.gitea-actions-runner`. Please note that the `services.gitea-actions-runner.instances..labels` key is not required if only the default forgejo image list is used, however `virtualisation.docker.enable` will need to be set. If podman images are used, `virtualisation.podman.enable` will also need to be set. +The gitea-actions-runner recipe was release in NixOS 23.05. It can be configured via `services.gitea-actions-runner`. + +Please note that the `services.gitea-actions-runner.instances..labels` key is not required if only the default Forgejo image list is used, however one of `virtualisation.docker.enable` or `virtualisation.podman.enable` will need to be set. The default Forgejo image list is populated with docker images. #### IPv6 on docker @@ -156,7 +158,7 @@ IPv6 support is not enabled by default in docker. The following snippet enables ```nix virtualisation.docker = { daemon.settings = { - fixed-cidr-v6 = "fd01::/80"; + fixed-cidr-v6 = "fd00::/80"; ipv6 = true; }; }; From c88b35d3a8ca79dd0587516cd87f5aa7f58b2e0e Mon Sep 17 00:00:00 2001 From: abyxcos Date: Mon, 29 May 2023 20:05:54 -0400 Subject: [PATCH 3/3] The labels key *is* required to be defined, but can be set explicitly to an empty list. Clarify this. Review @hexa @indeednotjames --- admin/actions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin/actions.md b/admin/actions.md index 634c603f..7ebeeacc 100644 --- a/admin/actions.md +++ b/admin/actions.md @@ -149,7 +149,7 @@ Certain hosts may require specific configurations for runners to work smoothly. The gitea-actions-runner recipe was release in NixOS 23.05. It can be configured via `services.gitea-actions-runner`. -Please note that the `services.gitea-actions-runner.instances..labels` key is not required if only the default Forgejo image list is used, however one of `virtualisation.docker.enable` or `virtualisation.podman.enable` will need to be set. The default Forgejo image list is populated with docker images. +Please note that the `services.gitea-actions-runner.instances..labels` key may be set to `[]` (an empty list) to use the packaged Forgejo instance list. One of `virtualisation.docker.enable` or `virtualisation.podman.enable` will need to be set. The default Forgejo image list is populated with docker images. #### IPv6 on docker