Merge pull request #63659 from barbaricyawps/more-esxi-banners

[DOCS] Add warning banners to additional VMware related modules

salt/modules/esxcluster.py

@@ -1,5 +1,15 @@
 """
 Module used to access the esxcluster proxy connection methods
+
+.. Warning::
+    This module will be deprecated in a future release of Salt. VMware strongly
+    recommends using the
+    `VMware Salt extensions <https://docs.saltproject.io/salt/extensions/salt-ext-modules-vmware/en/latest/all.html>`_
+    instead of the ESX cluster module. Because the Salt extensions are newer and
+    actively supported by VMware, they are more compatible with current versions
+    of ESXi and they work well with the latest features in the VMware product
+    line.
+
 """
 
 import logging

salt/modules/esxdatacenter.py

@@ -1,5 +1,15 @@
 """
 Module used to access the esxdatacenter proxy connection methods
+
+.. Warning::
+    This module will be deprecated in a future release of Salt. VMware strongly
+    recommends using the
+    `VMware Salt extensions <https://docs.saltproject.io/salt/extensions/salt-ext-modules-vmware/en/latest/all.html>`_
+    instead of the ESX data center module. Because the Salt extensions are newer
+    and actively supported by VMware, they are more compatible with current
+    versions of ESXi and they work well with the latest features in the VMware
+    product line.
+
 """
 
 import logging

salt/modules/esxvm.py

@@ -1,5 +1,16 @@
 """
 Module used to access the esx proxy connection methods
+
+.. Warning::
+    This module will be deprecated in a future release of Salt. VMware strongly
+    recommends using the
+    `VMware Salt extensions <https://docs.saltproject.io/salt/extensions/salt-ext-modules-vmware/en/latest/all.html>`_
+    instead of the ESX VSM module. Because the Salt extensions are newer and
+    actively supported by VMware, they are more compatible with current versions
+    of ESXi and they work well with the latest features in the VMware product
+    line.
+
+
 """
 
 

salt/modules/vcenter.py

@@ -1,5 +1,15 @@
 """
 Module used to access the vcenter proxy connection methods
+
+.. Warning::
+    This module will be deprecated in a future release of Salt. VMware strongly
+    recommends using the
+    `VMware Salt extensions <https://docs.saltproject.io/salt/extensions/salt-ext-modules-vmware/en/latest/all.html>`_
+    instead of the vCenter module. Because the Salt extensions are newer and
+    actively supported by VMware, they are more compatible with current versions
+    of ESXi and they work well with the latest features in the VMware product
+    line.
+
 """
 
 import logging

salt/states/esxcluster.py

@@ -1,6 +1,16 @@
 """
 Manage VMware ESXi Clusters.
 
+.. Warning::
+    This module will be deprecated in a future release of Salt. VMware strongly
+    recommends using the
+    `VMware Salt extensions <https://docs.saltproject.io/salt/extensions/salt-ext-modules-vmware/en/latest/all.html>`_
+    instead of the ESX cluster module. Because the Salt extensions are newer and
+    actively supported by VMware, they are more compatible with current versions
+    of ESXi and they work well with the latest features in the VMware product
+    line.
+
+
 Dependencies
 ============
 

salt/states/esxdatacenter.py

@@ -3,6 +3,16 @@ Salt states to create and manage VMware vSphere datacenters (datacenters).
 
 :codeauthor: `Alexandru Bleotu <alexandru.bleotu@morganstaley.com>`
 
+.. Warning::
+    This module will be deprecated in a future release of Salt. VMware strongly
+    recommends using the
+    `VMware Salt extensions <https://docs.saltproject.io/salt/extensions/salt-ext-modules-vmware/en/latest/all.html>`_
+    instead of the ESX data center module. Because the Salt extensions are newer
+    and actively supported by VMware, they are more compatible with current
+    versions of ESXi and they work well with the latest features in the VMware
+    product line.
+
+
 Dependencies
 ============
 

salt/states/esxvm.py

@@ -1,6 +1,16 @@
 """
 Salt state to create, update VMware ESXi Virtual Machines.
 
+.. Warning::
+    This module will be deprecated in a future release of Salt. VMware strongly
+    recommends using the
+    `VMware Salt extensions <https://docs.saltproject.io/salt/extensions/salt-ext-modules-vmware/en/latest/all.html>`_
+    instead of the ESX VSM module. Because the Salt extensions are newer and
+    actively supported by VMware, they are more compatible with current versions
+    of ESXi and they work well with the latest features in the VMware product
+    line.
+
+
 Dependencies
 ============