Use image tags and digests

This topic describes using image tags and digests with your application images. It includes information about when image tags and digests are supported, and how to enable support for image digests in air gap bundles.

Support for image tags and digests

The following table describes the use cases in which image tags and digests are supported:

Installation	Support for Image Tags	Support for Image Digests
Online	Supported by default	Supported by default
Air Gap	Supported by default for Replicated KOTS installations	Supported when the Enable new air gap bundle format toggle is enabled on the channel. For more information, see Using Image Digests in Air Gap Installations below.

note

You can use image tags and image digests together in any case where both are supported.

Using image digests in air gap installations

You can enable a format for air gap bundles that supports the use of image digests. This air gap bundle format also ensures that identical image layers are not duplicated, resulting in a smaller air gap bundle size.

note

This air gap bundle format is required for air gap installations with Replicated Embedded Cluster. Air gap builds fail for releases that include an Embedded Cluster Config when the channel does not use this format.

You can enable or disable this air gap bundle format using the Enable new air gap bundle format toggle in the settings for any channel in the Vendor Portal. New channels have this toggle enabled by default in most accounts. Existing channels keep the setting that they were created with, so verify that the toggle is enabled before you build an air gap bundle.

When you enable Enable new air gap bundle format on a channel, all air gap bundles that you build or rebuild on that channel use the updated air gap bundle format.

To enable the new air gap bundle format on a channel:

1. In the Replicated Vendor Portal, go to the Channels page and click the edit icon in the top right of the channel where you want to use the new air gap bundle format.
2. Enable the Enable new air gap bundle format toggle.
3. Test your changes:

   1. Save and promote the release to a development environment.

   2. On the channel where you enabled Enable new air gap bundle format, click Release history. On the Release History page, click Build next to the latest release to create an air gap bundle with the new format.

      

   3. Click Download Airgap Bundle.

   4. Install or upgrade the application. Upload the new air gap bundle to confirm that the installation or upgrade completes successfully.