LXD Container Ansible Role

This role manages LXD/LXC Containers on a remote Linux Container Host. https://www.ubuntu.com/containers/lxd

Requirements

LXD 2.0 or greater must be installed on the LXD host and ansible server (it should already be installed by default on Ubuntu 16.04)
LXD should already be setup on the remote host using sudo lxd init or using an Ansible Role such as juju4/lxd
In order for Ansible to manage an LXD host remotely the following commands must be run ahead of time:

On the remote LXD host:

$ lxc config set core.https_address [::]:8443
$ lxc config set core.trust_password replace-this-with-a-secure-password

On the Ansible host:

$ lxc config set core.https_address [::]:8443

$ lxc remote add lxd4 lxd4.example.com

(replace lxd4.example.com with the hostname of your LXD host, 'lxd4' can be named whatever you want, you'll need to reference it in the inventory file)

Tested on an LXD host and Ansible host both using Ubuntu 16.04 LTS (may work with other distros)

Role Variables

These variables are documented here: http://docs.ansible.com/ansible/latest/lxd_container_module.html

state: started (default), stopped, restarted, absent, frozen
type: image (default)
mode: pull (default)
server: https://images.linuxcontainers.org (default)
protocol: lxd (default)
alias: ubuntu/xenial/amd64 (default)
wait_for_ipv4_addresses: true (default)
timeout: 600 (default)

Additional Variables:

public_key: "{{ lookup('file','~/.ssh/id_rsa.pub') }}" (default) - path to public ssh key to install in container
enable_ssh: true (default) - installs and enables the openssh server in the container.
lxd_host: your lxd container host

Dependencies

None

Install

$ ansible-galaxy install ahnooie.lxd-container

Example

The following example will install 6 containers with various Linux distributions on the lxd4.example.com LXD host; and on each host install python, add a public ssh key for the root user, install and start the sshd service.

Inventory File Example

# Remote LXD Host
[lxd]
lxd4.example.com ansible_user=root

# Containers on LXD Hosts
[linux-containers]
ubuntu01.example.com ansible_host=lxd4:ubuntu01 alias=ubuntu/xenial/amd64
centos01.example.com ansible_host=lxd4:centos01 alias=centos/7/amd64
centos02.example.com ansible_host=lxd4:centos02 alias=centos/6/amd64
debian01.example.com ansible_host=lxd4:debian01 alias=debian/stretch/amd64
fedora01.example.com ansible_host=lxd4:fedora01 alias=fedora/27/amd64

[linux-containers:vars]
ansible_connection=lxd
lxd_host=lxd4.example.com

Playbook Example containers.yml

---
- hosts: linux-containers
  gather_facts: false
  vars:
    public_key: "{{ lookup('file','public_keys/id_rsa.pub') }}"
  roles:
  - ahnooie.lxd-container

Playbook Command Example

$ ansible-playbook -i inventory containers.yml

License

MIT

Author Information

Created by Benjamin Bryan

ahnooie / ansible-role-lxd-container