Container examples

This repository contains example container recipes for use in supercomputers.

The examples are in examples/ and below are general instructions on their use.

Building a new image

Build the new image on a local machine.

Ubuntu

If you don't have docker or podman, install using

sudo apt install podman-docker

If you are using podman for building, define

export BUILDAH_FORMAT=docker

Optional: For build or using singularity containers, install

sudo apt install singularity-container

Build the image

make build

Optional: Convert the local image to singularity:

make singularity

Optional: Push the image:

make build IMAGE_ROOT=ghcr.io/MY_NAMESPACE
docker login ghcr.io
make push

Login to ghcr.io using GitHub Personal Access Token with scope 'write:packages'. See these instructions.

Using built image via docker/podman

Run python with the image:

docker run -it --rm --entrypoint python3 IMAGE_NAME:IMAGE_VERSION

Using built image via singularity/apptainer

Use the locally created sif file (see make singularity above) or pull the pushed image:

export SINGULARITY_DOCKER_USERNAME=...
export SINGULARITY_DOCKER_PASSWORD=...
singularity pull docker://ghcr.io/MY_NAMESPACE/IMAGE_NAME:IMAGE_VERSION

Use GitHub Personal Access Token with scope 'read:packages' to pull private images. See these instructions.

Run python with the image:

singularity exec FILE.sif python3