about summary refs log tree commit diff
path: root/README.org
diff options
context:
space:
mode:
Diffstat (limited to 'README.org')
-rw-r--r--README.org32
1 files changed, 27 insertions, 5 deletions
diff --git a/README.org b/README.org
index 892ab23..2aa45db 100644
--- a/README.org
+++ b/README.org
@@ -3,19 +3,40 @@ containers.
 
 The git repo lives at https://git.genenetwork.org/gn-machines/
 
-* GeneNetwork development container
+For CI/CD see
 
-The GeneNetwork development container is currently run on /tux02/. It runs
-continuous integration and continuous deployment services for
-genenetwork2, genenetwork3 and several other associated projects.
+=> https://issues.genenetwork.org/topics/systems/ci-cd
+
+For philosophy and (KISS) incremental minimalistic development containers, see:
+
+=> https://issues.genenetwork.org/topics/systems/debug-and-developing-code-with-genenetwork-system-container
+
+These are stored in the './minimal' directory of this repo. See the [[./minimal/README.md][README]].
+
+* GeneNetwork development container (aka CI/CD)
+
+The GeneNetwork development container is currently run on /tux02/.
+It runs continuous integration and continuous deployment services for genenetwork2, genenetwork3 and several other associated projects.
 
 To build and install the container, you will need the
 [[https://gitlab.com/genenetwork/guix-bioinformatics][guix-bioinformatics]] and [[https://git.systemreboot.net/guix-forge/][guix-forge]] channels. Once these channels are
 pulled and available, on /tux02/, run
+
 #+BEGIN_SRC shell
 $ ./genenetwork-development-deploy.sh
 #+END_SRC
 
+It will try to create symlinks at the end. You can do this as root (too).
+
+Note we current run as aruni user and the latest guix is the user profile.
+
+#+BEGIN_SRC shell
+aruni@tux02:~/gn-machines$ which guix
+/home/aruni/.config/guix/current/bin/guix
+aruni@tux02:~/gn-machines$ guix describe
+Generation 46   Mar 27 2025 23:39:42    (current)
+#+END_SRC
+
 /tux02/ is configured with a systemd service to run this
 container. Restart it.
 #+BEGIN_SRC shell
@@ -31,6 +52,7 @@ To build and install the container, you will need the
 guix-bioinformatics channel. Once guix-bioinformatics is pulled and
 available, on /tux01/, run
 #+begin_src shell
+
   $ ./virtuoso-deploy.sh
 #+end_src
 
@@ -55,7 +77,7 @@ You can get a shell into the container with something like:
   sudo guix container exec 89086 /run/current-system/profile/bin/bash --login
 #+END_SRC
 
-When you start the container, you can get a shell into the container using the ~nsenter~ command. You will need the process ID of the container, which you can see on container startup or on your can get with something like:
+When you start the container, you can get a shell into the container using the ~nsenter~ command. You will need the process ID of the container, which you can see on container startup or by inspecting the output of the following ~ps~ command:
 
 #+BEGIN_SRC sh
   ps -u root -f --forest | grep -A4 '/usr/local/bin/genenetwork-development-container' | grep 'shepherd'