smi-format-support

A repository for the Informatics Matters DataTier dataset smi-format-support container image implementations.

Building

You should be able to build your format-support image using docker: -

$ docker build . -t ${PWD##*/}:latest

Or docker-compose: -

$ IMAGE_NAME=${PWD##*/} docker-compose build

Testing

Familiarise yourself with TESTING.md, which describes the testing strategy

For more information on the tests for this repo, see [test/readme.md] A simple shell script cas been written to run all the tests. The command is: -

$ ./test/runtests.sh

The remaining text in this file has been left unmodified from the template for information.

Required image tags

The DataTier Manager will only execute formatter images tagged :stable so you MUST ultimately produce an image with this tag. You are also encouraged to produce a :latest tag and any specific tags that satisfy your own needs (with formats like 1.0.0-rc.1, 1.0.0 and 2021.1).

This repository's built-in GitHub Actions (see the next section) will do all this for you.

Built-in GitHub Actions

The template contains a number of GitHub Actions that will automatically build the container image and also publish :latest and any tags you make to Docker Hub.

This relies on your docker registry mirroring your repository. If your docker repository name does not mirror your GitHub repository name then you will need to adjust these actions. For example, if you create a GitHub repository from this one and call it 'XYZ/my-support-template' then you must be able to push docker images to 'xyz/my-support-template:latest'. If not, you will need to edit the workflow files to satisfy your needs.

Your images must be published to Docker Hub.

The following built-in actions are: -

For every commit to main an Action builds the docker image and pushes it using the image tag :latest. This is accomplished by the publish-latest.yaml Action.
For every repository tag an Action builds the docker image and pushes it with the image tag :<tag> This is accomplished by the publish-tag.yaml Action.
- If the tag looks like a formal release, i.e. is a 2 or 3-digit number like 2021.1 or 1.0.0 an Action builds the docker image and pushes it using the image tag :<tag> and the tag :stable This is accomplished by the publish-stable.yaml Action.
For every commit on a branch, or a pull request to main, an Action runs that just builds the docker image - but does not push it. This is accomplished by the build.yaml Action.

In order for the above Actions to succeed you will need to define the following GitHub Repository (or Organisation) secrets: -

DOCKERHUB_USERNAME A Docker Hub user
DOCKERHUB_TOKEN A Docker Hub user password or, ideally, access token

Repositories created in the InformaticsMatters organisation are already presented with these secrets as they are already defined at the Organisation level.

Updating the badge links

Don't forget to replace the InformaticsMatters/format-support-template values in the above badge links with the name of your own repository, otherwise your badges will reflect the template repository's state, not yours.