Windows OpenStack Imaging Tools automates the generation of Windows images.
The tools are a bundle of PowerShell modules and scripts.
The supported target environments for the Windows images are:
- OpenStack with KVM, Hyper-V, VMware and baremetal hypervisor types
- MAAS with KVM, Hyper-V, VMware and baremetal
The generation environment needs to be a Windows one, with Hyper-V virtualization enabled.
If you plan to run the online Windows setup step on another system / hypervisor, the Hyper-V virtualization is not required.
The following versions of Windows images (both x86 / x64, if existent) to be generated are supported:
- Windows Server 2008 / 2008 R2
- Windows Server 2012 / 2012 R2
- Windows Server 2016
- Windows Server 2019
- Windows Server 2022
- Windows 7 / 8 / 8.1 / 10 / 11
To generate Windows Nano Server 2016, please use the following repository:
https://github.com/cloudbase/cloudbase-init-offline-install
- A Windows host, with Hyper-V virtualization enabled, PowerShell >=v4 support
and Windows Assessment and Deployment Kit (ADK) - A Windows installation ISO or DVD
- Windows compatible drivers, if required by the target environment
- Git environment
- Clone this repository
- Mount or extract the Windows ISO file
- Download and / or extract the Windows compatible drivers
- If the target environment is MAAS or the image generation is configured to install updates,
the windows-curtin-hooks and WindowsUpdates git submodules are required.
Rungit submodule update --init
to retrieve them - Import the WinImageBuilder.psm1 module
- Use the New-WindowsCloudImage or New-WindowsOnlineCloudImage methods with
the appropriate configuration file
git clone https://github.com/cloudbase/windows-openstack-imaging-tools.git
pushd windows-openstack-imaging-tools
Import-Module .\WinImageBuilder.psm1
Import-Module .\Config.psm1
Import-Module .\UnattendResources\ini.psm1
# Create a config.ini file using the built in function, then set them accordingly to your needs
$ConfigFilePath = ".\config.ini"
New-WindowsImageConfig -ConfigFilePath $ConfigFilePath
# To automate the config options setting:
Set-IniFileValue -Path (Resolve-Path $ConfigFilePath) -Section "DEFAULT" `
-Key "wim_file_path" `
-Value "D:\Sources\install.wim"
# Use the desired command with the config file you just created
New-WindowsOnlineImage -ConfigFilePath $ConfigFilePath
popd
This command does not require Hyper-V to be enabled, but the generated image
is not ready to be deployed, as it needs to be started manually on another hypervisor.
The image is ready to be used when it shuts down.
You can find a PowerShell example to generate a raw OpenStack Ironic image that also works on KVM
in Examples/create-windows-cloud-image.ps1
This command requires Hyper-V to be enabled, a VMSwitch to be configured for external
network connectivity if the updates are to be installed, which is highly recommended.
This command uses internally the New-WindowsCloudImage
to generate the base image and
start a Hyper-V instance using the base image. After the Hyper-V instance shuts down,
the resulting VHDX is shrinked to a minimum size and converted to the required format.
You can find a PowerShell example to generate a raw OpenStack Ironic image that also works on KVM
in Examples/create-windows-online-cloud-image.ps1
- Make sure that the Hyper-V VMSwitch is correctly configured and it allows Internet connectivity
if you have configured the image generation to install the Windows updates. - Check in the associated Hyper-V VM that the Logon.ps1 script has not failed.
If the script failed, there should be a PowerShell window showing the error message.
- This is the most common scenario that one can encounter and it is easily fixable.
- If you boot on KVM hypervisor, make sure that you configure the correct path for the ISO/folder with VirtIO drivers.
The configuration options arevirtio_iso_path
andvirtio_base_path
. - On the KVM hypervisor side, make sure you start the KVM vm process with the
--enable-kvm
flag. - If you boot on a baremetal machine, make sure that either the basic Windows installation has the storage drivers builtin
or that you specify the proper path to drivers folder for thedrivers_path
configuration option.
- This usually happens when the hypervisor does not expose the CPU flags required for that specific Windows version.
- For example, with Windows 10, you can check https://www.microsoft.com/en-us/windows/windows-10-specifications
and make sure that the CPU flags are exposed by your hypervisor of choice.
- https://ask.cloudbase.it/question/2365/windows-server-2016-standard-image-wont-boot-blue-windows-icon-hangs/
- https://ask.cloudbase.it/question/1227/nano-server-wont-boot/
- https://ask.cloudbase.it/question/1179/win2012-boot-error-on-openstack-in-vmware-env/
You will need PowerShell Pester package installed on your system.
It should already be installed on your system if you are running Windows 10.
If it is not installed you can install it on Windows 10 or greater:
Install-Package Pester
or you can clone it from: https://github.com/pester/Pester
Running the tests in a closed environment:
cmd /c 'powershell.exe -NonInteractive { Invoke-Pester }'
This will run all tests without polluting your current shell environment.
This is not needed if you run it in a Continuous Integration environment.