[CIAM-711] Update RH-SSO server overlay Zip artifact to

'RH-SSO 7.5.0.CR4' build

Also add a note to 'modules.eap' module, about the logic, which is
used for the inclusion of necessary EAP modules into the RH-SSO modules
(since the approach changed due to OSBS container build system
limitations)

Drop vim-minimal RPM package

Signed-off-by: Jan Lieskovsky <[email protected]>

Author: Jan Lieskovsky

modules/eap/module.yaml

@@ -1,6 +1,41 @@
 schema_version: 1
 name: eap
-description: "Installs base EAP to the image"
+description: "Installs base EAP to the image."
+
+# NOTE:
+#   The former listing of all specific EAP modules to be included into the RH-SSO
+#   images was replaced with a single 'setup.eap.modules' CEKit module (therefore
+#   one new layer in the resulting built container image).
+#
+#   This single module combines / concatenates the functionality of all necessary
+#   EAP modules, listed in the 'used-eap-modules-list.txt' in this directory, and
+#   respects the internal dependencies between those modules. IOW the prerequisite
+#   EAP modules are listed before the modules, which depend on them.
+#
+#   This approach was chosen to avoid / overcome the 'max depth exceeded' OSBS
+#   container build system error message, which got triggered previously by
+#   performing an OSBS build, listing the necessary specific EAP modules
+#   one-by-one. Due to the high number of EAP modules, needed to be included,
+#   there were too many layers in the intermediary image, and the OSBS build
+#   failed as a whole.
+#
+# IMPORTANT:
+#   Do not change this approach!
+#
+#   If you need to add / list additional EAP module, not present yet, append the
+#   list of artifacts, environment variables, labels (basically all the
+#   information listed in 'module.yaml' file of the new module, you want to add)
+#   at the appropriate section of 'module.yaml' file of the existing
+#   'setup.eap.modules' module (for example append the labels from the new module
+#   at the end of 'labels' section of 'setup.eap.modules' module, so the labels
+#   from the new module are known to 'setup.eap.modules' module too.
+#
+#   Moreover, copy the body of the configure script of that new module at the
+#   appropriate place of the existing 'configure.sh' script. For each of the
+#   already included configuration scripts, the 'configure.sh' script contains
+#   the starting and ending comments, so the order in which the modules need
+#   to be included, is preserved and respected.
+
 version: '1.0'
 
 modules:

modules/eap/setup/eap/modules/module.yaml

@@ -17,11 +17,10 @@ packages:
     - python3-requests
     # RH-SSO add-on:
     # -------------
-    # Add 'which', 'tree' & 'vim-minimal' RPM packages, which are handy for
+    # Add 'which' & 'tree' RPM packages, which are handy for
     # issue debugging / troubleshooting purposes
     - which
     - tree
-    - vim-minimal
     # End of RH-SSO add-on
     # --------------------
 ports:
@@ -34,14 +33,16 @@ artifacts:
   target: maven-repo.zip
   md5: 244700ed92787ad537e360069d9ca9b1
   url: http://$DOWNLOAD_SERVER/devel/candidates/jboss/eap/JBEAP-7.4.0.GA-CR3/jboss-eap-7.4.0.GA-CR3-image-builder-maven-repository.zip
+# CIAM-711: Update RH-SSO server overlay to 'RH-SSO 7.5.0.CR4' build
+- name: keycloak-server-overlay.zip
+  md5: 4150d09f7bf5d524b4173f8850a06617
+# List remaining (particular RH-SSO build independent) artifacts below
 - name: txn-recovery-marker-jdbc-common
   target: txn-recovery-marker-jdbc-common-1.1.4.Final-redhat-00001.jar
   md5: 305aa706018b1089e5b82528b601541f
 - name: txn-recovery-marker-jdbc-hibernate5
   target: txn-recovery-marker-jdbc-hibernate5-1.1.4.Final-redhat-00001.jar
   md5: 99f2a2e68fb92273b8016e2b199fbd91
-- name: keycloak-server-overlay.zip
-  md5: 487913da76566a0196d158aa6a7b0d99
 
 # The following three Wildfly Galleon plug-in related artifacts are required
 # for a successful OSBS build.