How-To: Bring Your Own Container Image to the Analytics Enclave

Table of Contents

• Prerequisites
• Instructions
  
• References

Purpose

This document demonstrates how to import a container image into the Enclave environment using a Linux Virtual Desktop. These instructions DO NOT apply to Enclave Windows Virtual Desktops.

Prerequisites

• You should have submitted an Access Request Form.
• Have access to an Enclave Linux Virtual Desktop.
• Have access to the Enclave Docker Registry.
• Have your container image saved as a tar archive.

Instructions

The docker and podman commands can be used interchangeably.

Step 1 - Save container images to a tar archive

In order to bring a container image to the Enclave, it must be saved as a tar archive so it can be easily transferred.

See Docker Docs - docker save

Step 2 - Transfer container image to your Enclave desktop

This KB article explains the process

Step 3 - Import container image

Once transferred to your Enclave Desktop (VDI), import it like so.

See Docker Docs - docker import

Step 4 - Log in to registry using your company credentials

Sign in to Execute this command from VDI

Step 5 - Tag container image

Replace container <image_id> and <image_name> accordingly.

<image_tag> can be "latest" or a version number such as "v1" etc.

See Docker Docs - docker image tag

Step 6 - Push container image to registry

This step uploads the image from your VDI to the Enclave container registry.

Notice the registry host and repository under which container image will reside.

See Docker Docs - docker push

Step 6 - Validate upload was successful

Browse repository to validate your container image was uploaded successfully.

https://repo.analyticsenclave.org/ui/native/docker-local/

References

• Docker Documentation
• How to push docker image to private registry