puppetlabs/vmpooler-provider-vsphere
2
0
Fork 0
mirror of https://github.com/puppetlabs/vmpooler-provider-vsphere.git synced 2026-01-26 03:18:41 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
31 commits 3 branches 14 tags 386 KiB
Find a file
Jake Spain c7d24001c5
Add custom VM attribute information to the docs
2023-01-27 14:08:34 -05:00
.github Fix deprecated method of setting output 2023-01-27 13:55:01 -05:00
lib pin to vmpooler 2.4 2022-07-25 13:00:26 -05:00
scripts Initial commit migrating from VMPooler proper 2021-11-29 16:03:09 -05:00
spec remove upstream spec tests 2022-07-25 14:47:51 -05:00
.gitignore Initial commit migrating from VMPooler proper 2021-11-29 16:03:09 -05:00
.rubocop.yml Fix naming, add docs, add missing test file 2021-12-01 15:59:03 -05:00
.rubocop_todo.yml Fix naming, add docs, add missing test file 2021-12-01 15:59:03 -05:00
CODEOWNERS Remove DIO as codeowners 2022-08-26 09:47:20 -04:00
Gemfile Initial commit migrating from VMPooler proper 2021-11-29 16:03:09 -05:00
Gemfile.lock Merge branch 'main' into dependabot/bundler/rubocop-1.28.2 2022-07-27 08:59:50 -05:00
LICENSE Fix naming, add docs, add missing test file 2021-12-01 15:59:03 -05:00
Rakefile Initial commit migrating from VMPooler proper 2021-11-29 16:03:09 -05:00
README.md Add custom VM attribute information to the docs 2023-01-27 14:08:34 -05:00
vmpooler-provider-vsphere.gemspec Merge branch 'main' into dependabot/bundler/rubocop-1.28.2 2022-07-27 08:59:50 -05:00

README.md

vmpooler-provider-vsphere

This is a provider for VMPooler allows using vSphere as a source of machines. This provider was originally part of the main VMPooler code base but was extracted to be a standalone gem so that development could be done independently of VMPooler itself.

Usage

Include this gem in the same Gemfile that you use to install VMPooler itself and then define one or more pools with the provider key set to vsphere. VMPooler will take care of the rest.

Examples of deploying VMPooler with this provider can be found in the puppetlabs/vmpooler-deployment repository.

Custom VM Config Attribute

This provider sets a custom attribute on the VM called guestinfo.hostname to the name of the generated VM, which can be queried from inside the guest OS if VMware Tools is isntalled. For example:

macOS: "/Library/Application Support/VMware Tools/vmware-tools-daemon" --cmd "info-get guestinfo.hostname" Linux or Windows Guest: vmtoolsd --cmd "info-get guestinfo.hostname"

See the VMware Tools Administration docs for more information about querying information from the GuestInfo variable.

License

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