fza / vagrant-parallels

Vagrant Parallels Provider

This is a plugin for Vagrant, allowing to power Parallels Desktop for Mac based virtual machines.

Requirements

• Parallels Desktop for Mac 8 or 9
• Vagrant v1.5 or higher

If you're just getting started with Vagrant, it is highly recommended that you read the official Vagrant documentation first.

Features

The Parallels provider supports all basic Vagrant features, except the next: "Forwarded ports" configuration is not available yet.

It might be implemented in the future, after the next release of Parallels Desktop for Mac.

Installation

First, make sure that you have Parallels Desktop for Mac and Vagrant properly installed. We recommend that you use the latest versions of these products.

Since the Parallels provider is a Vagrant plugin, installing it is easy:

$ vagrant plugin install vagrant-parallels

Provider Documentation

More information about the Parallels provider is available in Vagrant Parallels Documentation

We recommend you to start from these pages:

• Usage
• Getting Started
• Boxes

Contributing to the Parallels Provider

To work on the vagrant-parallels plugin development, clone this repository:

$ git clone https://github.com/Parallels/vagrant-parallels
$ cd vagrant-parallels

Use Bundler to get the dependencies (Ruby 2.0 is needed) and rake to run the unit test suit:

$ bundle install
$ rake

If it passes successfully, you're ready to start developing the plugin. Use bundler to execute Vagrant and test the plugin without installing:

$ bundle exec vagrant up --provider=parallels

Building Provider from Source

To build a vagrant-parallels gem just run this command:

$ rake build

The built "gem" package will appear in the ./pkg folder.

Then, if you want to install plugin from your locally built "gem", use the following commands:

$ vagrant plugin uninstall vagrant-parallels
$ vagrant plugin install pkg/vagrant-parallels-<version>.gem

Now that you have your own plugin installed, check it with the command vagrant plugin list

Sending a Pull Request

If you're ready to send your changes, please follow the next steps:

1. Fork the 'vagrant-parallels' repository and ad it as a new remote (git add remote my-fork <fork_url>)
2. Create a branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am "Added a sweet feature")
4. Push the branch to your fork (git push fork my-new-feature)
5. Create a pull request from your my-new-feature branch into master of vagrant-parallels repo

Getting Help

Having problems while using the provider? Ask your question to our mailing list: Google Group

If you get an error while using the Parallels provider or discover a bug, please report it on the IssueTracker.

Credits

Great thanks to Youssef Shahin @yshahin for having initiated the development of this provider. You've done a great job, Youssef!

Also, thanks to the people who are helping this project stand on its feet, thank you

• Mikhail Zholobov @legal90
• Kevin Kaland @wizonesolutions
• Konstantin Nazarov @racktear
• Dmytro Vasylenko @odi-um
• Thomas Koschate @koschate

and to all the people who are using and testing this provider.