A container image, much like a VM image (though much smaller), is the "blueprint" containers are created from. All dependencies, as well as your application code, is baked into an image. Multiple containers can be created that use the same image.

Importing an Image

The image import form is nearly identical to the import form used on the single container deploy wizard. Using this form, you can (re)import images individually. To get to the main image import form, follow these steps:

  1. Click Images in the nav menu on the left hand side.
  2. In the top right corner, click the blue Import Image button.

Import Sources

Cycle does not store your credentials for your private registry or repository. You will need to provide them every time you import that image.

Using the tabs on the left, select the source you wish to import from. At this time, you can import from either Docker Hub, or a private Docker Registry.

Docker Hub

Typing in the "Image Name" box will automatically search as you type, returning images along with their description and rating. Select your image from the list (or enter a custom one), then set the tag in the tag field. By default Cycle will import the 'latest' tag. You may also provide custom authorization by selecting the "Use Auth" checkbox. Enter your username and password into the respective fields.

Docker Registry

If you choose to import from a Docker Registry, the process is the same, except in the URL field you will need to enter the custom url the registry is hosted on. For example, if your image name, you would enter into the URL field. It's recommended to host your own Docker Registry on Cycle for extra security instead of using the public Docker Hub option.

Import Progress

Once you have filled in all the information, click Import. You will be taken to a page where you can watch the import progress. When it is finished, you can jump directly to the image's main page by clicking Go To Image.

The portal is a live interface, so feel free to navigate away from the import page. It will continue in the background, and you will be notified when it is complete.

Updating and Deleting Images

Everything related to updating/deleting images is on the "Settings" tab of the image

  1. Click Images in the nav menu on the left hand side.
  2. Select the image you want to modify from the list.
  3. Click the Settings tab underneath the image name at the top.

Updating an Image

You can only change the name of an image once it has been created. If you need to get the latest copy of an image, reimport it instead.

From the settings tab, locate the "General" form on the left hand side. Change the name to whatever you'd like, then click Update Image.

Deleting an Image

If you've decided you no longer need an image and wish to delete it, you will first need to delete the containers that are using it. To check if any containers are using the image, select the Dashboard tab underneath the image name at the top. On the right hand side is a panel detailing all containers currently using this image.

Deleting an image cannot be undone. The only option is to reimport the image.

Deleting an Image

Once the containers using the image have been removed, go back to the Settings tab of the image you wish to delete, and locate the form on the right-hand side. Enter the name of the image into the box, and click Delete Image.

Need Help?

If you've got questions about the platform or need some help getting started, our team is more than happy to assist. Whether you're new to containers or just new to Cycle, reach out to us via livechat by clicking the blue circle in the bottom right corner. Join our Slack channel, and get help from the dev team or other members of the community, and check out our Roadmap to see what's planned for the future!