puppetlabs/vmpooler
2
0
Fork 0
mirror of https://github.com/puppetlabs/vmpooler.git synced 2026-01-26 01:58:41 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
Provide configurable 'pools' of instantly-available (running) virtual machines
612 commits 27 branches 74 tags 5.6 MiB
Find a file
Glenn Sarti 199bf4a070 (POOLER-70) Update check_pending_vm for VM Provider 
Previously the Pool Manager would use vSphere objects directly.  This commit
- Modifies the pool_manager to use the VM provider methods instead
- Removes the open_socket method and tests as it is only required in the vSphere
  VM provider
2017-05-17 13:52:27 -07:00
lib (POOLER-70) Update check_pending_vm for VM Provider 2017-05-17 13:52:27 -07:00
scripts Updated YAML config variables 2016-01-05 13:59:05 -06:00
spec (POOLER-70) Update check_pending_vm for VM Provider 2017-05-17 13:52:27 -07:00
.gitignore (maint) Update Gemfile and gitignore 2017-02-08 17:35:58 -08:00
.rubocop.yml (maint) Update rubocop.yml to ignore 2 cops 2017-04-03 11:30:02 -07:00
.rubocop_todo.yml (maint) Update rubocop.yml to ignore 2 cops 2017-04-03 11:30:02 -07:00
.travis.yml (maint) Add rubocop checks to Travis 2017-02-10 13:33:36 -08:00
API.md Merge CI.next into Master (#161) 2016-07-25 10:43:32 -05:00
Dockerfile Add instructions for running in a Docker container 2016-12-20 10:54:09 -08:00
Gemfile (maint) Pin rack to 1.x 2017-05-12 15:09:27 -07:00
LICENSE (maint) update README.md and LICENSE to reflect rebranding 2016-07-07 23:08:38 +00:00
Rakefile (maint) Only load rubocop rake tasks if gem is available 2017-02-22 15:23:45 -08:00
README.md Remove outdated line about template configuration 2016-12-20 10:55:12 -08:00
vmpooler (maint) Enable Ctrl-C to kill all threads in developer environment 2017-02-08 17:35:58 -08:00
vmpooler.yaml.example (POOLER-72) Add Dummy Provider 2017-05-17 13:52:27 -07:00

README.md

vmpooler

vmpooler

vmpooler provides configurable 'pools' of instantly-available (running) virtual machines.

Usage

At Puppet, Inc. we run acceptance tests on thousands of disposable VMs every day. Dynamic cloning of VM templates initially worked fine for this, but added several seconds to each test run and was unable to account for failed clone tasks. By pushing these operations to a backend service, we were able to both speed up tests and eliminate test failures due to underlying infrastructure failures.

Installation

Prerequisites

vmpooler requires the following Ruby gems be installed:

It also requires that a Redis server exists somewhere, as this is the datastore used for vmpooler's inventory and queueing services.

Configuration

The following YAML configuration sets up two pools, debian-7-i386 and debian-7-x86_64, which contain 5 running VMs each:

---
:vsphere:
  server: 'vsphere.company.com'
  username: 'vmpooler'
  password: 'swimsw1msw!m'

:redis:
  server: 'redis.company.com'

:config:
  logfile: '/var/log/vmpooler.log'

:pools:
  - name: 'debian-7-i386'
    template: 'Templates/debian-7-i386'
    folder: 'Pooled VMs/debian-7-i386'
    pool: 'Pooled VMs/debian-7-i386'
    datastore: 'vmstorage'
    size: 5
  - name: 'debian-7-x86_64'
    template: 'Templates/debian-7-x86_64'
    folder: 'Pooled VMs/debian-7-x86_64'
    pool: 'Pooled VMs/debian-7-x86_64'
    datastore: 'vmstorage'
    size: 5

See the provided YAML configuration example, vmpooler.yaml.example, for additional configuration options and parameters.

Running via Docker

A Dockerfile is included in this repository to allow running vmpooler inside a Docker container. A vmpooler.yaml configuration file can be embedded in the current working directory, or specified inline in a VMPOOLER_CONFIG environment variable. To build and run:

docker build -t vmpooler . && docker run -e VMPOOLER_CONFIG -p 80:4567 -it vmpooler

API and Dashboard

vmpooler provides an API and web front-end (dashboard) on port :4567. See the provided YAML configuration example, vmpooler.yaml.example, to specify an alternative port to listen on.

API

vmpooler provides a REST API for VM management. See the API documentation for more information.

Dashboard

A dashboard is provided to offer real-time statistics and historical graphs. It looks like this:

dashboard

Graphite is required for historical data retrieval. See the provided YAML configuration example, vmpooler.yaml.example, for details.

Command-line Utility

  • The vmpooler_client.py CLI utility provides easy access to the vmpooler service. The tool is cross-platform and written in Python.
  • vmfloaty is a ruby based CLI tool and scripting library written in ruby.

Vagrant plugin

Build status

Build Status

License

vmpooler is distributed under the Apache License, Version 2.0. See the LICENSE file for more details.