Docker Repository

In order to create a Tool or Bench image, a Docker image is required to run the application in a containerized environment. Illumina Connected Analytics supports both public Docker images and private Docker images uploaded to ICA.

Use Docker images built for x86 architecture or multi-platform images that support x86. You can build Docker images that support both ARM and X86 structure.

Importing a Public External Image (Tools)

1. Navigate to System Settings > Docker Repository.

2. Click Create > External image to add a new external image.

3. Add your full image URL in the Url field, e.g. docker.io/alpine:latest or registry.hub.docker.com/library/alpine:latest. Docker Name and Version will auto-populate. (Tip: do not add http:// or https:// in your URL)

Do not use :latest when the repository has rate limiting enabled as this interferes with caching and incurs additional data transfer.

1. (Optional) Complete the Description field.

2. Click Save.

3. The newly added image will appear in your Docker Repository list. You can differentiate between internal and external images by looking at the Source column. If this column is not visible, you can add it with the columns icon ().

Verification of the URL is performed during execution of a pipeline which depends on the Docker image, not during configuration.

External images are accessed from the external source whenever required and not stored in ICA. Therefore, it is important not to move or delete the external source. There is no status displayed on external Docker repositories in the overview as ICA cannot guarantee their availability.

The use of :stable instead of :latest is recommended.

Importing a Private Image (Tools + Bench Images)

In order to use private images in your tool, you must first upload them as a TAR file.

1. Navigate to Projects > your_project .

2. Upload your private image as a TAR file, either by dragging and dropping the file in the Data tab, using the CLI or a Connector. For more information please refer to project Data.

3. Select your uploaded TAR file and click in the top menu on Manage > Change Format .

4. Select DOCKER from the drop-down menu and Save.

   
5. Navigate to System Settings > Docker Repository (outside of your project).

6. Click on Create > Image.

7. Click on the Docker image field. Select the TAR file from the desired region.

   
8. Provide a name and version for your Docker image

9. Select the appropriate region, determine the type (tool or bench image), the cluster compatibility (only available for bench images), access method and click Save.

10. The newly added image should appear in your Docker Repository list. Verify it is marked as Available under the Status column to ensure it is ready to be used in your tool or pipeline.

Copying Docker Images to other Regions

1. Navigate to System Settings > Docker Repository.

2. Either

   • Select the required image(s) and go to Manage > Add Region.

   • OR open the image details, check the box matching the region you want to add, and select update.

3. In both cases, allow a few minutes for the image to become available in the new region (the status becomes available in table view).

To remove regions, go to Manage > Remove Region or unselect the regions from the Docker image detail view.

Downloading Docker Images

You can download your created Docker images at System Settings > Docker Images > your_Docker_image > Manage > Download.

In order to be able to download Docker images, the following requirements must be met:

• The Docker image can not be from an entitled bundle.

• Only self-created Docker images can be downloaded.

• The Docker image must be an internal image and in status Available.

• You can only select a single Docker image at a time for download.

• You need a service connector with a download rule to download the Docker image.

File Size Considerations

Docker image size should be kept as small as practically possible. To this end, it is best practice to compress the image. After compressing and uploading the image, select your uploaded file and click Manage > Change Format in the top menu to change it to Docker format so ICA can recognize the file.