Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/juju4/ansible-lxd
Ansible role to setup LXD, its bridge, pre-copy images and eventually pre-configure some
https://github.com/juju4/ansible-lxd
Last synced: 12 days ago
JSON representation
Ansible role to setup LXD, its bridge, pre-copy images and eventually pre-configure some
- Host: GitHub
- URL: https://github.com/juju4/ansible-lxd
- Owner: juju4
- License: bsd-2-clause
- Created: 2016-08-07T22:41:37.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-11-23T20:09:32.000Z (about 2 months ago)
- Last Synced: 2024-11-23T20:28:36.448Z (about 2 months ago)
- Language: Jinja
- Size: 227 KB
- Stars: 27
- Watchers: 6
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/juju4/ansible-lxd/actions?query=branch%3Amaster)
[](https://github.com/juju4/ansible-lxd/actions?query=branch%3Adevel)
# LXD ansible role
Ansible role to install LXD only and do network configuration.
https://linuxcontainers.org/lxd/getting-started-cli/
Containers configuration or publishing is done in separated roles.
## Requirements & Dependencies
### Ansible
It was tested on the following versions:
* 2.0
* 2.2
* 2.5
### Operating systems
Tested on Ubuntu 18.04, 20.04 and 22.04.
Initial support for RHEL/Centos7 through ngompa/snapcore-el7 copr.
## Example Playbook
Just include this role in your list.
For example
```
- host: all
roles:
- juju4.lxd
```
## Variables
Nothing specific for now.
## Continuous integration
This role has a travis test calling kitchen with lxd (for github), kitchen local with vagrant+virtualbox and also a Vagrantfile (test/vagrant).
Once you ensured all necessary roles are present, You can test with:
```
$ cd /path/to/roles/juju4.lxd
## lxd backend
$ kitchen verify
$ kitchen login
## vagrant+virtualbox backend
$ KITCHEN_YAML=".kitchen.vagrant.yml" kitchen verify
```
or
```
$ cd /path/to/roles/juju4.lxd/test/vagrant
$ vagrant up
$ vagrant ssh
```
## Troubleshooting & Known issues
* for network connectivity
check if http_proxy is set (usually from /etc/default/lxd-bridge proxy settings)
check iptables nat config for masquerading
```
# iptables -t nat -L
## if empty
# iptables -t nat -A POSTROUTING -s 10.x.y.0/24 -o eth0 -j MASQUERADE
```
* if you want to forward traffic external to host to one of the private lxc container
```
# iptables -t nat -A PREROUTING -i if_incoming -p tcp --dport port_incoming -j DNAT --to-destination container_ip:container_port
```
* role can be executed on centos/redhat system on containers as kernel is host's
but RHEL/CentOS 7 has kernel 3.10 which is ?not compatible with LXC.
* service command on centos7 stalling
```
$ /bin/systemctl start lxd
```
* Rhel/Centos8 disable as snap in lxd kitchen requires extra config
https://forum.proxmox.com/threads/ubuntu-snaps-inside-lxc-container-on-proxmox.36463/#post-230060
## License
BSD 2-clause