From 7c8bc2c9eb661ee0468dd195ab6e8b7258662bc6 Mon Sep 17 00:00:00 2001
From: Arun Isaac
Date: Mon, 14 Aug 2023 22:28:04 +0100
Subject: doc: Add cgit setup how to.

* doc/forge.skb (How To): New chapter.
* doc/snippets/acme-staging-url.scm,
doc/snippets/how-to-set-up-cgit.scm: New files.
* tissue.scm (#:indexed-documents): Index chapter-how-to.
---
 doc/snippets/acme-staging-url.scm   |  4 ++++
 doc/snippets/how-to-set-up-cgit.scm | 38 +++++++++++++++++++++++++++++++++++++
 2 files changed, 42 insertions(+)
 create mode 100644 doc/snippets/acme-staging-url.scm
 create mode 100644 doc/snippets/how-to-set-up-cgit.scm

(limited to 'doc/snippets')

diff --git a/doc/snippets/acme-staging-url.scm b/doc/snippets/acme-staging-url.scm
new file mode 100644
index 0000000..daa1052
--- /dev/null
+++ b/doc/snippets/acme-staging-url.scm
@@ -0,0 +1,4 @@
+(service acme-service-type
+         (acme-configuration
+          (email "foo@example.org")
+          (acme-url %letsencrypt-staging-url)))
diff --git a/doc/snippets/how-to-set-up-cgit.scm b/doc/snippets/how-to-set-up-cgit.scm
new file mode 100644
index 0000000..8bb1975
--- /dev/null
+++ b/doc/snippets/how-to-set-up-cgit.scm
@@ -0,0 +1,38 @@
+(use-modules (gnu)
+             ((gnu packages admin) #:select (shepherd))
+             (forge acme)
+             (forge cgit)
+             (forge nginx)
+             (forge socket))
+
+(operating-system
+  (host-name "forge")
+  (timezone "UTC")
+  (locale "en_US.utf8")
+  (bootloader (bootloader-configuration
+               (bootloader grub-bootloader)
+               (targets (list "/dev/sdX"))))
+  (file-systems %base-file-systems)
+  (sudoers-file
+   (mixed-text-file "sudoers"
+                    "@include " %sudoers-specification
+                    ;; Permit the acme user to restart nginx.
+                    "\nacme ALL = NOPASSWD: "
+                    (file-append shepherd "/bin/herd")
+                    " restart nginx\n"))
+  (services (cons* (service cgit-service-type
+                            (cgit-configuration
+                             (server-name "git.example.org")
+                             (repository-directory "/srv/git")))
+                   (service forge-nginx-service-type
+                            (forge-nginx-configuration
+                             (http-listen (forge-ip-socket
+                                           (ip "0.0.0.0")
+                                           (port 8080)))
+                             (https-listen (forge-ip-socket
+                                            (ip "0.0.0.0")
+                                            (port 4443)))))
+                   (service acme-service-type
+                            (acme-configuration
+                             (email "foo@example.org")))
+                   %base-services)))
-- 
cgit v1.2.3