Updated GitHub actions with parameterized tag; Updated readme to document actions build pipeline

Author: kkrick-sdsu

.github/workflows/build.yml

@@ -3,10 +3,15 @@ name: Build Jupyter Coder Images
 
 on:
   workflow_dispatch:
+    inputs:
+      jupyter_tag:
+        description: 'Jupyter tag (e.g. 2025-11-10)'
+        required: false
+        default: 'latest' 
   push:
     branches: [ main ]
     paths:
-      - "images/**"
+      - "images/jupyter/**"
       - ".github/workflows/build.yml"
 
 jobs:
@@ -19,13 +24,13 @@ jobs:
       fail-fast: false
       matrix:
         base:
-          - jupyter/minimal-notebook:latest
-          - jupyter/scipy-notebook:latest
-          # - jupyter/datascience-notebook:latest
-          # - jupyter/tensorflow-notebook:latest
-          # - jupyter/pytorch-notebook:latest
-          # - jupyter/r-notebook:latest
-          # - jupyter/all-spark-notebook:latest
+          - quay.io/jupyter/minimal-notebook:${{ inputs.jupyter_tag || vars.JUPYTER_TAG || 'latest' }}
+          - quay.io/jupyter/scipy-notebook:${{ inputs.jupyter_tag || vars.JUPYTER_TAG || 'latest' }}
+          - quay.io/jupyter/datascience-notebook:${{ inputs.jupyter_tag || vars.JUPYTER_TAG || 'latest' }}
+          - quay.io/jupyter/tensorflow-notebook:cuda-${{ inputs.jupyter_tag || vars.JUPYTER_TAG || 'latest' }}
+          - quay.io/jupyter/pytorch-notebook:cuda12-${{ inputs.jupyter_tag || vars.JUPYTER_TAG || 'latest' }}
+          - quay.io/jupyter/r-notebook:${{ inputs.jupyter_tag || vars.JUPYTER_TAG || 'latest' }}
+          - quay.io/jupyter/julia-notebook:${{ inputs.jupyter_tag || vars.JUPYTER_TAG || 'latest' }}
     steps:
       - uses: actions/checkout@v4
 
@@ -49,7 +54,7 @@ jobs:
           # e.g., jupyter/scipy-notebook:latest -> scipy-notebook
           NAME="$(echo "$BASE" | awk -F'[/:]' '{print $(NF-1)}')"
           echo "name=$NAME" >> $GITHUB_OUTPUT
-          # Tag scheme: ghcr.io/org/repo/<stack>:<upstream-tag>-coder
+          # Tag scheme: ghcr.io/org/repo/<stack>:<jupyter-tag>-coder
           OWNER="$(echo '${{ github.repository_owner }}' | tr '[:upper:]' '[:lower:]')"
           REPO="$(echo '${{ github.repository }}' | cut -d/ -f2 | tr '[:upper:]' '[:lower:]')"
           echo "image=ghcr.io/$OWNER/$REPO/$NAME" >> $GITHUB_OUTPUT
@@ -65,5 +70,6 @@ jobs:
           push: true
           tags: |
             ${{ steps.names.outputs.image }}:latest
+            ${{ steps.names.outputs.image }}:${{ inputs.jupyter_tag || vars.JUPYTER_TAG || 'latest' }}
           cache-from: type=gha
           cache-to: type=gha,mode=max

README.md

@@ -6,13 +6,35 @@ Container images for use with [Coder](https://github.com/coder/coder)
 
 We repackage several of the [Jupyter Docker Stacks](https://github.com/jupyter/docker-stacks) images with necessary changes to work with Coder.
 
+### GitHub Actions Build Instructions
+
+This repo is configured to build all of the container images specified in the GitHub Actions [.github/workflows/build.yml](./.github/workflows/build.yml) file.
+These builds can be viewed at [Build Jupyter Coder Images](https://github.com/SDSU-Research-CI/coder-images/actions/workflows/build.yml).
+The resulting container images should be linked on the repo home page in the packages section to the right.
+
+Builds can be triggered manually on the repo's actions tab, via pushing an update to the repo under the `images/jupyter` directory or an update to the workflow yaml file itself.
+The jupyter tag should be given a value of `latest` or a build date like `2025-11-10` on the respective images from [quay.io/organization/jupyter](https://quay.io/organization/jupyter).
+Either build trigger will default to `latest` if unset.
+- Manually triggered builds will prompt for a jupyter_tag value
+- Automatic builds will use the value of the JUPYTER_TAG variable specified in the repo Settings → Secrets and variables → Actions → Variables
+
+>Note: There are some images which have a specific cuda version which may need to have the `cuda12` portion of their tag updated directly in the action yaml file. I.E. the PyTorch notebook.
+
 ### Manual Build Instructions
 
 Some images may need to be built locally due to container image size limitations in GitHub Actions.
 As of writing, this limitation is currently 10GB.
 
 In order to build the Jupyter Docker Stack-based images locally, we need to specify the build target of `notebook-image`, i.e.:
 
-```
+```bash
 docker build . -f Dockerfile -t [your-dockerhub-username]/[image-name]:v[x.x] --target notebook-image
 ```
+
+Once the container has been built, it should be tested on a dev instance of coder prior to being retagged as an official image.
+
+Execute the following to retag a locally built image, replacing the notebook name:
+```bash
+docker image tag [container-id] ghcr.io/sdsu-research-ci/coder-images/[notebook-name]:[jupyter_tag]
+```
+- I.E. `docker image tag ea984ac26018 ghcr.io/sdsu-research-ci/coder-images/minimal-notebook:2025-11-10`