This commit is contained in:
bors[bot] 2023-02-23 10:44:05 +00:00
parent bee7c41db2
commit 513890d66a
18 changed files with 319 additions and 25 deletions

View File

@ -1,2 +1,2 @@
cp -r /nix/store/9y37m2lip8rav2bp29yzg74vqcv51k0i-source/* .
cp -r /nix/store/qqkafckrcqdkkgsjpwjvp35y9ryxc57p-source/* .
/nix/store/mxrs4nqf6d9krs55ri9561q1q2iszqji-mdbook-0.4.26/bin/mdbook build --dest-dir "$out"

View File

@ -82,7 +82,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>

View File

@ -8,7 +8,7 @@ runCommand
"srvos-docs"
{
passthru.serve = writeShellScriptBin "serve" ''
set -euo pipefail
set -xeuo pipefail
cd docs
workdir=$(${coreutils}/bin/mktemp -d)
trap 'rm -rf "$workdir"' EXIT

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html" class="active"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html" class="active"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>

View File

@ -3,10 +3,10 @@ declare -x HOME="/homeless-shelter"
declare -x HOST_PATH="/nix/store/7w1s50i8yplw2gkpf9hpha6n9vci8g98-coreutils-9.1/bin:/nix/store/l2rdsfp8v5p32fqahw5vfq50mik9j830-findutils-4.9.0/bin:/nix/store/v316awk24xxz2dj84b5qw2vflfpg7if4-diffutils-3.8/bin:/nix/store/wrrsz1yq3dsbwlv239zcsifn30qvlhpp-gnused-4.9/bin:/nix/store/kj1hi99d4w5489y7nbikadadsvvkr87b-gnugrep-3.7/bin:/nix/store/1f44s1ddm915dn3kdaycabhf3a8xnfnb-gawk-5.2.1/bin:/nix/store/dyyx4hjy9sx92nwwlj4mm334b7dkzj70-gnutar-1.34/bin:/nix/store/yqnrjbiwxa7gdfr2xlmyklw2acydny2g-gzip-1.12/bin:/nix/store/17pkxcz3js3549kn9dc3hhvp4adbwvs1-bzip2-1.0.8-bin/bin:/nix/store/q4pjdicsp4vwg2ic3xpj25w3x2pclnq5-gnumake-4.4/bin:/nix/store/561wgc73s0x1250hrgp7jm22hhv7yfln-bash-5.2-p15/bin:/nix/store/l86y6mg5asdz6531qp42ph9img0nsy9w-patch-2.7.6/bin:/nix/store/12wczkzi5db1ajbjp4hdyif3v9y5rbi5-xz-5.4.1-bin/bin:/nix/store/q6vn1ycak0dgavafwif8gs3v6q9d7i53-file-5.44/bin"
declare -x NIX_BUILD_CORES="2"
declare -x NIX_BUILD_TOP="/build"
declare -x NIX_CFLAGS_COMPILE=" -frandom-seed=331c5p9lxc"
declare -x NIX_CFLAGS_COMPILE=" -frandom-seed=7amlz4p7mp"
declare -x NIX_ENFORCE_NO_NATIVE="1"
declare -x NIX_ENFORCE_PURITY="1"
declare -x NIX_LDFLAGS="-rpath /nix/store/331c5p9lxcz4b4x2363agq935q32d2vf-srvos-docs/lib64 -rpath /nix/store/331c5p9lxcz4b4x2363agq935q32d2vf-srvos-docs/lib "
declare -x NIX_LDFLAGS="-rpath /nix/store/7amlz4p7mpmjyl38rchhyw7lszmv8k0w-srvos-docs/lib64 -rpath /nix/store/7amlz4p7mpmjyl38rchhyw7lszmv8k0w-srvos-docs/lib "
declare -x NIX_LOG_FD="2"
declare -x NIX_SSL_CERT_FILE="/no-cert-file.crt"
declare -x NIX_STORE="/nix/store"
@ -45,7 +45,7 @@ declare -x enableParallelChecking="1"
declare -x mesonFlags=""
declare -x name="srvos-docs"
declare -x nativeBuildInputs=""
declare -x out="/nix/store/331c5p9lxcz4b4x2363agq935q32d2vf-srvos-docs"
declare -x out="/nix/store/7amlz4p7mpmjyl38rchhyw7lszmv8k0w-srvos-docs"
declare -x outputs="out"
declare -x passAsFile="buildCommand"
declare -x patches=""

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html" class="active"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html" class="active"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html" class="active"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html" class="active"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="installation.html" class="active"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="installation.html" class="active"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>
@ -151,7 +151,7 @@
<nav class="nav-wrapper" aria-label="Page navigation">
<!-- Mobile navigation buttons -->
<a rel="prev" href="nixos/roles.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
<a rel="prev" href="nixos/roles/github_actions_runner.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
<i class="fa fa-angle-left"></i>
</a>
@ -165,7 +165,7 @@
</div>
<nav class="nav-wide-wrapper" aria-label="Page navigation">
<a rel="prev" href="nixos/roles.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
<a rel="prev" href="nixos/roles/github_actions_runner.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
<i class="fa fa-angle-left"></i>
</a>

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html" class="active"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html" class="active"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html" class="active"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html" class="active"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html" class="active"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html" class="active"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html" class="active"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html" class="active"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html" class="active"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html" class="active"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>

View File

@ -81,7 +81,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html" class="active"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../nixos/roles.html" class="active"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>
@ -145,7 +145,8 @@
<h2 id="roles"><a class="header" href="#roles">Roles</a></h2>
<p>Designed to take over a machine with the given role.</p>
<ul>
<li><code>roles-github-actions-runner</code> configures GitHub actions runner on a machine</li>
<li><a href="./roles/github_actions_runner.html">roles-github-actions-runner</a> configures <a href="https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners">GitHub
self hosted actions runner</a> on a machine</li>
</ul>
</main>
@ -156,7 +157,7 @@
<i class="fa fa-angle-left"></i>
</a>
<a rel="next" href="../installation.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<a rel="next" href="../nixos/roles/github_actions_runner.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<i class="fa fa-angle-right"></i>
</a>
@ -170,7 +171,7 @@
<i class="fa fa-angle-left"></i>
</a>
<a rel="next" href="../installation.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<a rel="next" href="../nixos/roles/github_actions_runner.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<i class="fa fa-angle-right"></i>
</a>
</nav>

View File

@ -0,0 +1,244 @@
<!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light">
<head>
<!-- Book generated using mdBook -->
<meta charset="UTF-8">
<title>GitHub Action Runner - SrvOS - NixOS for your server</title>
<!-- Custom HTML head -->
<meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#ffffff" />
<link rel="icon" href="../../favicon.svg">
<link rel="shortcut icon" href="../../favicon.png">
<link rel="stylesheet" href="../../css/variables.css">
<link rel="stylesheet" href="../../css/general.css">
<link rel="stylesheet" href="../../css/chrome.css">
<link rel="stylesheet" href="../../css/print.css" media="print">
<!-- Fonts -->
<link rel="stylesheet" href="../../FontAwesome/css/font-awesome.css">
<link rel="stylesheet" href="../../fonts/fonts.css">
<!-- Highlight.js Stylesheets -->
<link rel="stylesheet" href="../../highlight.css">
<link rel="stylesheet" href="../../tomorrow-night.css">
<link rel="stylesheet" href="../../ayu-highlight.css">
<!-- Custom theme stylesheets -->
</head>
<body>
<div id="body-container">
<!-- Provide site root to javascript -->
<script>
var path_to_root = "../../";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes -->
<script>
try {
var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar');
if (theme.startsWith('"') && theme.endsWith('"')) {
localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1));
}
if (sidebar.startsWith('"') && sidebar.endsWith('"')) {
localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1));
}
} catch (e) { }
</script>
<!-- Set the theme before any content is loaded, prevents flash -->
<script>
var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html');
html.classList.remove('no-js')
html.classList.remove('light')
html.classList.add(theme);
html.classList.add('js');
</script>
<!-- Hide / unhide sidebar before it is displayed -->
<script>
var html = document.querySelector('html');
var sidebar = 'hidden';
if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible';
}
html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar);
</script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="../../hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="../../nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="../../nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="../../nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="../../nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../nixos/roles/github_actions_runner.html" class="active"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../../installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="../../design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>
<div id="page-wrapper" class="page-wrapper">
<div class="page">
<div id="menu-bar-hover-placeholder"></div>
<div id="menu-bar" class="menu-bar sticky bordered">
<div class="left-buttons">
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
<i class="fa fa-bars"></i>
</button>
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
<i class="fa fa-paint-brush"></i>
</button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
<li role="none"><button role="menuitem" class="theme" id="light">Light</button></li>
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
</ul>
<button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar">
<i class="fa fa-search"></i>
</button>
</div>
<h1 class="menu-title">SrvOS - NixOS for your server</h1>
<div class="right-buttons">
<a href="../../print.html" title="Print this book" aria-label="Print this book">
<i id="print-button" class="fa fa-print"></i>
</a>
</div>
</div>
<div id="search-wrapper" class="hidden">
<form id="searchbar-outer" class="searchbar-outer">
<input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header">
</form>
<div id="searchresults-outer" class="searchresults-outer hidden">
<div id="searchresults-header" class="searchresults-header"></div>
<ul id="searchresults">
</ul>
</div>
</div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
<script>
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1);
});
</script>
<div id="content" class="content">
<main>
<h1 id="github-action-runner"><a class="header" href="#github-action-runner">GitHub Action Runner</a></h1>
<p>This role installs:</p>
<ul>
<li>One or more self hosted github action runner</li>
<li>One <a href="https://www.cachix.org">cachix</a> watch store service</li>
</ul>
<h2 id="authentication"><a class="header" href="#authentication">Authentication</a></h2>
<p>There are different ways a self hosted runner can register itself by GitHub.</p>
<ul>
<li>Using a Registration token</li>
<li>Using a Personal Authentication token</li>
<li>Using a GitHub App</li>
</ul>
<p>We will document hereafter how to connect using a new GitHub Application in your organization.</p>
<p>First, create the GitHub Application in <code>https://github.com/organizations/&lt;YOUR ORGANIZATION&gt;/settings/apps</code></p>
<ul>
<li>Click on <code>New GitHub App</code>.</li>
<li>In &quot;GitHub App name&quot; type <code>&lt;YOUR ORGANISATION&gt; App for GitHub runners</code>.</li>
<li>In &quot;Homepage&quot; fill in your project URL. It is required but won't be used hereafter.</li>
<li>Unselect <code>Expire user authorization tokens</code>.</li>
<li>Unselect <code>Active</code> in the &quot;Webhook&quot; section.</li>
<li>In the &quot;Organization permissions&quot; select <code>Read and write</code> next to the &quot;Self-hosted runner&quot; permission</li>
<li>Click on <code>Create GitHub App</code></li>
</ul>
<p>You should save securely the generated pem encoded private key. We will use that private key to configure the CI to use it.
You should also save the generated GitHub App Id.</p>
<p>Once created, you should also limit the usage of this github app to the CI hosts IPs (ipv4 and ipv6).</p>
<p>Application can be now be installed in your organization:</p>
<ul>
<li>Go to <code>https://github.com/organizations/&lt;YOUR ORGANIZATION&gt;/settings/apps</code></li>
<li>Click on the Edit button for our newly created GitHub app</li>
<li>Click on Install App and choose to install it on your organization</li>
</ul>
<p>Example:</p>
<pre><code class="language-bash">roles.github-actions-runner = {
url = &quot;https://github.com/&lt;YOUR ORGANIZATION&gt;&quot;;
count = 12;
name = &quot;github-runner&quot;;
githubApp = {
id = &quot;&lt;YOUR GENERATED APP ID&gt;&quot;;
login = &quot;&lt;YOUR ORGANIZATION&gt;&quot;;
privateKeyFile = config.age.secrets.github-app-runner-private-key.path;
};
cachix.cacheName = &quot;&lt;YOUR CACHIX ORGANIZATION&gt;&quot;;
cachix.tokenFile = config.age.secrets.cachixToken.path;
};
</code></pre>
<p><a href="https://docs.github.com/en/apps/creating-github-apps/creating-github-apps/creating-a-github-app">Official GitHub App creation documentation</a></p>
</main>
<nav class="nav-wrapper" aria-label="Page navigation">
<!-- Mobile navigation buttons -->
<a rel="prev" href="../../nixos/roles.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
<i class="fa fa-angle-left"></i>
</a>
<a rel="next" href="../../installation.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<i class="fa fa-angle-right"></i>
</a>
<div style="clear: both"></div>
</nav>
</div>
</div>
<nav class="nav-wide-wrapper" aria-label="Page navigation">
<a rel="prev" href="../../nixos/roles.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
<i class="fa fa-angle-left"></i>
</a>
<a rel="next" href="../../installation.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<i class="fa fa-angle-right"></i>
</a>
</nav>
</div>
<script>
window.playground_copyable = true;
</script>
<script src="../../elasticlunr.min.js"></script>
<script src="../../mark.min.js"></script>
<script src="../../searcher.js"></script>
<script src="../../clipboard.min.js"></script>
<script src="../../highlight.js"></script>
<script src="../../book.js"></script>
<!-- Custom JS scripts -->
</div>
</body>
</html>

View File

@ -82,7 +82,7 @@
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox">
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
<ol class="chapter"><li class="chapter-item expanded "><a href="hello.html"><strong aria-hidden="true">1.</strong> Hello</a></li><li class="chapter-item expanded "><a href="nixos.html"><strong aria-hidden="true">2.</strong> NixOS modules</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/general.html"><strong aria-hidden="true">2.1.</strong> General</a></li><li class="chapter-item expanded "><a href="nixos/hardware.html"><strong aria-hidden="true">2.2.</strong> Hardware</a></li><li class="chapter-item expanded "><a href="nixos/mixins.html"><strong aria-hidden="true">2.3.</strong> Mixins</a></li><li class="chapter-item expanded "><a href="nixos/roles.html"><strong aria-hidden="true">2.4.</strong> Roles</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="nixos/roles/github_actions_runner.html"><strong aria-hidden="true">2.4.1.</strong> GitHub Action Runner</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="installation.html"><strong aria-hidden="true">3.</strong> Installation</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="installation/hetzner_cloud.html"><strong aria-hidden="true">3.1.</strong> Hetzner Cloud</a></li></ol></li><li class="chapter-item expanded "><a href="design.html"><strong aria-hidden="true">4.</strong> Design</a></li></ol>
</div>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav>
@ -230,8 +230,57 @@ for monitoring rules targeting this telegraf configuration.</li>
<div style="break-before: page; page-break-before: always;"></div><h2 id="roles"><a class="header" href="#roles">Roles</a></h2>
<p>Designed to take over a machine with the given role.</p>
<ul>
<li><code>roles-github-actions-runner</code> configures GitHub actions runner on a machine</li>
<li><a href="nixos/./roles/github_actions_runner.html">roles-github-actions-runner</a> configures <a href="https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners">GitHub
self hosted actions runner</a> on a machine</li>
</ul>
<div style="break-before: page; page-break-before: always;"></div><h1 id="github-action-runner"><a class="header" href="#github-action-runner">GitHub Action Runner</a></h1>
<p>This role installs:</p>
<ul>
<li>One or more self hosted github action runner</li>
<li>One <a href="https://www.cachix.org">cachix</a> watch store service</li>
</ul>
<h2 id="authentication"><a class="header" href="#authentication">Authentication</a></h2>
<p>There are different ways a self hosted runner can register itself by GitHub.</p>
<ul>
<li>Using a Registration token</li>
<li>Using a Personal Authentication token</li>
<li>Using a GitHub App</li>
</ul>
<p>We will document hereafter how to connect using a new GitHub Application in your organization.</p>
<p>First, create the GitHub Application in <code>https://github.com/organizations/&lt;YOUR ORGANIZATION&gt;/settings/apps</code></p>
<ul>
<li>Click on <code>New GitHub App</code>.</li>
<li>In &quot;GitHub App name&quot; type <code>&lt;YOUR ORGANISATION&gt; App for GitHub runners</code>.</li>
<li>In &quot;Homepage&quot; fill in your project URL. It is required but won't be used hereafter.</li>
<li>Unselect <code>Expire user authorization tokens</code>.</li>
<li>Unselect <code>Active</code> in the &quot;Webhook&quot; section.</li>
<li>In the &quot;Organization permissions&quot; select <code>Read and write</code> next to the &quot;Self-hosted runner&quot; permission</li>
<li>Click on <code>Create GitHub App</code></li>
</ul>
<p>You should save securely the generated pem encoded private key. We will use that private key to configure the CI to use it.
You should also save the generated GitHub App Id.</p>
<p>Once created, you should also limit the usage of this github app to the CI hosts IPs (ipv4 and ipv6).</p>
<p>Application can be now be installed in your organization:</p>
<ul>
<li>Go to <code>https://github.com/organizations/&lt;YOUR ORGANIZATION&gt;/settings/apps</code></li>
<li>Click on the Edit button for our newly created GitHub app</li>
<li>Click on Install App and choose to install it on your organization</li>
</ul>
<p>Example:</p>
<pre><code class="language-bash">roles.github-actions-runner = {
url = &quot;https://github.com/&lt;YOUR ORGANIZATION&gt;&quot;;
count = 12;
name = &quot;github-runner&quot;;
githubApp = {
id = &quot;&lt;YOUR GENERATED APP ID&gt;&quot;;
login = &quot;&lt;YOUR ORGANIZATION&gt;&quot;;
privateKeyFile = config.age.secrets.github-app-runner-private-key.path;
};
cachix.cacheName = &quot;&lt;YOUR CACHIX ORGANIZATION&gt;&quot;;
cachix.tokenFile = config.age.secrets.cachixToken.path;
};
</code></pre>
<p><a href="https://docs.github.com/en/apps/creating-github-apps/creating-github-apps/creating-a-github-app">Official GitHub App creation documentation</a></p>
<div style="break-before: page; page-break-before: always;"></div><h1 id="installation"><a class="header" href="#installation">Installation</a></h1>
<ul>
<li><a href="./installation/hetzner_cloud.html">Hetzner Cloud</a></li>

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long