974f5be31f9f3a61bd6ec98d1d42fbdbaffbcd2d
[releng/builder.git] / vagrant / rackspace-convert-base / README.md
1 rackspace-convert-base can be used to convert a RackSpace native base
2 image into a Vagrant compatible one. The default image to convert is the
3 'Fedora 20 (Heisenbug) (PVHVM)' image but this can be overridden just by
4 setting the RSIMAGE environment variable before calling the vagrant up.
5
6 ex:
7
8 $ RSIMAGE='CentOS 7 (PVHVM)' vagrant up --provider=rackspace
9
10 This vagrant will just set the instance up at the most basic to be
11 Vagrant capable and also SELinux enforcing. It will then "reseal" itself
12 and state the the system is ready for imaging. Any further RackSpace
13 specific Vagrant definitions will expect a base system of the form
14 "$DISTRO - Vagrant ready" for the base image name
15
16 ex:
17
18 Fedora 20 (Heisenbug) - Vagrant ready
19
20 or
21
22 CentOS 7 - Vagrant ready
23
24 NOTE: The reseal operation _destroys_ the SSH keys that were used to
25 bring the Vagrant system up effectively making the system unable to
26 perform SSH based logins again. This is intentional.