ansible/connection_plugins/lxc/README.md

34 lines
963 B
Markdown

ansible-lxc
===========
Ansible Connection Plugin for lxc containers (https://linuxcontainers.org/)
The plugin will use lxc-attach under the hood to connect to containers
INSTALL
=======
1. Clone the plugin in your ansible directory
```
$ mkdir -p /etc/ansible/connection_plugins/
$ git clone git@github.com:Mic92/ansible-lxc.git /etc/ansible/connection_plugins/lxc
```
If your ansible code is already managed by git, you might want to add a submodule instead:
```
$ mkdir -p /etc/ansible/connection_plugins/
$ git submodule add git@github.com:Mic92/ansible-lxc.git /etc/ansible/connection_plugins/lxc
```
2. Then add lxc directory to plugin search path in `ansible.cfg`:
connection_plugins = /usr/share/ansible_plugins/connection_plugins:/etc/ansible/connection_plugins/lxc
USAGE
=====
In your hosts file use container name (`examplecontainer` in this case) as hostname and `ansible_connection` to lxc:
examplecontainer ansible_connection=lxc