chore(release): v1.5.0 (#112)

joisika · web-flow · commit d17d979f145c · 2024-10-02T12:06:39.000-04:00
- Update version for release.
- Added support for PowerShell 7.2 to allow running on SDDC Manager.
- Updated documentation for installation on Linux in disconnected environments.
- Fixed module dependency versions in the documentation.

Signed-off-by: Ivaylo Ivanov &lt;iivanov@vmware.com&gt;
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,8 +1,8 @@
 # Release History
 
-## v1.4.1
+## v1.5.0
 
-> Release Date: Unreleased
+> Release Date: 2024-10-02
 
 Bugfix:
 
diff --git a/VMware.CloudFoundation.PowerManagement.psd1 b/VMware.CloudFoundation.PowerManagement.psd1
@@ -11,7 +11,7 @@
     RootModule        = 'VMware.CloudFoundation.PowerManagement.psm1'
 
     # Version number of this module.
-    ModuleVersion     = '1.4.1.1011'
+    ModuleVersion     = '1.5.0.1000'
 
     # Supported PSEditions
     # CompatiblePSEditions = @()
@@ -31,8 +31,8 @@
     # Description of the functionality provided by this module
     Description       = 'PowerShell Module for VMware Cloud Foundation Power Management'
 
-    # Minimum version of the Windows PowerShell engine required by this module
-    PowerShellVersion = '7.4.0'
+    # Minimum version of the PowerShell engine required by this module
+    PowerShellVersion = '7.2.0'
 
     # Name of the Windows PowerShell host required by this module
     # PowerShellHostName = ''
diff --git a/docs/documentation/getting-started/install.md b/docs/documentation/getting-started/install.md
@@ -46,8 +46,8 @@ Verify that your system has a [supported edition and version](./../index.md#powe
 
         Prerequisite for module install on Linux Machine
 
-        ```bash
-        --8<-- "./docs/snippets/pre-req-linux.sh"
+        ```powershell
+        --8<-- "./docs/snippets/pre-req-linux.ps1"
         ```
 
         From a system with an Internet connection, save the module dependencies from the PowerShell Gallery by running the following commands in the PowerShell console:
@@ -56,12 +56,17 @@ Verify that your system has a [supported edition and version](./../index.md#powe
         --8<-- "./docs/snippets/save-module-local-linux.ps1"
         ```
 
-        From the system with an Internet connection, copy the module dependencies to a target system by running the following commands in the PowerShell console:
+        From the system with an Internet connection, copy the `OfflineModules.tar.gz` archive to a target system's directory:
 
         ```bash
         --8<-- "./docs/snippets/copy-module-local-linux.sh"
         ```
 
+        On the target system, extract the archive uploaded in the previous step by running the following commands:
+
+        ```bash
+        --8<-- "./docs/snippets/extract-module-local-linux.sh"
+        ```
         On the target system, import the module dependencies by running the following commands in the PowerShell console:
 
         ```powershell
diff --git a/docs/index.md b/docs/index.md
@@ -49,15 +49,18 @@ The following table lists the required PowerShell module dependencies for this m
 
 PowerShell Module                                    | Version   | Publisher    | Reference
 -----------------------------------------------------|-----------|--------------|---------------------------------------------------------------------------
-[VMware.PowerCLI][psgallery-module-powercli]         | >= 13.1.0 | Broadcom     | :fontawesome-solid-book: &nbsp; [Documentation][developer-module-powercli]
-[PowerVCF][psgallery-module-powervcf]                | >= 2.4.0  | Broadcom     | :fontawesome-solid-book: &nbsp; [Documentation][docs-module-powervcf]
-[PoshSSH][psgallery-module-poshssh]                  | >= 3.0.4  | Carlos Perez | :fontawesome-brands-github: &nbsp; [GitHub][github-module-poshssh]
+[VMware.PowerCLI][psgallery-module-powercli]         | >= 13.3.0 | Broadcom     | :fontawesome-solid-book: &nbsp; [Documentation][developer-module-powercli]
+[PowerVCF][psgallery-module-powervcf]                | >= 2.4.1  | Broadcom     | :fontawesome-solid-book: &nbsp; [Documentation][docs-module-powervcf]
+[PowerValidatedSolutions][psgallery-module-pvs]      | >= 2.11.0 | Broadcom     | :fontawesome-solid-book: &nbsp; [Documentation][docs-module-pvs]
+[PoshSSH][psgallery-module-poshssh]                  | >= 3.0.8  | Carlos Perez | :fontawesome-brands-github: &nbsp; [GitHub][github-module-poshssh]
 
 [docs-module-powervcf]: https://vmware.github.io/powershell-module-for-vmware-cloud-foundation
 [docs-vmware-cloud-foundation]: https://docs.vmware.com/en/VMware-Cloud-Foundation/index.html
+[docs-module-pvs]: https://vmware.github.io/power-validated-solutions-for-cloud-foundation/
 [microsoft-powershell]: https://docs.microsoft.com/en-us/powershell
 [psgallery-module-powercli]: https://www.powershellgallery.com/packages/VMware.PowerCLI
 [psgallery-module-powervcf]: https://www.powershellgallery.com/packages/PowerVCF
+[psgallery-module-pvs]: https://www.powershellgallery.com/packages/PowerValidatedSolutions
 [psgallery-module-power-management]: https://www.powershellgallery.com/packages/VMware.CloudFoundation.PowerManagement
 [psgallery-module-poshssh]: https://www.powershellgallery.com/packages/Posh-SSH
 [developer-module-powercli]: https://developer.vmware.com/tool/vmware-powercli
diff --git a/docs/snippets/copy-module-local-linux.sh b/docs/snippets/copy-module-local-linux.sh
@@ -1 +1 @@
-scp -r /home/modules/* username@remote_host:/home/lab/.local/share/powershell/Modules/
+~/.local/share/powershell/Modules/
diff --git a/docs/snippets/extract-module-local-linux.sh b/docs/snippets/extract-module-local-linux.sh
@@ -0,0 +1,3 @@
+cd ~/.local/share/powershell/Modules/
+tar -zxvf OfflineModules.tar.gz
+rm -rf OfflineModules.tar.gz
diff --git a/docs/snippets/pre-req-linux.ps1 b/docs/snippets/pre-req-linux.ps1
@@ -0,0 +1,2 @@
+$DownloadDir = "~/DownloadModules"
+mkdir $DownloadDir
diff --git a/docs/snippets/pre-req-linux.sh b/docs/snippets/pre-req-linux.sh
diff --git a/docs/snippets/save-module-local-linux.ps1 b/docs/snippets/save-module-local-linux.ps1
@@ -1,5 +1,7 @@
-Save-Module -Name VMware.PowerCLI -MinimumVersion 13.3.0 -Path /home/modules -Repository PSGallery
-Save-Module -Name PowerVCF -MinimumVersion 2.4.1 -Path /home/modules -Repository PSGallery
-Save-Module -Name PowerValidatedSolutions -MinimumVersion 2.11.0 -Path /home/modules -Repository PSGallery
-Save-Module -Name Posh-SSH -MinimumVersion 3.0.8 -Path /home/modules -Repository PSGallery
-Save-Module -Name VMware.CloudFoundation.PowerManagement -Path /home/modules -Repository PSGallery
+Save-Module -Name VMware.PowerCLI -Path $DownloadDir -Repository PSGallery
+Save-Module -Name PowerVCF -Path $DownloadDir -Repository PSGallery
+Save-Module -Name Posh-SSH -Path $DownloadDir -Repository PSGallery
+Save-Module -Name PowerValidatedSolutions -Path $DownloadDir -Repository PSGallery
+Save-Module -Name VMware.CloudFoundation.PowerManagement -Path $DownloadDir -Repository PSGallery
+cd $DownloadDir
+tar -zcvf OfflineModules.tar.gz *

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-scp -r /home/modules/* username@remote_host:/home/lab/.local/share/powershell/Modules/`
	`1`	`+~/.local/share/powershell/Modules/`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+cd ~/.local/share/powershell/Modules/`
	`2`	`+tar -zxvf OfflineModules.tar.gz`
	`3`	`+rm -rf OfflineModules.tar.gz`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+$DownloadDir = "~/DownloadModules"`
	`2`	`+mkdir $DownloadDir`