Publishing Docker Image of Your InterSystems IRIS Solution to Github Registry Automatically

Hi folks!

Sometimes we need the docker image of the InterSystems IRIS solution we build to be published on some docker registry. The cases could be:

1. Deploy it then in Kubernetes cluster
2. Let your pal run the image of your public repo without building it locally.

You can push the image to Docker Hub Registry or Github Registry.

In this very short article, I provide a way how to do it automatically on every push to your GitHub repository.

Just add the following file into .github/workflows folder of your repository:

name: Build and publish a Docker image to ghcr.io

on:



# publish on pushes to the main branch (image tagged as "latest")

# image name: will be: ghcr.io/${{ github.repository }}:latest

# e.g.: ghcr.io/intersystems-community/intersystems-iris-dev-template:latest

push:

branches:

- master



jobs:

docker_publish:

runs-on: "ubuntu-20.04"



steps:

- uses: actions/checkout@v2



# https://github.com/marketplace/actions/push-to-ghcr

- name: Build and publish a Docker image for ${{ github.repository }}

uses: macbre/push-to-ghcr@master

with:

image_name: ${{ github.repository }}

github_token: ${{ secrets.GITHUB_TOKEN }}

# optionally push to the Docker Hub (docker.io)

# docker_io_token: ${{ secrets.DOCKER_IO_ACCESS_TOKEN }} # see https://hub.docker.com/settings/security

With any filename. See the example in iris-dev-template.

Every time you push the commit to the repository Github will execute this workflow to bake and publish the image on Github Registry.

The published image can be pulled and run in docker by anyone, e.g. like this iris-dev-template:

# docker run --rm --name my-iris -d --publish 9091:1972 --publish 9092:52773 ghcr.io/intersystems-community/intersystems-iris-dev-template:latest

The file can work in any repo without any change. The images will have different names of course - equal to the repo name plus ghcr.io/  in front and latest in the end.

I stole the approach from the GitHub documentation and included in the community template.

Hope you'll find it useful.