Veewee is a tool for easily (and repeatedly) building custom Vagrant base boxes, KVMs, and virtual machine images.
Vagrant is a great tool for creating and configuring lightweight, reproducible, portable virtual machine environments - often used with the addition of automation tools such as Chef or Puppet.
The first step to build a new virtual machine is to download an existing 'base box'. I believe this scares a lot of people as they don't know how these unverified boxes were built. Therefore a lot of people end up building their own base box which is often time consuming and cumbersome. Veewee aims to automate all the steps for building base boxes and to collect best practices in a transparent way.
Veewee isn't only for Vagrant. It currently supports exporting VM images for the following providers:
OVF filetypeOVA filetypeIMG filetypeparallels format (provided by vagrant-parallels)Before you start, we recommend reading through these pages:
Next, learn about Veewee fundamentals:
Then depending on how you want to use Veewee, we suggest to read through one of the following guides:
Major noteworthy changes between versions can be found here:
A complete list of all docs can be found by viewing the doc directory.
Below is an overview of the veewee command options:
$ bundle exec veewee
# Commands:
# veewee add_share # Adds a Share to the Guest
# veewee fusion # Subcommand for Vmware fusion
# veewee help [COMMAND] # Describe available commands or one specific command
# veewee kvm # Subcommand for KVM
# veewee parallels # Subcommand for Parallels
# veewee vbox # Subcommand for VirtualBox
# veewee version # Prints the Veewee version information
Learn how to avoid typing bundle exec by visiting the Commands doc.
Below is an overview of the veewee provider subcommand options:
$ bundle exec veewee <provider>
# Commands:
# veewee <provider> build [BOX_NAME] # Build box
# veewee <provider> copy [BOXNAME] [SRC] [DST] # Copy a file to the VM
# veewee <provider> define [BOXNAME] [TEMPLATE] # Define a new basebox starting from a template
# veewee <provider> destroy [BOXNAME] # Destroys the basebox that was built
# veewee <provider> halt [BOXNAME] # Activates a shutdown on the basebox
# veewee <provider> help [COMMAND] # Describe subcommands or one specific subcommand
# veewee <provider> list # Lists all defined boxes
# veewee <provider> ostypes # List the available Operating System types
# veewee <provider> screenshot [NAME] [PNGFILENAME] # Takes a screenshot of the box
# veewee <provider> ssh [BOXNAME] [COMMAND] # Interactive ssh login
# veewee <provider> templates # List the currently available templates
# veewee <provider> undefine [BOXNAME] # Removes the definition of a basebox
# veewee <provider> up [BOXNAME] # Starts a Box
# veewee <provider> validate [NAME] # Validates a box against vagrant compliancy rules
# veewee <provider> winrm [BOXNAME] [COMMAND] # Execute command via winrm
People have reported good experiences, why don't you give it a try?
If you have a setup working, share your 'definition' with me. That would be fun!
See CONTRIBUTE.md.
FAQs
Unknown package
We found that veewee demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.