← Back to branch summary

~vila/byov/trunk

« back to all changes in this revision

Viewing changes to doc/first-use.rst

  • Committer: Vincent Ladeuil
  • Date: 2018-01-30 09:47:07 UTC
  • Revision ID: v.ladeuil+lp@free.fr-20180130094707-yi9wfwnhlbg0jhia
Rename to byov.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/first-use.rst
2
2
 First use
3
3
===========
4
4
 
5
 
Creating your first virtual machine with ols-vms simply requires an
6
 
ols-vms.conf file in your current directory::
 
5
Creating your first virtual machine with byov simply requires an
 
6
byov.conf file in your current directory::
7
7
 
8
8
   [first]  # The name of the virtual machine
9
9
   vm.class = lxd  # The backend used to manage the vm
12
12
 
13
13
It's enough to create an lxd (vm.class) container for Ubuntu 16.04 xenial::
14
14
   
15
 
   $ ols-vms setup first
 
15
   $ byovm setup first
16
16
 
17
17
Wait a bit if you never created an lxd container as the image needs to be
18
18
downloaded first (it will be cached from that point onwards).
19
19
 
20
20
Once the command finishes, you can just enter the vm::
21
21
 
22
 
   $ ols-vms shell first
 
22
   $ byovm shell first
23
23
   ubuntu@first:~$ uname -m -n
24
24
   first x86_64
25
25
   ubuntu@first:~$ exit
30
30
 
31
31
From there you can stop the vm::
32
32
   
33
 
   $ ols-vms stop first
 
33
   $ byovm stop first
34
34
 
35
35
and get rid of it::
36
36
   
37
 
   $ ols-vms teardown first
 
37
   $ byovm teardown first
38
38
 
39
39
==========
40
40
 Packages
41
41
==========
42
42
 
43
43
Now you may want to add some packages to make the vm a bit more useful, add
44
 
the following to your ols-vms.conf::
 
44
the following to your byov.conf::
45
45
 
46
46
  vm.packages = bzr, git
47
47
 
48
48
and setup the vm again::
49
49
 
50
 
  $ ols-vms setup first
 
50
  $ byovm setup first
51
51
 
52
52
Enter the vm::
53
53
 
54
 
  $ ols-vms shell first
 
54
  $ byovm shell first
55
55
 
56
56
  ubuntu@first:~$ bzr version
57
57
  Bazaar (bzr) 2.7.0
60
60
 
61
61
Stop and tear down the vm to clean up the experiment::
62
62
 
63
 
  $ ols-vms stop first
64
 
  $ ols-vms teardown first
 
63
  $ byovm stop first
 
64
  $ byovm teardown first
65
65
 
66
66
And you're back to a clean slate.
67
67