vagrant-parallels 1.3.10 → 1.3.12
Sign up to get free protection for your applications and to get access to all the features.
- 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>
|