Creating Docker Snapshots

This is a walk through of how to add an existing Docker Image to the platform and saving it as a snapshot file on the platform

To get started with this, you will either need to 1) open a ttyd or 2) have Docker installed and use you local terminal with dxtoolkit installed as well.

Overview of How to Use the Docker Image to Snapshot File

Example of the Code in Action

1. You have to pull the Docker image from the registry to the platform. For this example, the code is

docker pull broadinstitute/gatk 

That results in this view:

Notice that you will have extract and then pull complete on each of the "layers" of the image on the left hand side. This takes a few minutes depending on the size of the docker image

1. Now you have to save this docker image file. For this example, the code is

docker save broadinstitute/gatk -o gatk.tar.gz

This again takes time depending on the size of your docker file.

1. Now you will need to upload this image back to the platform. For this example, the code is:

dx upload gatk.tar.gz 

The last 2 steps have the following output:

It should then be in the project space that you have chosen. You can also check this in the GUI.

Example:

Resources

Full Documentation

Using Docker Images

To create a support ticket if there are technical issues:

1. Go to the Help header (same section where Projects and Tools are) inside the platform

2. Select "Contact Support"

3. Fill in the Subject and Message to submit a support ticket.