Managing images in Sherpa

Creating images

Images are useful for creating identical machines in a Sherpa project. This is ideal for spinning up many render nodes that are all the same. Additionally you may have standard build for workstations that you want to replicate.

If a machine is off you can select Request image creation. request-image-creation

A new window will appear. request-image-creation-details

An estimate of the weekly cost associated with the image will be displayed. Give the image a suitable name. Fill in a description if required. Then press Create.

The request will go into a Saved state. Some parts of the image creation process are automatic and some are complex and require human intervention. You can list all your images and their status as described in the following section.

Listing images

From the left-hand menu select Images. images-menu

You will be presented with a list of images. image-list

In the above example we can see that our recent request is in a saved state as indicated by the blue tick and as yet is not being actioned. If the image is being worked on it will be shown as being in a building state as indicated by a yellow tick. Once the image is ready to be used it will move to a built state as indicated by a green tick. Golden images are distinguished from normal build profiles by the inclusion of a golden-yellow badge.

Using an image

Once an image has been created it will appear in the dropdown list in the build profiles. An image will only appear in the dropdown if it is of the correct type and exists in the same region as the current project.

images-as-build-profiles

Checking the ongoing cost of an image

The current/ongoing costs for an image can be shown for the current week.

image-ongoing-costs

Checking the historic weekly cost of an image

You can change the date range to show historic costs for an image.

image-historic-costs

Checking the overall cost of images in the cost reports

The costs associated with images is displayed in the weekly cost reports.

images-in-cost-reports

Copying an image to another region

If you want to use an image in a different region, you will have to request for it to be copied to the new region. From the menu for the image select Request copy to location.

request-image-copy

A new window will appear where you can specify a new name for the copy and the location for the image copy.

Using an image in another project or region

The images do have information in them that is specific to the project in which they were created. If you want to use an image in another project you will have to,

  1. Create a machine from the original image
  2. Adjust the configuration of the machine to match the current project. This will cover things like, the IP address of the shared storage, the IP address of the render manager etc.
  3. Create a new image from this machine which can now be used for this specific project.

This can be quite complex so you may wish to reach out to us for help. You can do so at support@escape-technology.com.

Deleting an image

To delete an image, select Request deletion from the dropdown menu. request-image-deletion