- Adds our standard control variables comment-block

Author: Alan Christie

.github/workflows/build-latest.yaml

@@ -1,6 +1,27 @@
 ---
 name: build and push latest
 
+# -----------------
+# Control variables (GitHub Secrets)
+# -----------------
+#
+# At the GitHub 'organisation' or 'project' level you must have the following
+# GitHub 'Repository Secrets' defined (i.e. via 'Settings -> Secrets'): -
+#
+# DOCKERHUB_USERNAME
+# DOCKERHUB_TOKEN
+#
+# -----------
+# Environment (GitHub Environments)
+# -----------
+#
+# Environment         (none)
+#
+# For automated deployment we expect the following in the environment: -
+#
+# (none)
+
+
 on:
   push:
     branches:

.github/workflows/build-stable.yaml

@@ -2,14 +2,35 @@
 name: build and push stable
 
 # Actions for an 'official' tag.
-
-# An official tag is a 3-digit value (i.e. 'N.N.N').
+#
+# An official tag is a 2 or 3-digit value (i.e. 'N.N[.N]').
 # We publish images using the tag as a tag and one using 'stable' as s tag.
 
+# -----------------
+# Control variables (GitHub Secrets)
+# -----------------
+#
+# At the GitHub 'organisation' or 'project' level you must have the following
+# GitHub 'Repository Secrets' defined (i.e. via 'Settings -> Secrets'): -
+#
+# DOCKERHUB_USERNAME
+# DOCKERHUB_TOKEN
+#
+# -----------
+# Environment (GitHub Environments)
+# -----------
+#
+# Environment         (none)
+#
+# For automated deployment we expect the following in the environment: -
+#
+# (none)
+
 on:
   push:
     tags:
     - '[0-9]+.[0-9]+.[0-9]+'
+    - '[0-9]+.[0-9]+'
 
 jobs:
   push-stable:

.github/workflows/build-tag.yaml

@@ -2,15 +2,35 @@
 name: build and push tag
 
 # Actions for any 'unofficial' tag.
+#
+# It's not an official tag if it's not formed from 2 or 3 digits
+# (i.e. is not 'N.N[.N]'). We publish images using the tag as a tag.
 
-# It's not an official tag if it's not formed from three digits
-# (i.e. is not 'N.N.N').
-# We publish images using the tag as a tag.
+# -----------------
+# Control variables (GitHub Secrets)
+# -----------------
+#
+# At the GitHub 'organisation' or 'project' level you must have the following
+# GitHub 'Repository Secrets' defined (i.e. via 'Settings -> Secrets'): -
+#
+# DOCKERHUB_USERNAME
+# DOCKERHUB_TOKEN
+#
+# -----------
+# Environment (GitHub Environments)
+# -----------
+#
+# Environment         (none)
+#
+# For automated deployment we expect the following in the environment: -
+#
+# (none)
 
 on:
   push:
     tags:
     - '**'
+    - '![0-9]+.[0-9]+'
     - '![0-9]+.[0-9]+.[0-9]+'
 
 jobs:

.github/workflows/build.yaml

@@ -6,6 +6,21 @@ name: build
 # Here we build container images but don't push them
 # and therefore do not require docker credentials.
 
+# -----------------
+# Control variables (GitHub Secrets)
+# -----------------
+#
+# At the GitHub 'organisation' or 'project' level you must have the following
+# GitHub 'Repository Secrets' defined (i.e. via 'Settings -> Secrets'): -
+#
+# (none)
+#
+# -----------
+# Environment (GitHub Environments)
+# -----------
+#
+# Environment         (none)
+
 on:
   push:
     branches-ignore: