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.
Navigate to System Settings > Docker Repository.
Click + New external image to add a new external image.
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.
(Optional) Complete the Description field.
Click Save.
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. 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.
In order to use private images in your tool, you must first upload them as a TAR file.
Navigate to Projects > your_project .
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.
Select your uploaded TAR file and click in the top menu on Manage > Change Format .
Select DOCKER from the drop-down menu and Save.
Navigate to System Settings > Docker Repository (outside of your project).
Click on +New.
Click on the magnifying glass to find your uploaded TAR image file.
Select the appropriate region and if needed, filter on project from the drop-down menus to find your file.
Select that file.
Select the appropriate region, fill in the Docker Name and Version, and click Save.
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.
Navigate to System Settings > Docker Repository.
Either
Select the required image(s) and go to Manage > Add to Regions.
OR double-click on a required image, check the box matching the region you want to add, and select update.
In both cases, allow a few minutes for the image to become available in the new region (the status becomes available in table view).
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.