When you want to run Docker containers on the clusters.
You can use public images without being authenticated (shifterimg login) in the following cases:
|Image source||Public image||Login required|
|C4science registry||No||Yes, c4science registry|
When using authentication, it's relative to the source you want to use (dockerhub and c4science registry supported) and the authentication is saved per cluster.
Running a Docker image with Shifter - Step by step
You need to have Docker installed on your machine
Get a docker image from dockerhub for instance
- Account on the c4science registry
- Set up your machine
Login on the registry from your local Docker installation
Upload a Docker image to the registry
- On the web interface, create a Project on the registry (private or public)
Tag the image you want to upload on your local machine and push it to the registry
NOTE: Do not use the `-` character in the tag name, only letters, numbers and underscore
Pull an image on Shifter and specify a user or group ACL
From each cluster frontend (i.e.: fidis.epfl.ch), login to the registry, pull the image and check it's was pulled with success.
You can specify one or multiple (separated by a comma) LDAP username and/or group so the image is only available to those people
- To update the user/group ACL you can re-run the pull command
- The images are unique for each cluster (deneb, fidis, helvetios, izar)
To view the full info about the images (warning: JSON):
- Run the image
You can submit the following Slurm script with the sbatch command
Interactive Shell (Bash)
To have an interactive shell within your image, simply use this:
On Deneb shifter runtime is installed on the GPU nodes. You need prior access to the GPUs nodes, see FAQ
FEEDBACK is welcome as this feature is experimental.