vagrant-lxc-base-boxes/README.md

98 lines
3 KiB
Markdown
Raw Normal View History

2014-03-25 03:26:19 +00:00
# vagrant-lxc base boxes
This repository contains a set of scripts for creating base boxes for usage with
[vagrant-lxc](https://github.com/fgrehm/vagrant-lxc) 1.0+.
## What distros / versions can I build with this?
* Ubuntu
2014-03-27 22:31:06 +00:00
- Precise 12.04 x86_64
- Quantal 12.10 x86_64
- Raring 13.04 x86_64
- Saucy 13.10 x86_64
- Trusty 14.04 x86_64
- Utopic 14.10 x86_64
- Vivid 15.04 x86_64
2015-12-21 12:48:28 +00:00
- Wily 15.10 x86_64
2016-03-12 20:01:32 +00:00
- Xenial 16.04 x86_64
2014-03-25 03:26:19 +00:00
* Debian
2014-03-27 22:31:06 +00:00
- Squeeze x86_64
- Wheezy x86_64
- Jessie x86_64
2016-06-27 12:07:22 +00:00
- Stretch x86_64
2014-03-27 22:31:06 +00:00
- Sid x86_64
* Fedora
- 19 x86_64
- 20 x86_64
- 21 x86_64
- 22 x86_64
- 23 x86_64
- rawhide x86_64
2014-09-24 15:51:10 +00:00
* CentOS
- 6 x86_64
2016-08-15 02:43:55 +00:00
- 7 x86_64
2014-03-25 03:26:19 +00:00
## Building the boxes
2014-03-27 13:14:13 +00:00
_In order to build the boxes you need to have the `lxc-download`
template available on your machine. If you don't have one around please
create one based on [this](https://github.com/lxc/lxc/blob/master/templates/lxc-download.in)
2014-03-27 13:14:13 +00:00
and drop it on your lxc templates path (usually `/usr/share/lxc/templates`)._
2014-03-25 03:26:19 +00:00
```sh
git clone https://github.com/fgrehm/vagrant-lxc-base-boxes.git
cd vagrant-lxc-base-boxes
make precise
```
By default no provisioning tools will be included but you can pick the ones
you want by providing some environmental variables. For example:
```sh
ANSIBLE=1 PUPPET=1 CHEF=1 SALT=1 BABUSHKA=1 \
2014-03-25 03:26:19 +00:00
make precise
```
Will build a Ubuntu Precise x86_64 box with latest Ansible, Puppet, Chef, Salt and
2014-03-25 03:26:19 +00:00
Babushka pre-installed.
When using ANSIBLE=1, an optional ANSIBLE_VERSION parameter may be passed that will specify which version of ansible to install. By default it will install the latest Ansible.
2014-03-25 03:26:19 +00:00
Additional packages to be installed can be specified with the ADDPACKAGES variable:
2015-12-27 15:34:32 +00:00
```sh
ADDPACKAGES="aptitude htop" \
make trusty
```
Will build a Ubuntu Trusty x86_64 box with aptitude and htop as additional
packages pre-installed. You can also specify the packages in a file
trusty_packages.
Note: ADDPACKAGES is currently only implemented for flavors of debian.
2014-03-25 03:26:19 +00:00
## Pre built base boxes
_**NOTE:** None of the base boxes below have a provisioner pre-installed_
2014-03-27 22:31:33 +00:00
| Distribution | VagrantCloud box |
| ------------ | ---------------- |
| Ubuntu Precise 12.04 x86_64 | [fgrehm/precise64-lxc](https://vagrantcloud.com/fgrehm/precise64-lxc) |
| Ubuntu Trusty 14.04 x86_64 | [fgrehm/trusty64-lxc](https://vagrantcloud.com/fgrehm/trusty64-lxc) |
2014-03-27 22:31:33 +00:00
| Debian Wheezy 7 x86_64 | [fgrehm/wheezy64-lxc](https://vagrantcloud.com/fgrehm/wheezy64-lxc) |
| Debian Jessie 8 x86_64 | [glenux/jessie64-lxc](https://atlas.hashicorp.com/glenux/boxes/jessie64-lxc) |
| CentOS 6 x86_64 | [fgrehm/centos-6-64-lxc](https://vagrantcloud.com/fgrehm/centos-6-64-lxc) |
2014-03-27 22:31:33 +00:00
2014-03-25 03:26:19 +00:00
## What makes up for a vagrant-lxc base box?
See [vagrant-lxc/BOXES.md](https://github.com/fgrehm/vagrant-lxc/blob/master/BOXES.md)
## Known issues
* We can't get the NFS client to be installed on the containers used for building
Ubuntu 13.04 / 13.10 / 14.04 base boxes.
* Puppet can't be installed on Debian Sid
2014-03-25 03:26:19 +00:00
* Salt can't be installed on Ubuntu 13.04