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: 3 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 (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2021-08-22T07:43:03.000Z (over 3 years ago)
• Last Synced: 2024-10-31T07:42:23.988Z (4 months 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

[![Latest version released](https://img.shields.io/gem/v/vagrant-windows-sysprep.svg)](https://rubygems.org/gems/vagrant-windows-sysprep)

[![Package downloads count](https://img.shields.io/gem/dt/vagrant-windows-sysprep.svg)](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

```