Skip to content

Create SLE Minimal VM article #771

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
eromanova97 wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Create SLE Minimal VM article #771

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3547bb6
Create SLE Minimal VM article
eromanova97 Aug 19, 2026
f41a34d
Apply review comments
eromanova97 Aug 21, 2026
72f473f
More review feedback
eromanova97 Aug 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions DC-SAP-Minimal-VM
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# This file originates from the project https://github.com/openSUSE/doc-kit
# This file can be edited downstream.

MAIN="sle-minimal-vm.asm.xml"
SRC_DIR="articles"
IMG_SRC_DIR="images"

## Profiling
PROFOS="sles4sap"
#PROFCONDITION="16.0"
#PROFARCH="x86_64;power"

DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"

STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse-ns"
16 changes: 16 additions & 0 deletions DC-SLES-Minimal-VM
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# This file originates from the project https://github.com/openSUSE/doc-kit
# This file can be edited downstream.

MAIN="sle-minimal-vm.asm.xml"
SRC_DIR="articles"
IMG_SRC_DIR="images"

## Profiling
PROFOS="sles"
#PROFCONDITION="16.0"
#PROFARCH="x86_64;zseries;power;aarch64"

DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"

STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse-ns"
204 changes: 107 additions & 97 deletions articles/sle-minimal-vm.asm.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- file: templates/articles/assembly.xml -->
<?xml-model href="https://cdn.docbook.org/schema/5.2/rng/assemblyxi.rnc"
type="application/relax-ng-compact-syntax"?>
<!-- This file originates from the project https://github.com/openSUSE/doc-kit -->
<!-- This file can be edited downstream. -->
<!DOCTYPE assembly
[
<!ENTITY % entities SYSTEM "../common/generic-entities.ent">
Expand All @@ -14,17 +13,37 @@
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:trans="http://docbook.org/ns/transclusion"
xmlns:its="http://www.w3.org/2005/11/its"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns="http://docbook.org/ns/docbook">
<!-- resources section references all topic chunks used in the final article
-->
<!-- R E S O U R C E S -->
<!-- Concept files -->
<resources>
<resource xml:id="_minimal-vm-intro" href="../concepts/minimal-vm-intro.xml"/>
<resource xml:id="_minimal-vm-highlights" href="../concepts/minimal-vm-highlights.xml"/>
<resource xml:id="_minimal-vm-vs-sles" href="../concepts/minimal-vm-vs-sles.xml"/>
<resource xml:id="_minimal-vm-get" href="../concepts/minimal-vm-get.xml"/>
<resource xml:id="_minimal-vm-on-kvm" href="../concepts/minimal-vm-on-kvm.xml"/>
<resource xml:id="_bci-gfdl" href="../common/license_gfdl1.2.xml"/>
<resource xml:id="_minimal-vm-intro" href="../concepts/minimal-vm-intro.xml">
<description>What is &sleminvm;?</description>
</resource>
<resource xml:id="_minimal-vm-image" href="../concepts/minimal-vm-image.xml">
<description>Choosing the right deployment image</description>
</resource>
<resource xml:id="_minimal-vm-vs-sles" href="../concepts/minimal-vm-vs-sles.xml">
<description>Differences between &sleminvm; and &productname;</description>
</resource>
<resource xml:id="_minimal-vm-get" href="../concepts/minimal-vm-get.xml">
<description>Obtaining &minvm; images</description>
</resource>
</resources>
<!-- Tasks -->
<resources>
<resource xml:id="_minimal-vm-cloud-init" href="../tasks/minimal-vm-cloud-init.xml">
<description>Deploying an image with cloud-init</description>
</resource>
<resource xml:id="_minimal-vm-without-cloud-init" href="../tasks/minimal-vm-without-cloud-init.xml">
<description>Deploying an image without cloud-init</description>
</resource>
<resource xml:id="_minimal-vm-post-deployment" href="../tasks/minimal-vm-post-deployment.xml">
<description>Deploying an image without cloud-init</description>
</resource>
</resources>
<!-- Legal -->
<resources>
Expand All @@ -36,124 +55,115 @@
</resource>
</resources>
<!-- S T R U C T U R E -->
<structure renderas="article" xml:id="minimal-vm-general-info" xml:lang="en">
<structure renderas="article" xml:id="sle-minimal-vm" xml:lang="en">
<merge>
<title>Introduction to &minvm;</title>
<!-- History -->
<revhistory xml:id="rh-minimal-vm">
<revision><date>2024-02-09</date>
<revdescription>
<para>
Revised and restructured the content
</para>
</revdescription>
</revision>
<revision><date>2023-10-10</date>
<revdescription>
<para>
Revised the content
</para>
</revdescription>
</revision>
<revision><date>2023-05-02</date>
<title>Introduction to &sleminvm;</title>
<revhistory xml:id="rh-sle-minimal-vm">
<revision><date>2026-08-20</date>
<revdescription>
<para>
Initial version
</para>
</revdescription>
</revision>
</revhistory>
<!-- Maintainer -->
<meta name="maintainer" content="Dmitri Popov" its:translate="no"/>
<!-- Architecture -->
<meta name="architecture" its:translate="no">
<phrase>&x86-64;</phrase>
<phrase>&zseries;</phrase>
<phrase>&power;</phrase>
<phrase>&aarch64;</phrase>
<meta name="maintainer" content="eliska.romanova@suse.com" its:translate="no"/>
<meta name="architecture"><phrase>&x86-64;</phrase><phrase>&power;</phrase><phrase>&zseries;</phrase><phrase>&aarch64;</phrase>
</meta>
<!-- Productname & Version -->
<meta name="productname" its:translate="no">
<productname version="&productnumber;" os="sles">&productname;</productname>
<meta name="productname" its:translate="no"><productname version="&productnumber;" os="sles;sles4sap">&productname;</productname>
</meta>
<!-- Search -->
<meta name="title" its:translate="yes">Introduction to &minvm;</meta>
<meta name="description" its:translate="yes">How to set up and use &minvm;.</meta>
<!-- Social Media -->
<meta name="social-descr" its:translate="yes">Set up &minvm;</meta>
<!-- Tasks -->
<meta name="task" its:translate="no">
<phrase>Virtualization</phrase>
<meta name="title" its:translate="yes">Introduction to &sleminvm;</meta>
<meta name="description" its:translate="yes">Learn what &sleminvm; images are, which ones are available, and how to deploy them with or without cloud-init</meta>
<meta name="social-descr" its:translate="yes">How to set up and use &sleminvm;</meta>
<!-- suitable categories has to be identical with the category selected in the docserv config -->
<meta name="category" its:translate="no"><phrase>Containers and virtualization</phrase>
</meta>
<meta name="task" its:translate="no"><phrase>Virtualization</phrase><phrase>Deployment</phrase>
</meta>
<!-- Series -->
<meta name="series" its:translate="no">Products &amp; Solutions</meta>

<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
<dm:bugtracker>
<dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url>
<dm:component>Documentation</dm:component>
<dm:product>SUSE Linux Enterprise Server &productnumber;</dm:product>
<dm:product os="sles">SUSE Linux Enterprise Server &productnumber;</dm:product>
<dm:product os="sles4sap">SUSE Linux Enterprise Server for SAP applications &productnumber;</dm:product>
<dm:assignee>eliska.romanova@suse.com</dm:assignee>
</dm:bugtracker>
<dm:translation>yes</dm:translation>
</dm:docmanager>
<abstract>
<variablelist>
<varlistentry>
<term>WHAT?</term>
<listitem>
<para>
A high-level overview of &minvm;.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WHY?</term>
<para>
&sleminvm; images allow you to run &productname; in a virtual or cloud environment
without having to perform a full installation. Learn which &minvm; image to choose, the
ways to deploy them and how to configure them on first boot.
</para>

<para>
<emphasis>Prerequisites:</emphasis>
</para>
<itemizedlist>
<listitem>
<para>
You want to know what &minvm; can do for you.
General familiarity with &productname;
Comment thread
eromanova97 marked this conversation as resolved.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>EFFORT</term>
<listitem>
<para>
10 minutes of reading time.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>GOAL</term>
<listitem>
<para>
Get an understanding of what &minvm; is and what it can be used for.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>REQUIREMENTS</term>
<listitem>
<itemizedlist>
<listitem>
<para>
General familiarity with &sles;
</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</itemizedlist>
</abstract>
</merge>
<module resourceref="_minimal-vm-intro" renderas="section"/>
<module resourceref="_minimal-vm-highlights" renderas="section"/>
<module resourceref="_minimal-vm-vs-sles" renderas="section"/>
<module resourceref="_minimal-vm-get" renderas="section"/>
<module resourceref="_minimal-vm-on-kvm" renderas="section"/>
<module resourceref="_minimal-vm-intro" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_minimal-vm-vs-sles" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_minimal-vm-image" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_minimal-vm-get" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_minimal-vm-cloud-init" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_minimal-vm-without-cloud-init" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_minimal-vm-post-deployment" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_legal"/>
<module resourceref="_gfdl">
<output renderas="appendix"/>
</module>
</structure>
</assembly>
<!--
<module resourceref="_minimal-vm-on-kvm" renderas="section"/> -->
3 changes: 2 additions & 1 deletion common/generic-entities.ent
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,8 @@
<!-- SLE -->
<!ENTITY jeos "JeOS"><!-- Just enough OS -->
<!ENTITY jeosfirstboot "&jeos; Firstboot">
<!ENTITY minvm "&slsa; Minimal VM">
<!ENTITY minvm "Minimal VM">
<!ENTITY sleminvm "&productnameshort; &minvm;">
<!ENTITY minimg "Minimal Image">
<!ENTITY leanos "Unified Installer">
<!ENTITY sle "&suse; Linux Enterprise">
Expand Down
70 changes: 35 additions & 35 deletions concepts/minimal-vm-get.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file originates from the project https://github.com/openSUSE/doc-kit -->
<!-- This file can be edited downstream. -->
<!DOCTYPE topic
[
<!ENTITY % entities SYSTEM "../common/generic-entities.ent">
Expand All @@ -12,49 +14,47 @@
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:trans="http://docbook.org/ns/transclusion">
<info>
<title>Obtaining &minvm;</title>
<meta name="maintainer" content="dpopov@suse.com" its:translate="yes"/>
<title>Obtaining &minvm; images</title>
<meta name="maintainer" content="eliska.romanova@suse.com" its:translate="no"/>
<abstract>
<para>
Learn how to download and identify the correct &minvm; images for your target platform
</para>
</abstract>
</info>
<para>
You can download the desired variant of &minvm; from the official <link xlink:href= "https://www.suse.com/download/sles/">Download</link> page. The page offers the following &minvm; versions:
</para>
<itemizedlist>
<listitem>
<para>
Fully virtual &minvm; for &kvm; and &xen;
</para>
</listitem>
<listitem>
<para>
&minvm; for &vmware;
</para>
</listitem>
Download the images from the official
<link os="sles" xlink:href= "https://www.suse.com/download/sles/">Download</link><link os="sles4sap" xlink:href= "https://www.suse.com/download/sle-sap/">Download</link>
page. Images have the platform in the name, based on their purpose:
</para>
<itemizedlist>
<listitem>
<para>
&minvm; for &hyperv;
</para>
<para>
<literal>Cloud</literal> for cloud platforms
</para>
</listitem>
<listitem>
<para>
&minvm; for &ostack;
</para>
<para>
<literal>kvm-and-xen</literal> for &kvm; and &xen; hypervisors
<!-- Xen needs confirmation for x86_64 in SLE 16 -->

@Vogtinator Vogtinator Aug 20, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I'm also not sure about official support. From a technical PoV it should work at least.

</para>
</listitem>
<listitem>
<para>
Paravirtual &minvm; for &xen;
</para>
<para>
<literal>MS-HyperV</literal> for &hyperv; hypervisors
</para>
</listitem>
<listitem>
<para>
Fully virtual &minvm; for &kvm; for &aarch64;
</para>
<para>
<literal>VMware</literal> for &vmware; hypervisors
</para>
</listitem>
</itemizedlist>
<note>
<title>SUSE subscription required</title>
<para>
By default, &minvm; does not have any repositories. You must register
your system to access online repositories. Registration requires a paid subscription.
</para>
</note>
</itemizedlist>
<note os="sles4sap">
<title>&sleminvm; architecture availability</title>
<para>
Ready-to-use &sleminvm; images are currently available for the x86_64 architecture only. The
images for &power; are planned to be available in a future release.
</para>
</note>
</topic>
Loading