Links

Manage Container Images

Learn how to change the image on a container and manage image versions.

Change the Image on a Container

It is possible to replace the image of an already existing container.
UI
CLI
API
  1. 1.
    Enter the Workload Details screen for the Workload you want to work on.
  2. 2.
    Ensure you are in Draft mode. If you are not, you can select it from the Deployment drop-down.
  3. 3.
    Choose the container in the workload you want to update.
  4. 4.
    Click on Change image.
  5. 5.
    On the overlay, select the Container image you want to use in the Workload. You have the option to:
    • Select an image registered with Humanitec.
    • Add an image by image name. To do so enter the full image name. A valid name is made up of slash-separated name components and can optionally be prefixed by a registry hostname or followed by a port e.g. myregistry:5000/postgres/httpd:1.0.
Steps to update the image on a container steps 1-4
Steps to update the image on a container step 5
Our CLI is currently in closed beta. Please contact us if you want to learn more.
Changing the image on a container is the equivalent to changing the image property in a Deployment Set in the API. This can be done via a Deployment Delta.

Change the Version of a Container Image

The version of a container image that will be used on deployment can be updated within the Workload.
UI
CLI
API
  1. 1.
    Enter the Workload Details screen for the Workload you want to work on.
  2. 2.
    Ensure you are in Draft mode. If you are not, you can select it from the Deployment drop-down.
  3. 3.
    Choose the container in the workload you want to update.
  4. 4.
    Click on Change version.
  5. 5.
    On the overlay, select the desired version from the list that appears. To select an archived version, it has to be unarchived first.
Steps to update the version of an Image in a Workload steps 1-4
Steps to update the version of an Image in a Workload step 5
Our CLI is currently in closed beta. Please contact us if you want to learn more.
Changing the container image version is the equivalent to changing the image property in a Deployment Set in the API. This can be done via a Deployment Delta.
You can use Automation Rules to automatically deploy new images when they are pushed to Humanitec.

Archive an Image Version

As images get added to Humanitec, the list of possible image versions gets longer. In most cases, older image versions are no longer needed. Archiving an image version means that it will no longer appear by default and can be restored any time.
This has the same effect as archiving an image via the Organization Settings page. Images can be archived by Organization Administators and Managers via the Organization Settings Screen as well as by App Owners and Developers on the Workload Details Screen as illustrated in the manage container images guide.
UI
CLI
API
  1. 1.
    Enter the Workload Details screen for the Workload you want to work on.
  2. 2.
    Ensure you are in Draft mode. If you are not, you can select it from the Deployment drop-down.
  3. 3.
    Choose the container in the workload you want to update.
  4. 4.
    Click on Change version.
  5. 5.
    On the overlay, select the desired version you wish to archive by clicking on it.
  6. 6.
    Select Archive. The image is now archived and can be Unarchived any time by following the steps described in this guide.
Steps to archive the version of an Image in a Workload steps 1-4
Steps to archive the version of an Image in a Workload steps 5-6
Our CLI is currently in closed beta. Please contact us if you want to learn more.
You can archive an image version via the Update Version of an Artefact endpoint.