feat: support sas-bases/overlays kustomization injections (PSKD-1385)

Provide support to inject sas-bases/overlays entries into the base kustomization.yaml.

Author: ephesused

README.md

@@ -185,7 +185,7 @@ The SAS Viya platform customizations that are managed by viya4-deployment are lo
 
 #### Base kustomization.yaml ConfigMap and Secret Generators
 
-In some scenarios, a README or the deployment documentation instructs you to add a `configMapGenerator` or `secretGenerator` entry to the base `kustomization.yaml` (also known as `$deploy/kustomization.yaml`). For example:
+In some scenarios, a README or the deployment documentation instructs you to add a `configMapGenerator` or `secretGenerator` entry to the base `kustomization.yaml` (`$deploy/kustomization.yaml`). For example:
 
 ```yaml
 configMapGenerator:
@@ -221,6 +221,26 @@ envs:
   - site-config/sas-risk-cirrus-rcc/configuration.env 
 ```
 
+#### Base kustomization.yaml additions from sas-bases/overlays
+
+In some scenarios, a README or the deployment documentation instructs you to add an entry to the base `kustomization.yaml` (`$deploy/kustomization.yaml`). For example:
+
+```yaml
+transformers:
+...
+- sas-bases/overlays/backup/sas-scheduled-backup-incr-job-enable.yaml
+...
+```
+
+In that scenario, create an `inject-sas-bases-overlays.yaml` file in a subdirectory under site-config. In the file, create the necessary category and add the entry to it:
+
+```yaml
+transformers:
+- sas-bases/overlays/backup/sas-scheduled-backup-incr-job-enable.yaml
+```
+
+Supported categories are `resources`, `components`, `transformers`, `generators`, and `configurations`. Multiple categories may appear in the file, and multiple entries may appear for each category.
+
 #### OpenLDAP Customizations
 
 The OpenLDAP setup that is described here is a temporary solution that enables you to add users and groups and to start using SAS Viya platform applications. The OpenLDAP server that is created using these instructions does not persist. It is created and destroyed within the SAS Viya platform namespace where it is created. To add users or groups that persist, follow the SAS documentation that describes how to [Configure an LDAP Identity Provider](https://documentation.sas.com/?cdcId=sasadmincdc&cdcVersion=default&docsetId=calids&docsetTarget=n1aw4xnkvwcddnn1mv8lxr2e4tu7.htm#p0spae4p1qoto3n1qpuzafcecxhh).

roles/vdm/library/siteconfig_info.py

@@ -1,5 +1,5 @@
 #
-# Copyright © 2020-2024, SAS Institute Inc., Cary, NC, USA. All Rights Reserved.
+# Copyright © 2020-2025, SAS Institute Inc., Cary, NC, USA. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 #
 from ansible.module_utils.basic import *
@@ -55,8 +55,30 @@ def addResource(self, yamlfile):
       elif "nameReference" in yamlblocks[0]:
         self.add_overlays(Overlay.CONFIGURATION, yamlfile)
 
+  def processSasBasesOverlays(self, folder):
+    sasBasesOverlaysPath = os.path.join(folder, "inject-sas-bases-overlays.yaml")
+    if os.path.exists(sasBasesOverlaysPath):
+      with open(sasBasesOverlaysPath) as file:
+        try:
+          yamlblock = yaml.safe_load(file)
+          for blockName, entries in yamlblock.items():
+            if isinstance(entries, list):
+              try:
+                overlay = Overlay(blockName)
+              except ValueError:
+                continue
+              requiredPrefix = "sas-bases/overlays/"
+              for entry in entries:
+                if entry.startswith(requiredPrefix):
+                  self.add_overlays(overlay, entry)
+                else:
+                  raise ValueError(f"Invalid {blockName} entry in {sasBasesOverlaysPath}: '{entry}'. Valid entries must start with '{requiredPrefix}'")
+        except yaml.YAMLError as exc:
+          raise RuntimeError(f"Error parsing {sasBasesOverlaysPath} as yaml") from exc
 
   def traverse(self, folder):
+    self.processSasBasesOverlays(folder)
+
     if os.path.exists(os.path.join(folder, "kustomization.yaml")) or os.path.exists(os.path.join(folder, "kustomization.yml")):
       kustomizefile = "kustomization.yaml" if os.path.exists(os.path.join(folder, "kustomization.yaml")) else "kustomization.yml"
       kustomizefilefullpath = os.path.join(folder, kustomizefile)