vagrant-parallels 1.0.6.rc1 → 1.0.6
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +32 -133
- data/lib/vagrant-parallels/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: c730a520f86bd6a644552153dc93e37bb88e2101
|
4
|
+
data.tar.gz: e7a1c78c9bc2632dde5215ff010926beb7168a3d
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 7e9eff6c30ec5fb09d20b8b6422c92e0bd3d2869c56a89ab31e27938a62c4e9b0b97b634beb97ac35c00af25c0fb9fe9291a7af2d576d635aaf16bf90ed654d4
|
7
|
+
data.tar.gz: ac7b0e602a129cfc0075fbb68cc1e71f4f718d0bca81bdb3d14a45ac4d32019fa88955ef12a10a330a73510c469a5519bfa09464f396cd192a42ab858e56ba46
|
data/README.md
CHANGED
@@ -15,7 +15,7 @@ If you're just getting started with Vagrant, it is highly recommended that you
|
|
15
15
|
read the official [Vagrant documentation](http://docs.vagrantup.com/v2/) first.
|
16
16
|
|
17
17
|
## Features
|
18
|
-
The Parallels provider supports all basic Vagrant features, except
|
18
|
+
The Parallels provider supports all basic Vagrant features, except the next:
|
19
19
|
**"Forwarded ports" configuration is not available yet**.
|
20
20
|
|
21
21
|
It might be implemented in the future, after the next release of Parallels
|
@@ -32,110 +32,17 @@ Since the Parallels provider is a Vagrant plugin, installing it is easy:
|
|
32
32
|
$ vagrant plugin install vagrant-parallels
|
33
33
|
```
|
34
34
|
|
35
|
-
|
36
|
-
We recommend that you to use the latest version of [Vagrant](http://www.vagrantup.com/downloads.html).
|
37
|
-
If for any reason you want to use a previous version of Vagrant (1.4.x), you
|
38
|
-
should install a compatible version of the Parallels provider as described below:
|
35
|
+
## Provider Documentation
|
39
36
|
|
40
|
-
|
41
|
-
|
42
|
-
```
|
43
|
-
|
44
|
-
## Usage
|
45
|
-
Parallels provider is used just like any other provider. Please read the general
|
46
|
-
[basic usage](http://docs.vagrantup.com/v2/providers/basic_usage.html) page for
|
47
|
-
providers.
|
48
|
-
|
49
|
-
The value to use for the `--provider` flag is `parallels`:
|
50
|
-
|
51
|
-
```
|
52
|
-
$ vagrant init
|
53
|
-
$ vagrant up --provider=parallels
|
54
|
-
...
|
55
|
-
```
|
56
|
-
|
57
|
-
You need a Parallels compatible box specified in your `Vagrantfile`
|
58
|
-
before doing `vagrant up`, please refer to the *Boxes* section for instructions.
|
59
|
-
|
60
|
-
### Default Provider
|
61
|
-
|
62
|
-
You can use `VAGRANT_DEFAULT_PROVIDER` environment variable to specify the
|
63
|
-
default provider. Just set it to `parallels` and then it will not be necessary
|
64
|
-
to add the `--provider` flag to vagrant commands.
|
65
|
-
|
66
|
-
```
|
67
|
-
export VAGRANT_DEFAULT_PROVIDER=parallels
|
68
|
-
```
|
69
|
-
|
70
|
-
You can also add this command to the `~/.bashrc` file
|
71
|
-
(or `~/.zshrc` if your shell is Zsh) to make this setting permanent.
|
72
|
-
|
73
|
-
## Boxes
|
74
|
-
|
75
|
-
Every provider in Vagrant must introduce a custom box format.
|
76
|
-
|
77
|
-
As with every provider, the Parallels provider has a custom box format.
|
78
|
-
The following base boxes for Parallels provider are available:
|
79
|
-
|
80
|
-
- Ubuntu 12.04 x86_64: `parallels/ubuntu-12.04`
|
37
|
+
More information about the Parallels provider is available in
|
38
|
+
[Vagrant Parallels Documentation](http://parallels.github.io/vagrant-parallels/docs/)
|
81
39
|
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
- CentOS 5.9 x86_64: `parallels/centos-6.5`
|
87
|
-
|
88
|
-
You can add one of these boxes using the next command:
|
89
|
-
|
90
|
-
```
|
91
|
-
$ vagrant box add parallels/centos-6.5
|
92
|
-
```
|
40
|
+
We recommend you to start from these pages:
|
41
|
+
* [Usage](http://parallels.github.io/vagrant-parallels/docs/usage.html)
|
42
|
+
* [Getting Started](http://parallels.github.io/vagrant-parallels/docs/getting-started.html)
|
43
|
+
* [Boxes](http://parallels.github.io/vagrant-parallels/docs/boxes/index.html)
|
93
44
|
|
94
|
-
##
|
95
|
-
By default, The Parallels provider uses the basic Vagrant networking
|
96
|
-
approach. Initially, a virtual machine has one adapter assigned to the 'Shared'
|
97
|
-
network in Parallels Desktop.
|
98
|
-
|
99
|
-
In addition, you can add `:private_network` and `:public_network` adapters.
|
100
|
-
These features are working the same way as in the basic Vagrant:
|
101
|
-
- [Private Networks]
|
102
|
-
(http://docs.vagrantup.com/v2/networking/private_network.html)
|
103
|
-
- [Public Networks]
|
104
|
-
(http://docs.vagrantup.com/v2/networking/public_network.html)
|
105
|
-
|
106
|
-
## Provider Specific Configuration
|
107
|
-
|
108
|
-
Parallels Desktop has the `prlctl` command-line utility that can be used to make
|
109
|
-
modifications to Parallels virtual machines.
|
110
|
-
|
111
|
-
|
112
|
-
The Parallels provider allows to execute the prlctl command with any of
|
113
|
-
avialable options just prior to starting a virtual machine:
|
114
|
-
|
115
|
-
```ruby
|
116
|
-
config.vm.provider "parallels" do |v|
|
117
|
-
v.customize ["set", :id, "--device-set", "cdrom0", "--image",
|
118
|
-
"/path/to/disk.iso", "--connect"]
|
119
|
-
end
|
120
|
-
```
|
121
|
-
|
122
|
-
In the example above, the virtual machine is modified to have a specified ISO
|
123
|
-
image mounted on it's virtual media device (cdrom). The `:id` parameter is
|
124
|
-
replaced with the actual virtual machine ID.
|
125
|
-
|
126
|
-
Multiple `customize` directives can be used. They will be executed in the
|
127
|
-
given order.
|
128
|
-
|
129
|
-
The virtual machine memory and CPU settings can be modified easily:
|
130
|
-
|
131
|
-
```ruby
|
132
|
-
config.vm.provider "parallels" do |v|
|
133
|
-
v.memory = 1024
|
134
|
-
v.cpus = 2
|
135
|
-
end
|
136
|
-
```
|
137
|
-
|
138
|
-
## Development
|
45
|
+
## Contributing to the Parallels Provider
|
139
46
|
|
140
47
|
To work on the `vagrant-parallels` plugin development, clone this repository:
|
141
48
|
|
@@ -144,61 +51,53 @@ $ git clone https://github.com/Parallels/vagrant-parallels
|
|
144
51
|
$ cd vagrant-parallels
|
145
52
|
```
|
146
53
|
|
147
|
-
Use [Bundler](http://
|
54
|
+
Use [Bundler](http://bundler.io/) to get the dependencies (Ruby 2.0 is needed)
|
55
|
+
and rake to run the unit test suit:
|
148
56
|
|
149
57
|
```
|
150
|
-
$ bundle
|
58
|
+
$ bundle install
|
59
|
+
$ rake
|
151
60
|
```
|
152
61
|
|
153
|
-
|
62
|
+
If it passes successfully, you're ready to start developing the plugin. Use
|
63
|
+
bundler to execute Vagrant and test the plugin without installing:
|
154
64
|
|
155
65
|
```
|
156
|
-
$ bundle exec
|
66
|
+
$ bundle exec vagrant up --provider=parallels
|
157
67
|
```
|
158
68
|
|
159
|
-
|
160
|
-
|
161
|
-
creating a `Vagrantfile` in the top level of this directory (it is added
|
162
|
-
to *.gitignore*) and add the following line to your `Vagrantfile`
|
69
|
+
### Building Provider from Source
|
70
|
+
To build a `vagrant-parallels` gem just run this command:
|
163
71
|
|
164
|
-
```ruby
|
165
|
-
Vagrant.require_plugin "vagrant-parallels"
|
166
72
|
```
|
167
|
-
|
168
|
-
You need a compatible box file installed. Refer to the *Boxes* section.
|
169
|
-
|
170
|
-
Use bundler to execute Vagrant:
|
171
|
-
|
172
|
-
```
|
173
|
-
$ bundle exec vagrant up --provider=parallels
|
73
|
+
$ rake build
|
174
74
|
```
|
175
75
|
|
176
|
-
|
76
|
+
The built "gem" package will appear in the `./pkg` folder.
|
177
77
|
|
178
|
-
|
179
|
-
following
|
78
|
+
Then, if you want to install plugin from your locally built "gem", use the
|
79
|
+
following commands:
|
180
80
|
|
181
81
|
```
|
182
|
-
$
|
183
|
-
$ bundle install
|
184
|
-
...
|
185
|
-
$ bundle exec rake build
|
186
|
-
...
|
82
|
+
$ vagrant plugin uninstall vagrant-parallels
|
187
83
|
$ vagrant plugin install pkg/vagrant-parallels-<version>.gem
|
188
|
-
...
|
189
84
|
```
|
85
|
+
|
190
86
|
Now that you have your own plugin installed, check it with the command
|
191
87
|
`vagrant plugin list`
|
192
88
|
|
193
|
-
|
89
|
+
### Sending a Pull Request
|
90
|
+
If you're ready to send your changes, please follow the next steps:
|
194
91
|
|
195
|
-
1. Fork it
|
92
|
+
1. Fork the 'vagrant-parallels' repository and ad it as a new remote (`git add
|
93
|
+
remote my-fork <fork_url>`)
|
196
94
|
2. Create a branch (`git checkout -b my-new-feature`)
|
197
95
|
3. Commit your changes (`git commit -am "Added a sweet feature"`)
|
198
|
-
4. Push
|
199
|
-
5. Create a pull request from your `my-new-feature` branch into master
|
96
|
+
4. Push the branch to your fork (`git push fork my-new-feature`)
|
97
|
+
5. Create a pull request from your `my-new-feature` branch into `master` of
|
98
|
+
`vagrant-parallels` repo
|
200
99
|
|
201
|
-
## Getting
|
100
|
+
## Getting Help
|
202
101
|
Having problems while using the provider? Ask your question to our mailing list:
|
203
102
|
[Google Group](https://groups.google.com/group/vagrant-parallels)
|
204
103
|
|
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: vagrant-parallels
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.0.6
|
4
|
+
version: 1.0.6
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Mikhail Zholobov
|
@@ -9,7 +9,7 @@ authors:
|
|
9
9
|
autorequire:
|
10
10
|
bindir: bin
|
11
11
|
cert_chain: []
|
12
|
-
date: 2014-03-
|
12
|
+
date: 2014-03-25 00:00:00.000000000 Z
|
13
13
|
dependencies:
|
14
14
|
- !ruby/object:Gem::Dependency
|
15
15
|
name: bundler
|