26.21. image-deploy

The following documentation is for image-deploy content package at version v0.0.0.

26.21.1. params

The content package provides the following params.

26.21.1.1. image-deploy/windows-license-key

The license key for the windows operating system as a string.

26.21.1.2. image-deploy/image-os

The file image contains the install contents for an operating system. This variable defines the image OS at a high level.

Valid values are:
  • linux
  • windows

26.21.1.3. image-deploy/image-os-subtype

While image-deploy/image-os defines the overall OS type. This variable can be used to define the sub-type. e.g. ubuntu, debian, centos, rhel, redhat …

26.21.1.4. image-deploy/image-url

The url for the image for image-deploy to install.

26.21.1.5. image-deploy/windows-unattend-path

The path to the unattend.xml file.

26.21.1.6. cloud-init/user-data

This is the data to return to the node on cloud init calls.

26.21.1.7. curtin/partitions

The curtin partition as an object. It would look like this:

storage:

version: 1 config:

  • id: disk0 type: disk ptable: msdos path: /dev/sda name: main_disk wipe: superblock
  • id: disk0-part1 type: partition number: 1 device: disk0 size: 139G flag: boot
  • id: disk0-part1-format-root type: format fstype: ntfs quiet: True volume: disk0-part1
  • id: disk0-part1-mount-root type: mount path: / device: disk0-part1-format-root

This example is for a wim-like root fs for windows, but other custom partitions could be used.

If unspecified, the default action to setup a simple partition table suitable for linux rootfs installs.

26.21.1.8. image-deploy/additional-tarballs

A list of additional tarballs to install into the image.

26.21.1.9. image-deploy/image-file

The file image for image-deploy to install. This will have the Provisioner’s URL prepended to the filename.

You may use the drpcli isos upload command to place an image into the system. If this method is used, please prepend ‘isos/’ to your filename. You should not have any other directories in the filename.

You may use the drpcli files upload command to place an image into the system. If this method is used, prepend ‘files/’ to your filename. You may use additional directories in the filename.

You may also just place the image file under the DRP tftpboot directory. If this method is used, use the path relative to the tftpboot directory.

26.21.1.10. image-deploy/image-type

The file image may be in many formats. This tells image-deploy what method to use to install.

Validated methods are:
  • tgz = root file system in compressed tar file.
  • dd-tgz = Compressed tar file with a single raw disk image.

26.21.1.11. image-deploy/windows-unattend-template

The template to use for unattend.xml file.

26.21.1.12. cloud-init/x509-certs

This contains all the x509 certs for the system as a single string

26.21.1.13. image-deploy/install-disk

The disk curtin should install upon