Update README

This commit is contained in:
Virgil Dupras 2018-07-24 10:04:50 -04:00
parent 2802008032
commit 40c7fda267
1 changed files with 21 additions and 44 deletions

View File

@ -1,37 +1,29 @@
# vagrant-lxc base boxes # vagrant-lxc base boxes
This repository contains a set of scripts for creating base boxes for usage with This repository contains a set of scripts for creating base boxes for usage with
[vagrant-lxc](https://github.com/fgrehm/vagrant-lxc) 1.0+. [vagrant-lxc](https://github.com/fgrehm/vagrant-lxc) 1.4+.
## What distros / versions can I build with this? ## What distros / versions can I build with this?
* Ubuntu * Ubuntu
- 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
- Wily 15.10 x86_64
- Xenial 16.04 x86_64 - Xenial 16.04 x86_64
* Debian * Debian
- Squeeze x86_64
- Wheezy x86_64
- Jessie x86_64
- Stretch x86_64 - Stretch x86_64
- Sid x86_64 - Sid x86_64
* Fedora * Fedora
- 19 x86_64
- 20 x86_64
- 21 x86_64
- 22 x86_64
- 23 x86_64 - 23 x86_64
- rawhide x86_64 - rawhide x86_64
* CentOS * CentOS
- 6 x86_64
- 7 x86_64 - 7 x86_64
## Status
This is a fork of `obnoxxx/vagrant-lxc-base-boxes` which itself was a fork for
`fgrehm/vagrant-lxc-base-boxes`. The goal is to make LXC box generation work for LXC 3.0+. The
repo is not in top shape, but it works `make stretch` (which is what I use myself).
It should be easy enough for you to add support for distros you use (PR welcome).
## Building the boxes ## Building the boxes
_In order to build the boxes you need to have the `lxc-download` _In order to build the boxes you need to have the `lxc-download`
@ -40,58 +32,43 @@ create one based on [this](https://github.com/lxc/lxc/blob/master/templates/lxc-
and drop it on your lxc templates path (usually `/usr/share/lxc/templates`)._ and drop it on your lxc templates path (usually `/usr/share/lxc/templates`)._
```sh ```sh
git clone https://github.com/obnoxxx/vagrant-lxc-base-boxes.git git clone https://github.com/hsoft/vagrant-lxc-base-boxes.git
cd vagrant-lxc-base-boxes cd vagrant-lxc-base-boxes
make precise make stretch
``` ```
By default no provisioning tools will be included but you can pick the ones By default no provisioning tools will be included but you can pick the ones
you want by providing some environmental variables. For example: you want by providing some environmental variables. For example:
```sh ```sh
ANSIBLE=1 PUPPET=1 CHEF=1 SALT=1 BABUSHKA=1 \ ANSIBLE=1 PUPPET=1 CHEF=1 \
make precise make stretch
``` ```
Will build a Ubuntu Precise x86_64 box with latest Ansible, Puppet, Chef, Salt and Will build a Debian Stretch x86_64 box with latest Ansible, Puppet and Chef pre-installed.
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. 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.
Additional packages to be installed can be specified with the ADDPACKAGES variable: Additional packages to be installed can be specified with the ADDPACKAGES variable:
```sh ```sh
ADDPACKAGES="aptitude htop" \ ADDPACKAGES="aptitude htop" \
make trusty make xenial
``` ```
Will build a Ubuntu Trusty x86_64 box with aptitude and htop as additional Will build a Ubuntu Xenial x86_64 box with aptitude and htop as additional
packages pre-installed. You can also specify the packages in a file packages pre-installed. You can also specify the packages in a file
trusty_packages. xenial_packages.
Note: ADDPACKAGES is currently only implemented for flavors of debian. Note: ADDPACKAGES is currently only implemented for flavors of debian.
## Pre built base boxes ## Pre built base boxes
_**NOTE:** None of the base boxes below have a provisioner pre-installed_ There are no pre-built base boxes for this repo. You have to build them yourself.
| 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) |
| 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) |
## What makes up for a vagrant-lxc base box? ## What makes up for a vagrant-lxc base box?
See [vagrant-lxc/BOXES.md](https://github.com/fgrehm/vagrant-lxc/blob/master/BOXES.md) 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
* Salt can't be installed on Ubuntu 13.04