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.
You need to ask for an account on the c4science registry, see Account request.
Upload an image to Shifter from dockerhub using the registry.c4science.ch (preferred)
You need to have Docker installed on your machine
Get a docker image from dockerhub for instance
- Set up your machine
Login on the registry from your local Docker installation (you need an account, see Account request)
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):
Upload an image directly from dockerhub to Shifter
Optionnal (for private dockerhub images)
Get the image from dockerhub by specifying the image account (optionnal for official image) and name
Run the image on the clusters
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.
Account on the c4science registry