Disk Templates

Page Description

The disk templates page of the Katapult console shows a table of all previously created disk templates to which you can then use to deploy as a new disk.

In This Guide

What is a disk template?

A disk template represents a deployable disk containing the contents of a given snapshot. A disk template can installed in the following ways:

Creating a disk template

Prerequisite:
To create a disk template you must first have created a snapshot of the disk in question.

  1. Click Compute -> Virtual Machines on the sidebar
  2. Select the virtual machine in question
  3. Select Disks -> System disks from the navbar
  4. Select the disk in question
  5. Click Snapshots above the right sidebar
  6. Select the snapshot you wish to use for this new disk template
  7. Click Create template from this snapshot from the actions sidebar
  8. Click the Create new template button
  9. Complete the Disk Template Details
  10. Adjust the Template specification if required (see [Template specifications] for guidance).
  11. Click the Save button.

Your template will then be created. You will be taken to the Compute -> Disk templates screen once complete.

Update an existing template

Katapult considers disk templates are versioned items and therefore, if you need to update a disk template you can do while retaining the old copy.

  1. Click Compute -> Virtual Machines on the sidebar
  2. Select the virtual machine in question
  3. Select Disks -> System disks from the navbar
  4. Select the disk in question
  5. Click Snapshots above the right sidebar
  6. Select the snapshot you wish to use for this new disk template
  7. Click Create template from this snapshot from the actions sidebar
  8. Click the Choose an existing template button
  9. Select Add version next to the template you wish to update
  10. Complete any required form fields
  11. Click the Save button.

Remove a disk template

Remove a specific version of a disk template

These steps will allow you to remove a specific version of a given disk template.

  1. Select Compute -> Disk templates from the sidebar
  2. Click the name of the disk template you wish to remove a version of
  3. Click the name of the version you wish to remove from the Versions table
  4. Click Delete version from the Actions sidebar
  5. Confirm the action

The given version of the template will be removed and can no longer be used when creating virtual machines, or installing operating systems onto system disks.

Remove all versions of the disk template

These steps will completely remove a disk template and all associated versions of it from the Katapult system, thus preventing any new machines from using it.

  1. Select Compute -> Disk templates from the sidebar
  2. Click the name of the disk template you wish to remove
  3. Click Purge template in the right sidebar
  4. Confirm the action

The template will be removed from your Katapult account.

Create a new virtual machine from a disk template

Once you have one or more disk templates within your Katapult account you can deploy machines using them. A disk template will appear within the operating systems list of the new virtual machine wizard. For more information on this process please refer to the Creating a new virtual machine how-to guide.

Install a disk template onto a new disk

If you wish to copy one of your disk templates onto a new disk within one of your virtual machines, then please refer to the install an OS how-to guide. You will see your disk template within the associated operating system list.

Install a disk template onto an existing disk

To install a disk template on an existing disk it is advised you format it first before then following the steps outlined in the install an OS how-to guide. You will see your disk template within the associated operating system list.