https://github.com/rgl/vagrant-windows-sysprep
Vagrant plugin to run Windows sysprep as a provisioning step
https://github.com/rgl/vagrant-windows-sysprep
sysprep vagrant windows
Last synced: 7 months ago
JSON representation
Vagrant plugin to run Windows sysprep as a provisioning step
- Host: GitHub
- URL: https://github.com/rgl/vagrant-windows-sysprep
- Owner: rgl
- License: lgpl-3.0
- Created: 2017-04-24T14:40:52.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-08-22T07:43:03.000Z (about 4 years ago)
- Last Synced: 2024-10-31T07:42:23.988Z (about 1 year ago)
- Topics: sysprep, vagrant, windows
- Language: Ruby
- Size: 26.4 KB
- Stars: 10
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- jimsghstars - rgl/vagrant-windows-sysprep - Vagrant plugin to run Windows sysprep as a provisioning step (Ruby)
README
# Vagrant Windows Sysprep Provisioner
[](https://rubygems.org/gems/vagrant-windows-sysprep)
[](https://rubygems.org/gems/vagrant-windows-sysprep)
This is a Vagrant plugin to sysprep Windows.
**NB** This was only tested with Vagrant 2.2.14 and Windows Server 2016/2019 and Windows 10 1809.
# Installation
```bash
vagrant plugin install vagrant-windows-sysprep
```
# Usage
Add `config.vm.provision "windows-sysprep"` to your `Vagrantfile` to sysprep your
Windows VM during provisioning or manually run the provisioner with:
```bash
vagrant provision --provision-with windows-sysprep
```
To troubleshoot, set the `VAGRANT_LOG` environment variable to `debug`.
## Example
In this repo there's an example [Vagrantfile](Vagrantfile). Use it to launch
an example.
First install the [Base Windows 2019 Box](https://github.com/rgl/windows-vagrant).
Then launch the example:
```bash
vagrant up --provider=libvirt # or --provider=virtualbox
```
# Development
To hack on this plugin you need to install [Bundler](http://bundler.io/)
and other dependencies. On Ubuntu:
```bash
sudo apt install bundler libxml2-dev zlib1g-dev
```
Then use it to install the dependencies:
```bash
bundle
```
Build this plugin gem:
```bash
rake
```
Then install it into your local vagrant installation:
```bash
vagrant plugin install pkg/vagrant-windows-sysprep-*.gem
```
You can later run everything in one go:
```bash
rake && vagrant plugin uninstall vagrant-windows-sysprep && vagrant plugin install pkg/vagrant-windows-sysprep-*.gem
```