openstack/openstack-manuals
Code Issues Proposed changes

Add windows-openstack-imaging-tools

Browse Source 
windows-openstack-imaging-tools is a PowerShell module for automating
the Windows image creation for OpenStack:

https: //github.com/cloudbase/windows-openstack-imaging-tools
Change-Id: Ib37acc533e07a3a970b3b13b437d93ee0a17bdd6
This commit is contained in:
Adrian Vladu 2020-12-22 12:10:09 +02:00
parent d110671319
commit e155100d6b
1 changed files with 39 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/image-guide/source/create-images-automatically.rst
View File

@ -242,3 +242,42 @@ an example for customizing the motd:
This hook script will conveniently be called at the correct moment of the This hook script will conveniently be called at the correct moment of the
build process, when everything is installed, but before unmounting the build process, when everything is installed, but before unmounting the
partition. partition.
windows-openstack-imaging-tools
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
`windows-openstack-imaging-tools
<https://github.com/cloudbase/windows-openstack-imaging-tools>`_
is a PowerShell module that automates the Windows image creation for
OpenStack and supports building VHDX, QCOW2, RAW and VMDK image types.
For easier installation, the tool is published as a PowerShellGallery module
`WindowsImageBuilder
<https://www.powershellgallery.com/packages/WindowsImageBuilder>`_.
Windows image build example:
.. code-block:: powershell
# Install and import WindowsImageBuilder module from PowerShellGallery
Install-Module WindowsImageBuilder -Force
Import-Module WindowsImageBuilder
New-WindowsImageConfig -ConfigFilePath ".\windows-image-config.ini"
# Update the configuration file to fit your specific use case
# Extensive information for all the configuration can be found here:
# https://github.com/cloudbase/windows-openstack-imaging-tools/blob/master/Config.psm1#L21
# Generate the Windows image
New-WindowsOnlineImage -ConfigFilePath ".\windows-image-config.ini"
Requirements:
* 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.
For example, `VirtIO
<https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/>`_,
network card, or storage adapter drivers.
* Git environment.