nomad-driver-iis

README

Nomad IIS Driver

A driver plugin for nomad to orchestrate windows IIS website tasks.

A "Website" is a combination of an application pool and a site (app, vdir, etc.).
Each allocation will create an application pool and site with the name being the allocation ID (guid).

Requirements

• Nomad >=v0.11
• Go >=v1.11 (to build the provider plugin)
• Vagrant >=v2.2
• VirtualBox v6.0 (or any version vagrant is compatible with)

Building the driver

$ mkdir -p $GOPATH/src/github.com/Roblox
$ cd $GOPATH/src/github.com/Roblox
$ git clone git@github.com:Roblox/nomad-driver-iis.git
$ cd nomad-driver-iis
$ make build (This will build your nomad-driver-iis executable)

Tests

$ make test

This will run nomad-driver-iis tests in the provisioned vagrant VM.

Contributing to nomad-iis-driver

Want to fix a bug, update documentation or add a feature?
PR's are welcome!!
Test your changes locally before contributing.

The easiest way to test your changes is make converge.
make converge will:

1. Build the executable (win_iis.exe)
   
2. Spin up a vagrant VM (vagrant up) if it's not already running.
   
3. Provision your changes into the VM (vagrant provision)
   

Once you are in the VM:

1. nomad-driver-iis codebase (hostpath) is mounted at C:\vagrant in the VM.
   
2. Plugin (executable) is available at C:\ProgramData\nomad\plugin
   
3. Logs are available at C:\ProgramData\nomad\logs.
   
4. Tail on logs in powershell:
   

   $ Get-Content -path "C:\ProgramData\nomad\logs\nomad-output.log" -wait
   

5. Launch an example IIS website:

   $ nomad job run C:\vagrant\examples\iis-test.nomad
   

Cleanup

make clean

This will destroy your vagrant VM (along with all your changes) and remove the executable (win_iis.exe).