Merge branch 'main' into action_keys

Author: shivashankar-vaddepally

plugins/module_utils/common.py

@@ -619,6 +619,8 @@ def get_valid_desired_states(resource_name):
         desired_states.add("switched")
     if "unset" in supported_operations:
         desired_states.add("unset")
+    if "Install" in supported_operations or "install" in supported_operations:
+        desired_states.add("installed")
     if "rename" in supported_operations:
         desired_states.add("renamed")
     if "apply" in supported_operations:

plugins/module_utils/module_executor.py

@@ -44,6 +44,13 @@
 from .nitro_resource_map import NITRO_RESOURCE_MAP
 
 
+skippable_resource_list = [
+    # In some cases, although keys are listed as immutable in the nitro_resource_map, they can actually be updated.
+    # This list helps bypass the immutability check for these resources.
+    "sytemfile"
+]
+
+
 class ModuleExecutor(object):
     def __init__(self, resource_name, supports_check_mode=True):
         self.resource_name = resource_name
@@ -365,6 +372,14 @@ def is_resource_identical(self):
 
         return (False, None) if diff_list else (True, None)
 
+    @trace
+    def install(self):
+        ok, err = create_resource(
+            self.client, self.resource_name, self.resource_module_params
+        )
+        if not ok:
+            self.return_failure(err)
+
     @trace
     def create_or_update(self):
         self.update_diff_list(
@@ -453,7 +468,7 @@ def create_or_update(self):
                         self.client, self.resource_name, self.resource_module_params
                     )
 
-                elif immutable_keys_list is None:
+                elif immutable_keys_list is None or self.resource_name in skippable_resource_list:
                     self.module_result["changed"] = True
                     log(
                         "INFO: Resource %s:%s exists and is different. Will be UPDATED."
@@ -957,6 +972,9 @@ def main(self):
                 if "bindings" in NITRO_RESOURCE_MAP[self.resource_name].keys():
                     self.sync_all_bindings()
 
+            elif self.resource_name == "install" and self.module.params["state"] == "installed":
+                self.install()
+
             elif self.module.params["state"] in {
                 "created",
                 "imported",

plugins/module_utils/nitro_resource_map.py

@@ -30622,6 +30622,15 @@
             "create": [],
             "force": [],
             "import": [],
+            "install": [
+                "a",
+                "async",
+                "enhancedupgrade",
+                "l",
+                "resizeswapvar",
+                "url",
+                "y",
+            ],
             "link": [],
             "switch": [],
             "unlink": [],

plugins/modules/install.py

@@ -19,19 +19,21 @@
 DOCUMENTATION = r"""
 ---
 module: install
-short_description: Configuration for 0 resource.
-description: Configuration for 0 resource.
+short_description: Configuration for install resource.
+description: Configuration for install resource.
 version_added: 2.0.0
 author:
   - Sumanth Lingappa (@sumanth-lingappa)
   - Shiva Shankar Vaddepally (@shivashankar-vaddepally)
 options:
   state:
-    choices: []
+    choices:
+      - installed
     default: present
     description:
       - The state of the resource being configured by the module on the NetScaler
         ADC node.
+      - When C(Install), the resource will be installed on the NetScaler ADC node.
     type: str
   async:
     type: bool