29 Image Templates #
Image templates are pre-configured image configurations. The image templates page provides a list of these templates. Users can clone these templates and further configure them as they like.
29.1 Structure of Image Templates #
As mentioned image templates are essentially pre-configured KIWI image configurations. As any KIWI configuration they usually contain a tarball containing image sources, a config.sh file and the KIWI configuration XML file.
In addition, you can define an
icon for your image templates by adding graphical image (for example, PNG,
JPG) to your template sources and name it _icon. If that
file exists, it will be used as icon for your image on the image templates
page.
29.2 Adding Image Templates to/Removing Image Templates from the Official Image Template Page #
The image templates page lists templates per project. New templates
get added by setting the OBS:ImageTemplates attribute to
a project. Any package container belonging to a project with that attribute
will be shown on the template page.
Only admins can add / remove the OBS:ImageTemplates attribute from a project.
29.3 Receiving Image Templates via Interconnect #
If your OBS instance is connected to a remote instance via interconnect, OBS will fetch image templates from the remote instance and present it on the image templates page. They appear below the local templates.
For more information about interconnects, see Book “Administrator Guide”, Chapter 5 “Administration”, Section 5.2 “Managing Build Targets”.