From 09d395f604073b4229808e86af03e6d05d2b5681 Mon Sep 17 00:00:00 2001
From: abyxcos <abyxcos@mnetic.ch>
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.<name>.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 <abyxcos@mnetic.ch>
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.<name>.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.<name>.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 <abyxcos@mnetic.ch>
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.<name>.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.<name>.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