Docker Repository

In order to create a Tool, 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.

Importing a Public External Image

  1. Navigate to System Settings > Docker Repository.

  2. Click + New 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)

Note: 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.

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.

Importing a Private Image

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 the project Data.

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

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

  5. Click on +New.

  6. Click on the magnifying glass to find your uploaded TAR image file.

  7. Select the appropriate region and if needed, filter on project from the drop-down menus to find your file.

  8. Select that file.

  9. 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.

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 in the top menu on Manage > Change Format to change it to Docker format so ICA can recognize the file.

Last updated