Container Image Inspection bsc#1236323 (#3729) (#3736)

* bsc#1236323 * update cfg files * add background info * Update modules/administration/pages/troubleshooting/tshoot-container-inspection.adoc Co-authored-by: Ornela Marić <[email protected]>
uyuni-project · Feb 26, 2025 · 061134f · 061134f
1 parent 79bd339
commit 061134f
Show file tree

Hide file tree

Showing 4 changed files with 28 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,5 @@
+- Add section about container image inspection to Image
+  Management chapter in Administration Guide (bsc#1236323)
 - Fixed typo in Installation and Upgrade Guide (bsc#1237403)
 - Updated host renaming in Troubleshooting section of the
   Administration Guide

diff --git a/l10n-weblate/administration.cfg b/l10n-weblate/administration.cfg
@@ -26,6 +26,7 @@
 [type: asciidoc] modules/administration/pages/custom-channels.adoc $lang:translations/$lang/modules/administration/pages/custom-channels.adoc
 [type: asciidoc] modules/administration/pages/disconnected-setup.adoc $lang:translations/$lang/modules/administration/pages/disconnected-setup.adoc
 [type: asciidoc] modules/administration/pages/image-management.adoc $lang:translations/$lang/modules/administration/pages/image-management.adoc
+[type: asciidoc] modules/administration/pages/image-mgmt-container-inspection.adoc $lang:translations/$lang/modules/administration/pages/image-mgmt-container-inspection.adoc
 [type: asciidoc] modules/administration/pages/infra-maintenance.adoc $lang:translations/$lang/modules/administration/pages/infra-maintenance.adoc
 [type: asciidoc] modules/administration/pages/iss.adoc $lang:translations/$lang/modules/administration/pages/iss.adoc
 [type: asciidoc] modules/administration/pages/iss_intro.adoc $lang:translations/$lang/modules/administration/pages/iss_intro.adoc

diff --git a/modules/administration/pages/image-management.adoc b/modules/administration/pages/image-management.adoc
@@ -76,7 +76,10 @@ From the {productname} {webui}, perform these steps to configure a build host:
 . Install all required packages by applying [systemitem]``Highstate``.
   From the system details tab select menu:States[Highstate], and click btn:[Apply Highstate].
   Alternatively, apply [systemitem]``Highstate`` from the {productname} Server command line:
+
 +
+
+[source,shell]
 ----
 salt '$your_client' state.highstate
 ----
@@ -342,6 +345,12 @@ The status icon for the imported image can also be seen on the ``Overview`` tab
 === Troubleshooting
 
 
+
+include::image-mgmt-container-inspection.adoc[]
+
+
+==== General Issues
+
 These are some known problems when working with images:
 
 * HTTPS certificates to access the registry or the git repositories should be deployed to the client by a custom state file.

diff --git a/modules/administration/pages/image-mgmt-container-inspection.adoc b/modules/administration/pages/image-mgmt-container-inspection.adoc
@@ -0,0 +1,16 @@
+==== Image Inspection
+
+A base container image (BCI) comes with all the software to run it, but because BCIs are lightweight they may not come with all tools and libraries you may need for inspection.
+
+When inspecting a container image you can see an error message such as:
+
+----
+libssl.so.1.1: cannot open shared object file: No such file or directory
+----
+
+A BCI can be used in the other scenarios than with the container build host and using the {salt} bundle for the inspection, but if you need inspection to work you must add all needed software in advance.
+
+To avoid such issues you must add [systemitem]``libopenssl`` to the image with [systemitem]``Dockerfile`` and rebuild the image.
+
+The same can happen with [systemitem]``libexpat``.
+