Assign an App Layer to Image Templates

In this article:

An Image Template is a stored selection of Layers and settings that you use to publish Layered Images. At minimum, an Image Template contains an OS Layer, Platform Layer, and settings. Ideally, each template also contains your choice of App Layers for a particular image, for example, an image suited for the users served by a particular silo. Once you publish a Layered Image, you can provision systems using the image.

When you create a new App Layer, you can assign the App Layer to one or more Unidesk Image Templates, and then use the templates to publish Layered Images that include the layer. This article explains how to assign an App Layer to one or more Image Templates, and update the assignments when you update the Layer.

When you first update an App Layer, the new Layer Version is not assigned to any Image Templates, so you'll need to update the Layer Assignments. Updating the assignments allows you to assign different Versions of the Layer to different Image Templates. You cannot assign an App Layer to

Important: When assigning App Layers, be sure to avoid assigning the app elastically to a user, if the app is already in the Layered Image that the user gets.

Prerequisites

• One or more App Layers.
• One or more Image Templates.

Add an App Layer Assignment to one or more Image Templates

1. Log into the Unidesk Management Console (UMC) as an Admin user, and select Layers > App Layers.
2. Select an App Layer to include in one or more of your Image Templates, and click Add Assignments.
3. In the wizard that opens, select the App Layer that you want to assign to templates.
4. On the Image Template Assignment tab, select the templates in which you want to include this App Layer Version.
5. Skip the Elastic Assignment tab.
6. In the Confirm and Complete tab, review your selections, and click Assign Apps.

When you open each of the Image Templates you will see the App Layer Version you just assigned to the template.

Update App Layers and Image Template Assignments

When you update an application by adding a new Version to the App Layer, the new Layer Version will not inherit the original Layer Assignments. You need to assign the new App Layer Version.

1. Log into the UMC and select Layers > App Layers.

2. Select the App Layer that has been updated.

3. Right-click the Layer icon and select Update Assignments.

4. In the wizard that opens, select the new App Layer Version.

5. Click the Image Template Assignment tab, and select the Image Templates to which you want to assign the new Layer Version .

   Notes:

   • If the list is long, use the Search field to filter the results.
   • 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 Image Templates have already been assigned the Version.
6. Skip the Elastic Assignment tab.
7. On the Confirm and Complete tab, verify the Image Templates selected to receive the new Version, and click Update Assignments.

Remove Template Assignments

When you remove an App Layer's Template Assignments, the assignments for all versions of the Layer are removed. If you want to remove the assignments for a specific Version of the Layer, select Update Assignments instead.

1. Log into the UMC and select Layers > App Layers.

2. Select the App Layer for which you want to remove assignments, and select Remove Assignments..

3. In the wizard that opens, select the assigned templates from which you want to remove the Layer. All of the assignments for that layer are listed.

   If the list is long, use the Search field to filter the results.

4. On the Confirm and Complete tab, verify the Image Templates selected to receive the new Version, and click Update Assignments.