PR #801 for #989: GH Workflow - Docker Build+Push to DockerHub and GH Container Registry

* Create ghcr.yml

Create and publish a Docker image to GitHub Container Registry

* Update installation.rst

Add reference to GitHub Container registry

* Update running-with-docker.rst

Add ghcr references

* Make ghcr conditional on main.yml

Updated main.yml run conditions & add on-success condition to ghcr.yml

* Miss aligned

* change workflow name

GHCR

* Update build to Build

Names didn't match GHCR condition

* Remove cog symbol from Build name

* Add paths-ignore

**.md

* Added build & push to DockerHub

* Add authorship & update header

* Tidy yml, add on-success condition

* Add on failure condition

* Remove GHC Tests and Conditional Push

* DockerHub Test - koalageo/pygeoapi

* DockerHub - Revert to geopython/pygeoapi

* Use SECRET for DockerHub repo

* Combined Build & Push

* Update tag function

* Fix tags for latest

* Lastest tag only on `master`

* Use tag on push tag event

* Add latest tag on default branch

* Add unit tests step

* Add separate build & test steps

* Typo in docs

* Move flake8 to before tests - catch errors early

* Add further tags

Co-authored-by: Benjamin Webb <40066515+webb-ben@users.noreply.github.com>

Co-authored-by: Benjamin Webb <40066515+webb-ben@users.noreply.github.com>

docs/source/installation.rst

@@ -49,11 +49,23 @@ pip
 Docker
 ------
 
+Using DockerHub
+^^^^^^^^^^^^^^^
+
 `Docker image <https://hub.docker.com/r/geopython/pygeoapi>`_
 
 .. code-block:: bash
 
    docker pull geopython/pygeoapi:latest
+   
+Using GitHub Container Registry   
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+`Docker image <https://github.com/geopython/pygeoapi/pkgs/container/pygeoapi>`_
+
+.. code-block:: bash
+
+   docker pull ghcr.io/geopython/pygeoapi:latest   
 
 Conda
 -----

docs/source/running-with-docker.rst

@@ -3,7 +3,7 @@
 Docker
 ======
 
-pygeoapi provides an official `Docker`_ image which is made available on the `geopython Docker Hub`_.  Additional
+pygeoapi provides an official `Docker`_ image which is made available on both the `geopython Docker Hub`_ and our `GitHub Container Registry`_.  Additional
 Docker examples can be found in the `pygeoapi GitHub repository`_, each with sample configurations, test data,
 deployment scenarios and provider backends.
 
@@ -17,6 +17,8 @@ The basics
 
 The official pygeoapi Docker image will start a pygeoapi Docker container using Gunicorn on internal port 80.
 
+Either ``IMAGE`` can be called with the ``docker`` command, ``geopython/pygeoapi`` from DockerHub or ``ghcr.io/geophython/pygeoapi`` from the GitHub Container Registry. Examples below use ``geopython/pygeoapi``. 
+
 To run with the default built-in configuration and data:
 
 .. code-block:: bash
@@ -113,6 +115,7 @@ Docker is an easy and reproducible approach to deploying systems.
 
 .. _`Docker`: https://www.docker.com
 .. _`geopython Docker Hub`: https://hub.docker.com/r/geopython/pygeoapi
+.. _`GitHub Container Registry`: https://github.com/geopython/pygeoapi/pkgs/container/pygeoapi
 .. _`pygeoapi GitHub repository`: https://github.com/geopython/pygeoapi
 .. _`pygeoapi demo server`: https://demo.pygeoapi.io
 .. _`useful examples`: https://github.com/geopython/demo.pygeoapi.io/tree/master/services