Custom SUSE VM Images

SUSE provides SUSE Linux Enterprise (SLE) and openSUSE Leap virtual machine (VM) images suitable for use in Harvester. These images are built on the openSUSE Build Service (OBS) using the Kiwi image building tool, and can be used immediately after downloading.

For most cases, you can use the Minimal VM Cloud qcow2 images because these include the cloud-init tool necessary for automatic VM configuration. Other image variants require you to log onto the VM console and then perform initial configuration.

Custom SUSE VM Images - 图1info

The Minimal VM Cloud images were named Minimal VM OpenStack Cloud in releases earlier than SLES 15 SP5 and openSUSE 15.5.

Using the openSUSE Build Service (OBS)

You can create custom images based on what SUSE provides using OBS image templates, which are pre-configured Kiwi image configurations. For example, if you want use other packages with SLE 15 SP5, you can create an image using the SLE 15 SP5 Minimal template. OBS provides an interface for adding packages and automatically builds the image, which you can download and then upload to Harvester. For more information, see the OBS User Guide.

1. Create a custom image based on an existing template.

  1. Go to https://build.opensuse.org/image_templates. You must sign in to your openSUSE account to access the resources.

  2. Select the template that you want to use.

  3. Specify a name for the image, and then select Create appliance.

    Custom SUSE VM Images - 图2

    OBS automatically builds the image. By default, the interface shows the Overview tab, which contains information such as the number of included packages and the build status.

    Custom SUSE VM Images - 图3

2. Select image profiles and add packages.

  1. Go to the Software tab.

  2. Select the image profiles that you want OBS to build.

    Custom SUSE VM Images - 图4info

    For most cases, you can use the Minimal VM Cloud qcow2 images because these include the cloud-init tool necessary for automatic VM configuration. Other image variants require you to log onto the VM console and then perform initial configuration.

    Custom SUSE VM Images - 图5

  3. (Optional) Add and remove packages.

    Custom SUSE VM Images - 图6

    Custom SUSE VM Images - 图7

3. (Optional) Switch to View Package mode.

View Package mode provides more granular control over configuration. To switch, click the View Package icon in the navigation bar.

Custom SUSE VM Images - 图8

The Source Files section of the Overview tab shows all the files that comprise your Kiwi template. You can edit any of the files by selecting the corresponding file name.

Custom SUSE VM Images - 图9

4. (Optional) Edit the configuration file Minimal.kiwi.

Select the file name to open the text editor. The <packages type="image"> section lists the packages to be installed. You can specify additional packages for each image profile.

By default, the Cloud image profile (<package type="image" profiles="Cloud">) installs the kernel-default-base package. In the following example, that package is replaced with kernel-default, which includes modules necessary for iSCSI support.

Custom SUSE VM Images - 图10

5. Wait for OBS to finish building the image.

Once the process is completed, the Build Results section on the Overview tab shows the status succeeded.

Custom SUSE VM Images - 图11

The Build Results section also contains a download link for the new image.

Custom SUSE VM Images - 图12

Custom SUSE VM Images - 图13

6. Enable publishing to share the image.

To allow the public to download your custom image, go to the Repositories tab of your OBS project and enable the Publish flag.

Custom SUSE VM Images - 图14

Your image is published to https://download.opensuse.org/ (under repositories/home:/YOUR_USER_NAME:/branches:/SUSE:/Templates:/Images:/).

Custom SUSE VM Images - 图15

Using the Kiwi Command-line Tool

As an alternative to the openSUSE Build Service, you can create images locally using the Kiwi command-line tool. For more information about the tool, see Building Linux System Appliances with KIWI Next Generation (KIWI NG).

To create custom images, you must first download the file Minimal.kiwi, and the scripts config.sh and editbootinstall_rpi.sh from the corresponding project on OBS.

OSopenSUSE Build Service Project
SLE 15 SP5https://build.opensuse.org/package/show/SUSE:SLE-15-SP5:GA/kiwi-templates-Minimal
openSUSE Leap 15.5https://build.opensuse.org/package/show/openSUSE:Leap:15.5/kiwi-templates-Minimal
SLE 15 SP4https://build.opensuse.org/package/show/SUSE:SLE-15-SP4:GA/kiwi-templates-Minimal
openSUSE Leap 15.4https://build.opensuse.org/package/show/openSUSE:Leap:15.4/kiwi-templates-Minimal