From 7767409735019cae08cb618093add358120e3b99 Mon Sep 17 00:00:00 2001
From: Wirawan Purwanto <wpurwant@odu.edu>
Date: Tue, 31 Aug 2021 11:26:46 -0400
Subject: [PATCH] * Added starting files for Singularity-related KB (WIP).

---
 singularity/20200710.Build-Ubuntu-20-04.md    | 11 +++++
 .../20200710.Singularity-def-basics.md        | 24 ++++++++++
 .../20200710.Singularity-get-started.md       | 48 +++++++++++++++++++
 3 files changed, 83 insertions(+)
 create mode 100644 singularity/20200710.Build-Ubuntu-20-04.md
 create mode 100644 singularity/20200710.Singularity-def-basics.md
 create mode 100644 singularity/20200710.Singularity-get-started.md

diff --git a/singularity/20200710.Build-Ubuntu-20-04.md b/singularity/20200710.Build-Ubuntu-20-04.md
new file mode 100644
index 0000000..9841f4f
--- /dev/null
+++ b/singularity/20200710.Build-Ubuntu-20-04.md
@@ -0,0 +1,11 @@
+Singularity Container from Scratch: Ubuntu 20.04
+================================================
+
+
+Example: Ubuntu 20.04
+---------------------
+
+**Goal**: Let's get a base Ubuntu 20.04 image up and running.
+
+
+
diff --git a/singularity/20200710.Singularity-def-basics.md b/singularity/20200710.Singularity-def-basics.md
new file mode 100644
index 0000000..ffe2b31
--- /dev/null
+++ b/singularity/20200710.Singularity-def-basics.md
@@ -0,0 +1,24 @@
+Basics of Singularity Def File
+==============================
+
+[20200710]
+
+Definitive guide (the doc):
+
+https://sylabs.io/guides/3.5/user-guide/definition_files.html
+
+
+
+"Bootstrap" keyword
+-------------------
+
+Defines how we get the starting image
+
+* `library`: on Sylab Cloud container library
+* `docker`: Docker Hub
+  See: <https://sylabs.io/guides/3.5/user-guide/appendix.html#build-docker-module>
+
+See: <https://sylabs.io/guides/3.5/user-guide/definition_files.html#preferred-bootstrap-agents>
+
+
+https://cloud.sylabs.io/library
diff --git a/singularity/20200710.Singularity-get-started.md b/singularity/20200710.Singularity-get-started.md
new file mode 100644
index 0000000..0c8f875
--- /dev/null
+++ b/singularity/20200710.Singularity-get-started.md
@@ -0,0 +1,48 @@
+Singularity: Getting Started
+============================
+
+
+Singularity tutorials
+---------------------
+
+<https://singularity-tutorial.github.io/>
+
+
+Relevant Documentations
+-----------------------
+
+* Singularity def files:
+  <https://sylabs.io/guides/3.5/user-guide/definition_files.html>
+
+
+Examples (templates)
+--------------------
+
+Examples of Singularity container defs:
+
+<https://github.com/sylabs/examples>
+
+
+
+
+How to build a basic Singularity container
+------------------------------------------
+
+Steps:
+
+
+* create a writable container (called a sandbox)
+
+* shell into the container with the --writable option and tinker with
+  it interactively
+
+* record changes that we like in our definition file
+
+* rebuild the container from the definition file if we break it
+
+* rinse and repeat until we are happy with the result
+
+* rebuild the container from the final definition file as a read-only
+  singularity image format (SIF) image for use in production
+
+