Backport 5.0: Fixed issues in Image Building chapter in the Administration Guide (#4173) (#4218) (#4269)

https://bugzilla.suse.com/show_bug.cgi?id=1245987
https://github.com/SUSE/spacewalk/issues/27790

Co-authored-by: Ondřej Holeček <[email protected]>

Author: keichwa

CHANGELOG.md

@@ -1,3 +1,5 @@
+- Fixed issues in Image Building chapter in the Administration Guide
+  (bsc#1245987)
 - Added proxy package installation command in Installation and
   Upgrade Guide (bsc#1248292)
 - Fixed invocation of spacewalk-repo-sync command in Client

modules/administration/pages/image-management.adoc

@@ -18,17 +18,20 @@
 {productname} supports these two build types: Dockerfile and the Kiwi build type.
 The Kiwi build type is used to build system, virtual, and other images.
 
-The image store for the Kiwi build type is pre-defined as a file system directory at [path]``/srv/www/os-images`` on the server.
+// Needs checking
+// at later places to be fix accordingly
+The image store for the Kiwi build type is pre-defined as a file system directory in the [path]``srv-www`` volume.
 {productname} serves the image store over HTTPS from [literal]``https://<SERVER-FQDN>/os-images/``.
 The image store location is unique and is not customizable.
 
-Images are stored in [path]``/srv/www/os-image/ORGANIZATION-ID``.
+Images are stored in an [path]``ORGANIZATION-ID`` directory there.
 
 
 [[at.images.docker]]
 == Container Images
 
-image::image-building.png[scaledwidth=80%]
+// FIXME, bsc#1245987: replace caas pattform with container host?
+// image::image-building.png[scaledwidth=80%]
 
 
 [[at.images.docker.requirements]]
@@ -113,6 +116,8 @@ For more information, see xref:client-configuration:activation-keys.adoc[].
 
 All built images are pushed to an image store.
 This section contains information about creating an image store.
+Image store is generally referenced as a registry.
+
 
 image::images_image_stores.png[scaledwidth=80%]
 
@@ -308,8 +313,9 @@ When you have selected a build profile, detailed information about the selected
 [[at.images.docker.importing]]
 === Import an Image
 
-You can import and inspect arbitrary images.
-Select menu:Images[Image List] from the left navigation bar.
+The second way to get an image is to import and inspect arbitrary images.
+To do that, select menu:Images[Image List] from the left navigation bar.
+
 Complete the text boxes of the [guimenu]``Import`` dialog.
 When it has processed, the imported image is listed on the [guimenu]``Image List`` page.
 
@@ -397,6 +403,10 @@ For more information, see the documentation of the underlying system.
 [[at.images.kiwi.buildhost]]
 === Create a Build Host
 
+// FIXME, bsc#1245987:
+// Discussing Container-Based KIWI Image Build Support here?
+// Perhaps 2.'docker' might be 2, but the container variant might be different?
+
 To build all kinds of images with {productname}, create and configure a build host.
 OS Image build hosts are {salt} clients running on {sles}{nbsp}15 (SP2 or later) or {sles}{nbsp}12 (SP4 or later).
 
@@ -490,7 +500,7 @@ Activation keys are mandatory for OS Image building.
 
 [NOTE]
 ====
-To build OS Images, you need an activation key that is associated with a channel other than `SUSE Manager Default`.
+To build OS Images, you need an activation key that is associated with a channel other than `Default` activation key.
 ====
 
 .Procedure: Creating an Activation Key
@@ -506,20 +516,22 @@ For more information, see xref:client-configuration:activation-keys.adoc[].
 [[at.images.kiwi.imagestore]]
 === Create an Image Store
 
+// For background info about Image Store, see the overview at the beginning of this chapter.
+
 OS Images can require a significant amount of storage space.
-Therefore, we recommended that the OS Image store is located on a partition of its own or on a Btrfs subvolume, separate from the root partition.
-By default, the image store is located at [path]``/srv/www/os-images``.
+By default, the image store is using the [path]``srv-www`` volume.
+
 
 [NOTE]
 ====
 Image stores for Kiwi build type, used to build system, virtual, and other images, are not supported yet.
 
 ifeval::[{suma-content} == true]
-Images are always stored in [path]``/srv/www/os-images/ORGANIZATION-ID`` and are accessible via HTTP/HTTPS [url]``https://<susemanager_host>/os-images/ORGANIZATION-ID``.
+Images are always stored in [path]``.../os-images/ORGANIZATION-ID`` and are accessible via HTTP/HTTPS [url]``https://<susemanager_host>/os-images/ORGANIZATION-ID``.
 endif::[]
 
 ifeval::[{uyuni-content} == true]
-Images are always stored in [path]``/srv/www/os-images/ORGANIZATION-ID`` and are accessible via HTTP/HTTPS [url]``https://<uyuni_host>/os-images/ORGANIZATION-ID``.
+Images are always stored in [path]``.../os-images/ORGANIZATION-ID`` and are accessible via HTTP/HTTPS [url]``https://<uyuni_host>/os-images/ORGANIZATION-ID``.
 endif::[]
 
 ====
@@ -683,7 +695,7 @@ For information about the Kiwi build system, see the https://osinside.github.io/
 [[at.images.kiwi.building]]
 === Build an Image
 
-There are two ways to build an image using the {webui}.
+There are two ways to build or get an image using the {webui}.
 Either select menu:Images[Build], or click the build icon in the menu:Images[Profiles] list.
 
 image::images_image_build.png[scaledwidth=80%]