aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCollin J. Doering2024-12-16 22:00:45 -0500
committerCollin J. Doering2024-12-16 23:49:42 -0500
commit3c9b43d98c392df288836d593c4e01e3633ad3aa (patch)
tree098ed928bb5f5a498c743e4e54ddfb27c6b7f3c7
parent0fa98d1c0cdd05e87d2eb68a28e39c770814d623 (diff)
downloadguix-north-america-3c9b43d98c392df288836d593c4e01e3633ad3aa.tar.gz
Adjust formatting and typos; mark a section as TODO
Only a few TODO's to complete until the blog is ready for final review!
-rw-r--r--docs/blog-Tennnessee-build-farm.org42
1 files changed, 30 insertions, 12 deletions
diff --git a/docs/blog-Tennnessee-build-farm.org b/docs/blog-Tennnessee-build-farm.org
index 5b7d916..dfe738c 100644
--- a/docs/blog-Tennnessee-build-farm.org
+++ b/docs/blog-Tennnessee-build-farm.org
@@ -8,13 +8,18 @@ resource-intensive. This is where substitute servers play a crucial role, allowi
download pre-built binary packages instead of compiling them locally.
Here we built a dedicated build farm and substitute server in just few lines of code!
-Guix hands us the programmer's dream of deploying a full server with its services and orchestration as a program!
-Not only can the 'program' be adapted to other machines -- across the planet -- the deployment also benefits from Guix reproducibility guarantees, including natural roll-backs of full and partial deployment.
-The federated nature of these build farms is increasingly important - in fact, I invite you to roll-your-own based on this article.
+
+Guix hands us the programmer's dream of deploying a full server with its services and
+orchestration as a program! Not only can the 'program' be adapted to other machines -- across
+the planet -- the deployment also benefits from Guix reproducibility guarantees, including
+natural roll-backs of full and partial deployment. The federated nature of these build farms
+is increasingly important - in fact, I invite you to roll-your-own based on this article.
Earlier this year [[https://lists.gnu.org/archive/html/guix-devel/2024-07/msg00033.html][I announced on the guix mailing list]] that a new North American based Guix
substitute server and build farm, cuirass.genenetwork.org, was available for general use.
-Having a server in the USA increases the speed and reduces the latency for North American downloaders of Guix and all 20,000+ built free software packages. It also provides redundancy in case something happens with other substitute servers.
+Having a server in the USA increases the speed and reduces the latency for North American
+downloaders of Guix and all 20,000+ built free software packages. It also provides redundancy
+in case something happens with other substitute servers.
* Why Build Another Substitute Server?
@@ -210,7 +215,7 @@ configuring Nginx tls.
".pem"))
#+end_src
-*** Configure Nginx Location block for ~guix-publish~
+*** TODO Configure Nginx Location block for ~guix-publish~
Lets define a function that given a url, produces the appropriate nginx location blocks to
enable guix-publish running on some provided URL.
@@ -367,8 +372,14 @@ Lets look and explain the purpose of each location-configuration.
#+begin_src scheme
;; Try to prevent good-faith crawlers from downloading substitutes.
- (nginx-location-configuration (uri "= /robots.txt") (body (list #~(string-append "try_files "
- #$(plain-file "robots.txt" publish-robots.txt) " =404;") "root /;")))
+ (nginx-location-configuration
+ (uri "= /robots.txt")
+ (body
+ (list
+ #~(string-append "try_files "
+ #$(plain-file "robots.txt" publish-robots.txt)
+ " =404;")
+ "root /;")))
#+end_src
*** TODO Nginx locations (FIND BETTER NAME)
@@ -589,7 +600,7 @@ create a [[https://guix.gnu.org/manual/en/html_node/Service-Reference.html][simp
This service can then be added to the ~services~ field of our ~operating-system~
configuration, finalization our configuration of nginx.
-** Setup guix-daemon
+** TODO Setup guix-daemon
- Allow for substitutes from this server
- Adjust guix-daemon configuration (timeouts, # of build accounts, # of cores to use)
@@ -749,8 +760,15 @@ We invite other organizations, universities, and community members to consider s
their own substitute servers. Each new node makes the Guix network stronger, more resilient,
and more accessible.
-** Acknowledgements
+** Acknowledgments
+
+We thank the Guix North America team consisting of Collin Doering, Pjotr Prins and Arun
+Isaac.
-We thank the Guix North America team consisting of Collin Doering, Pjotr Prins and Arun Isaac.
-We wish to acknowledge the GNU Guix project, in particular Ludovic Courtès, Efraim Flashner, Christopher Baines, Ricardo Wurmus, Christine Lemmer-Webber and Andy Wingo for their incredible work on GNU Guix and GNU Guile and are a continuous inspiration. Without their input our work would not be possible.
-We also wish to acknowledge the fantastic [GeneNetwork and Pangenome teams](https://genenetwork.org/facilities/) for providing support and hardware, including the spiffy AMD Genoa machine that runs the Tennessee Guix Build Farm at Memphis-based [Worldspice](https://www.worldspice.net/).
+We wish to acknowledge the GNU Guix project, in particular Ludovic Courtès, Efraim Flashner,
+Christopher Baines, Ricardo Wurmus, Christine Lemmer-Webber and Andy Wingo for their
+incredible work on GNU Guix and GNU Guile and are a continuous inspiration. Without their
+input our work would not be possible. We also wish to acknowledge the fantastic [GeneNetwork
+and Pangenome teams](https://genenetwork.org/facilities/) for providing support and hardware,
+including the spiffy AMD Genoa machine that runs the Tennessee Guix Build Farm at
+Memphis-based [Worldspice](https://www.worldspice.net/).