vagrant-parallels 1.3.10 → 1.3.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/vagrant-parallels/driver/base.rb +23 -2
- data/lib/vagrant-parallels/driver/meta.rb +4 -11
- data/lib/vagrant-parallels/driver/pd_8.rb +8 -8
- data/lib/vagrant-parallels/version.rb +1 -1
- data/test/unit/support/shared/parallels_context.rb +5 -0
- data/website/docs/build/404.html +134 -0
- data/website/docs/build/docs/boxes/base.html +207 -0
- data/website/docs/build/docs/boxes/index.html +161 -0
- data/website/docs/build/docs/boxes/packer.html +181 -0
- data/website/docs/build/docs/boxes/veewee.html +225 -0
- data/website/docs/build/docs/configuration.html +231 -0
- data/website/docs/build/docs/contacts.html +134 -0
- data/website/docs/build/docs/getting-started.html +164 -0
- data/website/docs/build/docs/index.html +157 -0
- data/website/docs/build/docs/installation/index.html +152 -0
- data/website/docs/build/docs/installation/uninstallation.html +141 -0
- data/website/docs/build/docs/installation/updating.html +139 -0
- data/website/docs/build/docs/networking/forwarded_ports.html +196 -0
- data/website/docs/build/docs/networking/index.html +155 -0
- data/website/docs/build/docs/networking/private_network.html +177 -0
- data/website/docs/build/docs/networking/public_network.html +173 -0
- data/website/docs/build/docs/share.html +151 -0
- data/website/docs/build/docs/usage.html +146 -0
- data/website/docs/build/images/current_pointer-539d41b3.png +0 -0
- data/website/docs/build/images/footer_pd_logo-6ec6c3c6.png +0 -0
- data/website/docs/build/images/footer_vagrant_logo-8c7e7b39.png +0 -0
- data/website/docs/build/images/logo_docs-7e96bb5e.png +0 -0
- data/website/docs/build/images/logo_docs_small-c0512386.png +0 -0
- data/website/docs/build/images/nav_divider-0c73f644.png +0 -0
- data/website/docs/build/images/open_close-8d5572c4.png +0 -0
- data/website/docs/build/index.html +157 -0
- data/website/docs/build/javascripts/backstretch-f9c163c1.js +4 -0
- data/website/docs/build/javascripts/bootstrap.min-98cc7a22.js +7 -0
- data/website/docs/build/javascripts/fittext-b487af57.js +10 -0
- data/website/docs/build/javascripts/grid-overlay-19e89cad.js +19 -0
- data/website/docs/build/javascripts/jquery-15b079d7.js +3 -0
- data/website/docs/build/javascripts/less-1.3.0.min-0bbbfaf9.js +3 -0
- data/website/docs/build/javascripts/modernizr-d56a170f.js +8 -0
- data/website/docs/build/javascripts/vagrant-parallels-966ff22c.js +1 -0
- data/website/docs/build/stylesheets/bootstrap-8082a218.css +9 -0
- data/website/docs/build/stylesheets/vagrant-parallels-a389b6ea.css +1 -0
- metadata +38 -2
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html>
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8">
|
|
5
|
+
|
|
6
|
+
<title> Boxes - Vagrant Parallels Provider Documentation</title>
|
|
7
|
+
|
|
8
|
+
<!-- meta -->
|
|
9
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
|
|
10
|
+
|
|
11
|
+
<!-- lib styles -->
|
|
12
|
+
<link href="../../stylesheets/bootstrap-8082a218.css" media="screen" rel="stylesheet" type="text/css" />
|
|
13
|
+
<link href="../../stylesheets/vagrant-parallels-a389b6ea.css" media="screen" rel="stylesheet" type="text/css" />
|
|
14
|
+
|
|
15
|
+
<!-- lib js -->
|
|
16
|
+
<script src="../../javascripts/jquery-15b079d7.js" type="text/javascript"></script>
|
|
17
|
+
<script src="../../javascripts/modernizr-d56a170f.js" type="text/javascript"></script>
|
|
18
|
+
<script src="../../javascripts/bootstrap.min-98cc7a22.js" type="text/javascript"></script>
|
|
19
|
+
<script src="../../javascripts/backstretch-f9c163c1.js" type="text/javascript"></script>
|
|
20
|
+
<script src="../../javascripts/vagrant-parallels-966ff22c.js" type="text/javascript"></script>
|
|
21
|
+
|
|
22
|
+
<!-- fonts -->
|
|
23
|
+
<link href='http://fonts.googleapis.com/css?family=Inconsolata' rel='stylesheet' type='text/css'>
|
|
24
|
+
|
|
25
|
+
</head>
|
|
26
|
+
<body>
|
|
27
|
+
<!-- wrap everything -->
|
|
28
|
+
<div class="wrapper">
|
|
29
|
+
|
|
30
|
+
<!-- nav -->
|
|
31
|
+
|
|
32
|
+
<nav class="docs">
|
|
33
|
+
<div class="container">
|
|
34
|
+
<!-- vagrant logo -->
|
|
35
|
+
<a class="vagrant-docs-logo" href="../">Vagrant Parallels Documentation</a>
|
|
36
|
+
<!-- nav -->
|
|
37
|
+
<ul class="pull-right">
|
|
38
|
+
<li><a href="https://docs.vagrantup.com">Vagrant Docs</a></li>
|
|
39
|
+
<li><a href="https://github.com/Parallels/vagrant-parallels">Github</a></li>
|
|
40
|
+
</ul>
|
|
41
|
+
</div> <!-- container -->
|
|
42
|
+
</nav>
|
|
43
|
+
|
|
44
|
+
<div class="page docs docs-home">
|
|
45
|
+
<div class="container">
|
|
46
|
+
<div class="sidebar span4">
|
|
47
|
+
<!-- get the sidebar nav -->
|
|
48
|
+
<!-- side nav docs -->
|
|
49
|
+
<aside class="sidebar-nav">
|
|
50
|
+
|
|
51
|
+
<div class="toggle hidden-desktop">
|
|
52
|
+
<div class="open-close open"></div>
|
|
53
|
+
<a href="#">Contents</a>
|
|
54
|
+
</div>
|
|
55
|
+
|
|
56
|
+
<ul class="unstyled">
|
|
57
|
+
<li><a href="../">Overview</a></li>
|
|
58
|
+
|
|
59
|
+
<li><a href="../installation/">Installation</a></li>
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
<li><a href="../usage.html">Usage</a></li>
|
|
63
|
+
|
|
64
|
+
<li><a href="../getting-started.html">Getting Started</a></li>
|
|
65
|
+
|
|
66
|
+
<li><a href="../share.html">Vagrant Share</a></li>
|
|
67
|
+
|
|
68
|
+
<li class="current"><a href="./">Boxes</a></li>
|
|
69
|
+
|
|
70
|
+
<ul class="sub unstyled">
|
|
71
|
+
<li><a href="base.html">Creating a Base Box</a></li>
|
|
72
|
+
<li><a href="packer.html">Using Packer</a></li>
|
|
73
|
+
<li><a href="veewee.html">Using Veewee</a></li>
|
|
74
|
+
</ul>
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
<li><a href="../configuration.html">Configuration</a></li>
|
|
78
|
+
|
|
79
|
+
<li><a href="../networking/">Networking</a></li>
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
<li><a href="../contacts.html">Contacts</a></li>
|
|
83
|
+
|
|
84
|
+
</ul>
|
|
85
|
+
</aside> <!-- /.sidebar -->
|
|
86
|
+
</div> <!-- /.sidebar -->
|
|
87
|
+
|
|
88
|
+
<div class="page-contents span9">
|
|
89
|
+
<div class="page-background"></div>
|
|
90
|
+
|
|
91
|
+
<!-- start page content -->
|
|
92
|
+
<div class="row">
|
|
93
|
+
<div class="span8 offset1">
|
|
94
|
+
<h1>Boxes</h1>
|
|
95
|
+
|
|
96
|
+
<p>As with <a href="http://docs.vagrantup.com/v2/providers/basic_usage.html">every provider</a>,
|
|
97
|
+
the Parallels provider has a custom box format.</p>
|
|
98
|
+
|
|
99
|
+
<p>The easiest way to use a box is to add a box from the <a href="https://atlas.hashicorp.com/parallels">Atlas website</a>.
|
|
100
|
+
You can also add and share your own customized boxes there. Read more on the
|
|
101
|
+
<a href="https://atlas.hashicorp.com/help">Atlas Help</a> page. </p>
|
|
102
|
+
|
|
103
|
+
<h2>Discovering boxes</h2>
|
|
104
|
+
|
|
105
|
+
<p>The easiest way to find boxes is to look on the public Vagrant box catalog for a
|
|
106
|
+
box matching your use case: <a href="https://atlas.hashicorp.com/boxes/search?provider=parallels">all boxes with the Parallels provider support</a></p>
|
|
107
|
+
|
|
108
|
+
<p>Official boxes compatible with Parallels provider are available on the
|
|
109
|
+
<a href="https://atlas.hashicorp.com/parallels">parallels account page</a></p>
|
|
110
|
+
|
|
111
|
+
<p>Adding a box from the catalog is very easy:</p>
|
|
112
|
+
|
|
113
|
+
<pre><code>$ vagrant box add parallels/ubuntu-14.04
|
|
114
|
+
...
|
|
115
|
+
</code></pre>
|
|
116
|
+
|
|
117
|
+
<p>You can also quickly initialize a Vagrant environment with command</p>
|
|
118
|
+
|
|
119
|
+
<pre><code>$ vagrant init parallels/ubuntu-14.04
|
|
120
|
+
...
|
|
121
|
+
</code></pre>
|
|
122
|
+
|
|
123
|
+
</div> <!-- /.span8 -->
|
|
124
|
+
</div> <!-- /.row -->
|
|
125
|
+
</div> <!-- /.page-contents -->
|
|
126
|
+
</div> <!-- /.container -->
|
|
127
|
+
</div> <!-- /.page -->
|
|
128
|
+
|
|
129
|
+
<!-- footer -->
|
|
130
|
+
<footer>
|
|
131
|
+
<div class="container">
|
|
132
|
+
<div class="row">
|
|
133
|
+
<ul class="unstyled logos">
|
|
134
|
+
<a href="http://www.vagrantup.com/downloads.html">
|
|
135
|
+
<li class="vagrant-logo-monochrome">
|
|
136
|
+
<p>Vagrant</p>
|
|
137
|
+
</li>
|
|
138
|
+
</a>
|
|
139
|
+
<a href="http://www.parallels.com/downloads/desktop/">
|
|
140
|
+
<li class="pd-logo-monochrome">
|
|
141
|
+
<p>Parallels Desktop</p>
|
|
142
|
+
</li>
|
|
143
|
+
</a>
|
|
144
|
+
</ul> <!-- /span -->
|
|
145
|
+
|
|
146
|
+
</div> <!-- /row -->
|
|
147
|
+
|
|
148
|
+
<div class="row">
|
|
149
|
+
<h6 class="legal">
|
|
150
|
+
© 2015 Parallels IP Holdings GmbH.
|
|
151
|
+
</h6>
|
|
152
|
+
</div> <!-- row -->
|
|
153
|
+
</div> <!-- container -->
|
|
154
|
+
</footer>
|
|
155
|
+
|
|
156
|
+
<!-- close .wrapper -->
|
|
157
|
+
</div>
|
|
158
|
+
|
|
159
|
+
<!-- load scripts -->
|
|
160
|
+
</body>
|
|
161
|
+
</html>
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html>
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8">
|
|
5
|
+
|
|
6
|
+
<title> Using Packer - Vagrant Parallels Provider Documentation</title>
|
|
7
|
+
|
|
8
|
+
<!-- meta -->
|
|
9
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
|
|
10
|
+
|
|
11
|
+
<!-- lib styles -->
|
|
12
|
+
<link href="../../stylesheets/bootstrap-8082a218.css" media="screen" rel="stylesheet" type="text/css" />
|
|
13
|
+
<link href="../../stylesheets/vagrant-parallels-a389b6ea.css" media="screen" rel="stylesheet" type="text/css" />
|
|
14
|
+
|
|
15
|
+
<!-- lib js -->
|
|
16
|
+
<script src="../../javascripts/jquery-15b079d7.js" type="text/javascript"></script>
|
|
17
|
+
<script src="../../javascripts/modernizr-d56a170f.js" type="text/javascript"></script>
|
|
18
|
+
<script src="../../javascripts/bootstrap.min-98cc7a22.js" type="text/javascript"></script>
|
|
19
|
+
<script src="../../javascripts/backstretch-f9c163c1.js" type="text/javascript"></script>
|
|
20
|
+
<script src="../../javascripts/vagrant-parallels-966ff22c.js" type="text/javascript"></script>
|
|
21
|
+
|
|
22
|
+
<!-- fonts -->
|
|
23
|
+
<link href='http://fonts.googleapis.com/css?family=Inconsolata' rel='stylesheet' type='text/css'>
|
|
24
|
+
|
|
25
|
+
</head>
|
|
26
|
+
<body>
|
|
27
|
+
<!-- wrap everything -->
|
|
28
|
+
<div class="wrapper">
|
|
29
|
+
|
|
30
|
+
<!-- nav -->
|
|
31
|
+
|
|
32
|
+
<nav class="docs">
|
|
33
|
+
<div class="container">
|
|
34
|
+
<!-- vagrant logo -->
|
|
35
|
+
<a class="vagrant-docs-logo" href="../">Vagrant Parallels Documentation</a>
|
|
36
|
+
<!-- nav -->
|
|
37
|
+
<ul class="pull-right">
|
|
38
|
+
<li><a href="https://docs.vagrantup.com">Vagrant Docs</a></li>
|
|
39
|
+
<li><a href="https://github.com/Parallels/vagrant-parallels">Github</a></li>
|
|
40
|
+
</ul>
|
|
41
|
+
</div> <!-- container -->
|
|
42
|
+
</nav>
|
|
43
|
+
|
|
44
|
+
<div class="page docs docs-home">
|
|
45
|
+
<div class="container">
|
|
46
|
+
<div class="sidebar span4">
|
|
47
|
+
<!-- get the sidebar nav -->
|
|
48
|
+
<!-- side nav docs -->
|
|
49
|
+
<aside class="sidebar-nav">
|
|
50
|
+
|
|
51
|
+
<div class="toggle hidden-desktop">
|
|
52
|
+
<div class="open-close open"></div>
|
|
53
|
+
<a href="#">Contents</a>
|
|
54
|
+
</div>
|
|
55
|
+
|
|
56
|
+
<ul class="unstyled">
|
|
57
|
+
<li><a href="../">Overview</a></li>
|
|
58
|
+
|
|
59
|
+
<li><a href="../installation/">Installation</a></li>
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
<li><a href="../usage.html">Usage</a></li>
|
|
63
|
+
|
|
64
|
+
<li><a href="../getting-started.html">Getting Started</a></li>
|
|
65
|
+
|
|
66
|
+
<li><a href="../share.html">Vagrant Share</a></li>
|
|
67
|
+
|
|
68
|
+
<li><a href="./">Boxes</a></li>
|
|
69
|
+
|
|
70
|
+
<ul class="sub unstyled">
|
|
71
|
+
<li><a href="base.html">Creating a Base Box</a></li>
|
|
72
|
+
<li class="current"><a href="packer.html">Using Packer</a></li>
|
|
73
|
+
<li><a href="veewee.html">Using Veewee</a></li>
|
|
74
|
+
</ul>
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
<li><a href="../configuration.html">Configuration</a></li>
|
|
78
|
+
|
|
79
|
+
<li><a href="../networking/">Networking</a></li>
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
<li><a href="../contacts.html">Contacts</a></li>
|
|
83
|
+
|
|
84
|
+
</ul>
|
|
85
|
+
</aside> <!-- /.sidebar -->
|
|
86
|
+
</div> <!-- /.sidebar -->
|
|
87
|
+
|
|
88
|
+
<div class="page-contents span9">
|
|
89
|
+
<div class="page-background"></div>
|
|
90
|
+
|
|
91
|
+
<!-- start page content -->
|
|
92
|
+
<div class="row">
|
|
93
|
+
<div class="span8 offset1">
|
|
94
|
+
<h1>Using Packer</h1>
|
|
95
|
+
|
|
96
|
+
<div class="alert alert-warn">
|
|
97
|
+
<p>
|
|
98
|
+
<strong>Warning: Advanced Topic!</strong> If you're not familiar with
|
|
99
|
+
Packer, you should read the <a href="https://packer.io/docs">
|
|
100
|
+
Packer documentation</a> first.
|
|
101
|
+
</p>
|
|
102
|
+
</div>
|
|
103
|
+
|
|
104
|
+
<p>Packer must be properly installed in order to build a new base box using templates.
|
|
105
|
+
Read the installation instruction here: https://packer.io/docs/installation.html</p>
|
|
106
|
+
|
|
107
|
+
<h2>Parallels Virtualization SDK</h2>
|
|
108
|
+
|
|
109
|
+
<p>Packer requires the 'prlsdkapi' Python module from the Parallels Virtualization
|
|
110
|
+
SDK to interact with Parallels Desktop and virtual machines. To use Parallels
|
|
111
|
+
builders for Packer you need to download and install this SDK:
|
|
112
|
+
<a href="http://www.parallels.com/download/pvsdk/">The Parallels Virtualization SDK for Mac</a></p>
|
|
113
|
+
|
|
114
|
+
<h2>Packer Templates</h2>
|
|
115
|
+
|
|
116
|
+
<p>Packer is shipped with <code>parallels-iso</code> builder, which can be used to create
|
|
117
|
+
base Vagrant boxes for the Parallels provider.</p>
|
|
118
|
+
|
|
119
|
+
<p>There are two popular projects containing Packer templates for <code>parallels-iso</code> builder:</p>
|
|
120
|
+
|
|
121
|
+
<ul>
|
|
122
|
+
<li><a href="https://github.com/chef/bento">Bento</a></li>
|
|
123
|
+
<li><a href="https://github.com/boxcutter/">Boxcutter</a></li>
|
|
124
|
+
</ul>
|
|
125
|
+
|
|
126
|
+
<p>In Parallels we build our <a href="https://atlas.hashicorp.com/boxes/search?provider=parallels">official boxes</a>
|
|
127
|
+
using templates based on Bento project.</p>
|
|
128
|
+
|
|
129
|
+
<h2>Building a Box</h2>
|
|
130
|
+
|
|
131
|
+
<p>This is an example how to build Vagrant box for Parallels provider:</p>
|
|
132
|
+
|
|
133
|
+
<pre><code>$ packer build -only=parallels-iso template.json
|
|
134
|
+
</code></pre>
|
|
135
|
+
|
|
136
|
+
<p>Packer will done everything you need: it will download an ISO image, setup a VM,
|
|
137
|
+
install Parallels Tools, make basic provisioning, and it will export the VM image
|
|
138
|
+
to a <code>*.box</code> file</p>
|
|
139
|
+
|
|
140
|
+
<p>You can read more about options which all supported template options here:
|
|
141
|
+
<a href="https://packer.io/docs/builders/parallels-iso.html">"parallels-iso" builder documentation</a></p>
|
|
142
|
+
|
|
143
|
+
</div> <!-- /.span8 -->
|
|
144
|
+
</div> <!-- /.row -->
|
|
145
|
+
</div> <!-- /.page-contents -->
|
|
146
|
+
</div> <!-- /.container -->
|
|
147
|
+
</div> <!-- /.page -->
|
|
148
|
+
|
|
149
|
+
<!-- footer -->
|
|
150
|
+
<footer>
|
|
151
|
+
<div class="container">
|
|
152
|
+
<div class="row">
|
|
153
|
+
<ul class="unstyled logos">
|
|
154
|
+
<a href="http://www.vagrantup.com/downloads.html">
|
|
155
|
+
<li class="vagrant-logo-monochrome">
|
|
156
|
+
<p>Vagrant</p>
|
|
157
|
+
</li>
|
|
158
|
+
</a>
|
|
159
|
+
<a href="http://www.parallels.com/downloads/desktop/">
|
|
160
|
+
<li class="pd-logo-monochrome">
|
|
161
|
+
<p>Parallels Desktop</p>
|
|
162
|
+
</li>
|
|
163
|
+
</a>
|
|
164
|
+
</ul> <!-- /span -->
|
|
165
|
+
|
|
166
|
+
</div> <!-- /row -->
|
|
167
|
+
|
|
168
|
+
<div class="row">
|
|
169
|
+
<h6 class="legal">
|
|
170
|
+
© 2015 Parallels IP Holdings GmbH.
|
|
171
|
+
</h6>
|
|
172
|
+
</div> <!-- row -->
|
|
173
|
+
</div> <!-- container -->
|
|
174
|
+
</footer>
|
|
175
|
+
|
|
176
|
+
<!-- close .wrapper -->
|
|
177
|
+
</div>
|
|
178
|
+
|
|
179
|
+
<!-- load scripts -->
|
|
180
|
+
</body>
|
|
181
|
+
</html>
|
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html>
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8">
|
|
5
|
+
|
|
6
|
+
<title> Using Veewee - Vagrant Parallels Provider Documentation</title>
|
|
7
|
+
|
|
8
|
+
<!-- meta -->
|
|
9
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
|
|
10
|
+
|
|
11
|
+
<!-- lib styles -->
|
|
12
|
+
<link href="../../stylesheets/bootstrap-8082a218.css" media="screen" rel="stylesheet" type="text/css" />
|
|
13
|
+
<link href="../../stylesheets/vagrant-parallels-a389b6ea.css" media="screen" rel="stylesheet" type="text/css" />
|
|
14
|
+
|
|
15
|
+
<!-- lib js -->
|
|
16
|
+
<script src="../../javascripts/jquery-15b079d7.js" type="text/javascript"></script>
|
|
17
|
+
<script src="../../javascripts/modernizr-d56a170f.js" type="text/javascript"></script>
|
|
18
|
+
<script src="../../javascripts/bootstrap.min-98cc7a22.js" type="text/javascript"></script>
|
|
19
|
+
<script src="../../javascripts/backstretch-f9c163c1.js" type="text/javascript"></script>
|
|
20
|
+
<script src="../../javascripts/vagrant-parallels-966ff22c.js" type="text/javascript"></script>
|
|
21
|
+
|
|
22
|
+
<!-- fonts -->
|
|
23
|
+
<link href='http://fonts.googleapis.com/css?family=Inconsolata' rel='stylesheet' type='text/css'>
|
|
24
|
+
|
|
25
|
+
</head>
|
|
26
|
+
<body>
|
|
27
|
+
<!-- wrap everything -->
|
|
28
|
+
<div class="wrapper">
|
|
29
|
+
|
|
30
|
+
<!-- nav -->
|
|
31
|
+
|
|
32
|
+
<nav class="docs">
|
|
33
|
+
<div class="container">
|
|
34
|
+
<!-- vagrant logo -->
|
|
35
|
+
<a class="vagrant-docs-logo" href="../">Vagrant Parallels Documentation</a>
|
|
36
|
+
<!-- nav -->
|
|
37
|
+
<ul class="pull-right">
|
|
38
|
+
<li><a href="https://docs.vagrantup.com">Vagrant Docs</a></li>
|
|
39
|
+
<li><a href="https://github.com/Parallels/vagrant-parallels">Github</a></li>
|
|
40
|
+
</ul>
|
|
41
|
+
</div> <!-- container -->
|
|
42
|
+
</nav>
|
|
43
|
+
|
|
44
|
+
<div class="page docs docs-home">
|
|
45
|
+
<div class="container">
|
|
46
|
+
<div class="sidebar span4">
|
|
47
|
+
<!-- get the sidebar nav -->
|
|
48
|
+
<!-- side nav docs -->
|
|
49
|
+
<aside class="sidebar-nav">
|
|
50
|
+
|
|
51
|
+
<div class="toggle hidden-desktop">
|
|
52
|
+
<div class="open-close open"></div>
|
|
53
|
+
<a href="#">Contents</a>
|
|
54
|
+
</div>
|
|
55
|
+
|
|
56
|
+
<ul class="unstyled">
|
|
57
|
+
<li><a href="../">Overview</a></li>
|
|
58
|
+
|
|
59
|
+
<li><a href="../installation/">Installation</a></li>
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
<li><a href="../usage.html">Usage</a></li>
|
|
63
|
+
|
|
64
|
+
<li><a href="../getting-started.html">Getting Started</a></li>
|
|
65
|
+
|
|
66
|
+
<li><a href="../share.html">Vagrant Share</a></li>
|
|
67
|
+
|
|
68
|
+
<li><a href="./">Boxes</a></li>
|
|
69
|
+
|
|
70
|
+
<ul class="sub unstyled">
|
|
71
|
+
<li><a href="base.html">Creating a Base Box</a></li>
|
|
72
|
+
<li><a href="packer.html">Using Packer</a></li>
|
|
73
|
+
<li class="current"><a href="veewee.html">Using Veewee</a></li>
|
|
74
|
+
</ul>
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
<li><a href="../configuration.html">Configuration</a></li>
|
|
78
|
+
|
|
79
|
+
<li><a href="../networking/">Networking</a></li>
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
<li><a href="../contacts.html">Contacts</a></li>
|
|
83
|
+
|
|
84
|
+
</ul>
|
|
85
|
+
</aside> <!-- /.sidebar -->
|
|
86
|
+
</div> <!-- /.sidebar -->
|
|
87
|
+
|
|
88
|
+
<div class="page-contents span9">
|
|
89
|
+
<div class="page-background"></div>
|
|
90
|
+
|
|
91
|
+
<!-- start page content -->
|
|
92
|
+
<div class="row">
|
|
93
|
+
<div class="span8 offset1">
|
|
94
|
+
<h1>Using Veewee</h1>
|
|
95
|
+
|
|
96
|
+
<div class="alert alert-warn">
|
|
97
|
+
<p>
|
|
98
|
+
<strong>Warning: Advanced Topic!</strong> If you're not familiar with
|
|
99
|
+
Veewee, you should read the <a href="https://github.com/jedi4ever/veewee/blob/master/README.md">
|
|
100
|
+
Veewee documentation</a> first.
|
|
101
|
+
</p>
|
|
102
|
+
</div>
|
|
103
|
+
|
|
104
|
+
<p>Veewee must be properly installed in order to build a new base box using one of
|
|
105
|
+
the existing Veewee templates. If you haven't installed it yet, please refer to
|
|
106
|
+
the <a href="https://github.com/jedi4ever/veewee/blob/master/doc/installation.md">Veewee Installation</a>
|
|
107
|
+
instructions.</p>
|
|
108
|
+
|
|
109
|
+
<h2>Parallels Virtualization SDK</h2>
|
|
110
|
+
|
|
111
|
+
<p>Veewee requires the 'prlsdkapi' Python module from the Parallels Virtualization
|
|
112
|
+
SDK to interact with Parallels Desktop and virtual machines. To use Veewee with
|
|
113
|
+
the Parallels provider you need to download and install this SDK:
|
|
114
|
+
<a href="http://www.parallels.com/download/pvsdk/">The Parallels Virtualization SDK for Mac</a></p>
|
|
115
|
+
|
|
116
|
+
<h2>Preparing a definition</h2>
|
|
117
|
+
|
|
118
|
+
<p>List available Veewee templates, choose what you want to use and create a
|
|
119
|
+
definition:</p>
|
|
120
|
+
|
|
121
|
+
<pre><code>$ veewee parallels templates
|
|
122
|
+
$ veewee parallels define 'my_centos' 'CentOS-6.5-x86_64-minimal'
|
|
123
|
+
</code></pre>
|
|
124
|
+
|
|
125
|
+
<p>Since most of the default templates are not ready to be used with the Parallels
|
|
126
|
+
provider, you need to customize the definition manually.</p>
|
|
127
|
+
|
|
128
|
+
<p>Navigate to the definition folder and create a <code>parallels.sh</code> script with the
|
|
129
|
+
following content:</p>
|
|
130
|
+
|
|
131
|
+
<pre><code># vi ./definition/my_centos/parallels.sh
|
|
132
|
+
|
|
133
|
+
# Install the Parallels Tools
|
|
134
|
+
PARALLELS_TOOLS_ISO=prl-tools-lin.iso
|
|
135
|
+
mkdir -p /media/cdrom
|
|
136
|
+
mount -o loop $PARALLELS_TOOLS_ISO /media/cdrom
|
|
137
|
+
/media/cdrom/install --install-unattended-with-deps --progress
|
|
138
|
+
umount /media/cdrom
|
|
139
|
+
</code></pre>
|
|
140
|
+
|
|
141
|
+
<p>Open the <code>definition.rb</code> file for editing, find the ':postinstall_files' array
|
|
142
|
+
and add the "parallels.sh" string to it. It should now look like this:</p>
|
|
143
|
+
|
|
144
|
+
<pre><code> # vi ./definition/my_centos/definition.rb
|
|
145
|
+
|
|
146
|
+
...
|
|
147
|
+
:postinstall_files => [
|
|
148
|
+
"base.sh",
|
|
149
|
+
"ruby.sh",
|
|
150
|
+
"chef.sh",
|
|
151
|
+
"puppet.sh",
|
|
152
|
+
"vagrant.sh",
|
|
153
|
+
"parallels.sh",
|
|
154
|
+
"cleanup.sh",
|
|
155
|
+
],
|
|
156
|
+
...
|
|
157
|
+
</code></pre>
|
|
158
|
+
|
|
159
|
+
<p>Please observe the following important rules:</p>
|
|
160
|
+
|
|
161
|
+
<ul>
|
|
162
|
+
<li>You can insert <code>"parallels.sh"</code> on any position of this array, but it's
|
|
163
|
+
necessary to place it between <code>"base.sh"</code> and <code>"cleanup.sh"</code></li>
|
|
164
|
+
<li>You also have to comment (or delete) strings like "vbox.sh" or "virtualbox.sh",
|
|
165
|
+
to prevent VirtualBox customization.</li>
|
|
166
|
+
</ul>
|
|
167
|
+
|
|
168
|
+
<h2>Building a VM Image</h2>
|
|
169
|
+
|
|
170
|
+
<p>After customizing the definition you can start building a vm image:</p>
|
|
171
|
+
|
|
172
|
+
<pre><code>$ veewee parallels build 'my_centos'
|
|
173
|
+
</code></pre>
|
|
174
|
+
|
|
175
|
+
<p>This action can take a long time to complete because it involves downloading the
|
|
176
|
+
ISO image, installing the OS, and configuring it after the installation.</p>
|
|
177
|
+
|
|
178
|
+
<h2>Exporting</h2>
|
|
179
|
+
|
|
180
|
+
<pre><code>$ veewee parallels export 'my_centos'
|
|
181
|
+
</code></pre>
|
|
182
|
+
|
|
183
|
+
<p>The virtual machine will be shut down, exported, and packed in the <code>my_centos.box</code>
|
|
184
|
+
file inside the current directory. When it's done, you can use it as any other
|
|
185
|
+
box for the Parallels provider.</p>
|
|
186
|
+
|
|
187
|
+
</div> <!-- /.span8 -->
|
|
188
|
+
</div> <!-- /.row -->
|
|
189
|
+
</div> <!-- /.page-contents -->
|
|
190
|
+
</div> <!-- /.container -->
|
|
191
|
+
</div> <!-- /.page -->
|
|
192
|
+
|
|
193
|
+
<!-- footer -->
|
|
194
|
+
<footer>
|
|
195
|
+
<div class="container">
|
|
196
|
+
<div class="row">
|
|
197
|
+
<ul class="unstyled logos">
|
|
198
|
+
<a href="http://www.vagrantup.com/downloads.html">
|
|
199
|
+
<li class="vagrant-logo-monochrome">
|
|
200
|
+
<p>Vagrant</p>
|
|
201
|
+
</li>
|
|
202
|
+
</a>
|
|
203
|
+
<a href="http://www.parallels.com/downloads/desktop/">
|
|
204
|
+
<li class="pd-logo-monochrome">
|
|
205
|
+
<p>Parallels Desktop</p>
|
|
206
|
+
</li>
|
|
207
|
+
</a>
|
|
208
|
+
</ul> <!-- /span -->
|
|
209
|
+
|
|
210
|
+
</div> <!-- /row -->
|
|
211
|
+
|
|
212
|
+
<div class="row">
|
|
213
|
+
<h6 class="legal">
|
|
214
|
+
© 2015 Parallels IP Holdings GmbH.
|
|
215
|
+
</h6>
|
|
216
|
+
</div> <!-- row -->
|
|
217
|
+
</div> <!-- container -->
|
|
218
|
+
</footer>
|
|
219
|
+
|
|
220
|
+
<!-- close .wrapper -->
|
|
221
|
+
</div>
|
|
222
|
+
|
|
223
|
+
<!-- load scripts -->
|
|
224
|
+
</body>
|
|
225
|
+
</html>
|