Product Documentation

Manage image templates

Jan 11, 2018

When you create new layers and new versions to them, you can edit the layer selection in your image templates, and use the templates to publish new versions of your layered images. Once created, a layered image is no longer associated with the template used to create it. This means that you can change or delete a template without affecting any previously published layered images.

Update image templates with a new layer version

When you add a new version to an app layer or an OS layer, you can quickly identify the image templates that include the layer, and select which templates to update with the new version.

  1. In the App Layering Management Console, select Layers > App Layers or Layers > OS Layers.
  2. Select the Layer you updated, and click Update Assignments.
  3. In the wizard that opens, select the new version of the layer that you want to assign. The image template assignment tab lists the image templates that include the layer but are not yet assigned the new version.
  4. On the image template assignment tab, select the image templates to which you want to assign the layer or layer version.
    Notes:
    If the list is empty, click the check box called, Show Image Templates already at this version. A list of grayed out names may appear. These templates have already been assigned the Version.
    You can use the Search field to filter this list by Layer or Version. If you search on part of a Layer name or Version, any entry that contains the search string is displayed.
  5. Skip the Elastic Assignment tab
  6. On the Confirm and Complete tab, verify your choices and click Update Assignments.

Edit any image template setting

When you want to change the settings that you use to publish any of your layered images, you can edit the image template you originally used to publish the layered image(s) and publish a new version of the image(s).

  1. In the App Layering Management Console (UMC), select the Images module.
  2. Select the template you want to edit, and click Edit Template. This opens the Edit Template wizard.
  3. On the Name and Description tab, you can change the Name, Description, and Icon for the Image.
  4. On the OS Layer tab, you can select a different version of your chosen OS layer by expanding the layer and choosing a different one.
  5. On the App Assignment tab, you can add or remove app layers to include in the layered images that you publish using this template. If there is more than one version of a layer, you can choose a different version by expanding the layer and choosing a different one.
  6. On the Connector tab, you can change the location to which the Layered Image is published by selecting a different Connector Configuration.
  7. On the Platform Layer tab, you can change the selected Platform Layer, if for example, you are publishing to a different environment.
  8. On the Layered Image Disk tab, you can edit the Layered Image Disk details, for example, to enable Elastic Layering on the image.
  9. In the Confirm and Complete tab, enter any comments you would like for this layer, and click Edit Template.

Delete an image template

When you no longer need an Image Template, you can remove it from the Management Console.

  1. In the Management Console, select the Images module.
  2. Select the template you want to delete, and click Delete Template. This opens the Delete Template wizard.
  3. In the Confirm and Complete tab, enter any comments you would like, and click Delete Template.