lxd

ansible-lxd

This role manages LXD Profiles and LXD Containers on a remote LXD Server. https://linuxcontainers.org/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
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

LXD Profile variables:

url: unix:/var/snap/lxd/common/lxd/unix.socket (default)
state: present (default), absent

LXD Containers variables:

url: unix:/var/snap/lxd/common/lxd/unix.socket (default)
state: started (default), stopped, restarted, absent, frozen
type: image (default)
mode: pull (default)
server: https://cloud-images.ubuntu.com/releases (default)
protocol: simplestreams (default)
alias: "16.04" (default)
architecture: x86_64 (default)
wait_for_ipv4_addresses: true (default)
timeout: 600 (default)

These variables are documented here:

Additional Variables:

cloud_init: cloud-init config (http://cloudinit.readthedocs.io/en/latest/index.html)

Default values:

# LXD Profiles
lxd_profiles:
  - name: default
    description: "Default LXD Profile"
    status: present

# LXD Containers
LXCs:
  - name: mycontainer
    mode: pull
    server: https://cloud-images.ubuntu.com/releases
    alias: "16.04"
    protocol: simplestreams
    architecture: x86_64
    profile: default
    status: started

Dependencies

None

Example

The following example will configure a default LXD profile with the cloud-init option to install python packages and configure ansible user then install 2 containers on the LXD server.

  - hosts: all
    roles:
      - ansible-lxd
    vars:
      lxd_profiles:
        - name: default
          description: "Default LXD Profile"
          storage_pool: default
          network: lxdbr0
          cloud_init: |
            #cloud-config
            packages:
              - python
            users:
              - name: ansible
                group: sudo
                shell: /bin/bash
                sudo: ALL=(ALL) NOPASSWD:ALL
                ssh_authorized_keys:
                  - {{ lookup('file', '$HOME/.ssh/id_rsa.pub' ) }}
          status: present

      LXCs:
        - name: MyContainer01
          mode: pull
          server: https://cloud-images.ubuntu.com/releases
          alias: "16.04"
          protocol: simplestreams
          architecture: x86_64
          disk_space: 50GB          # Container's Disk limit
          memory: 2GB               # Container's Memory limit
          storage_pool: default
          network: lxdbr0
          ipv4address: 10.0.0.2     # static IPv4 address according with lxdbr0 subnet
          profile: default
          status: started

        - name: MyContainer02
          mode: pull
          server: https://cloud-images.ubuntu.com/releases
          alias: "16.04"
          protocol: simplestreams
          architecture: x86_64
          disk_space: 50GB          # Container's Disk limit
          memory: 2GB               # Container's Memory limit
          nesting: "true"           # Container's security.nesting enabled
          storage_pool: default
          network: lxdbr0
          ipv4address: 10.0.0.3     # static IPv4 address according with lxdbr0 subnet
          profile: default
          status: started