summaryrefslogtreecommitdiff
path: root/README.md
blob: 8bdac5a71498c48c0b42af9cf64a0c2c3c3a50bb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
# nova-lxd [![Build Status](https://travis-ci.org/lxc/nova-lxd.svg?branch=master)](https://travis-ci.org/lxc/nova-lxd)

An OpenStack Compute driver for managing containers using LXD.

## nova-lxd on Devstack

For development purposes, nova-lxd provides a devstack plugin. To use it, just include the
following in your devstack `local.conf`:

```
[[local|localrc]]
enable_plugin nova-lxd https://git.openstack.org/openstack/nova-lxd

# You should enable the following if you use lxd 3.0.
# In addition, this setting requires zfs >= 0.7.0.
#LXD_BACKEND_DRIVER=zfs
```

Change git repositories as needed (it's probably not very useful to point to the main
nova-lxd repo). If you have a local tree you'd like to use, you can symlink your tree to
`/opt/stack/nova-lxd` and do your development from there.

The devstack default images come cirros LXD, you can still download
Ubuntu. Once your stack is up and you've configured authentication
against your devstack, do the following::

```
wget http://cloud-images.ubuntu.com/bionic/current/bionic-server-cloudimg-amd64-root.tar.xz
glance image-create --name bionic-amd64 --disk-format raw --container-format bare --file bionic-server-cloudimg-amd64-root.tar.xz
```

You can test your configuration using the exercise scripts in devstack. For instance,

```
DEFAULT_IMAGE_NAME=bionic-amd64 ./exercises/volumes.sh
```

Please note: the exercise scripts in devstack likely won't work, as they have requirements
for using the cirros images.

# Support and discussions

We use the LXC mailing-lists for developer and user discussions, you can
find and subscribe to those at: https://lists.linuxcontainers.org

If you prefer live discussions, some of us also hang out in
[#lxcontainers](http://webchat.freenode.net/?channels=#lxcontainers) on irc.freenode.net.

## Bug reports

Bug reports can be filed at https://bugs.launchpad.net/nova-lxd