lilik_playbook/roles/lxc_guest

Role: lxc_guest

This role creates a debian LXC container on an host previously with LXC and network in bridged mode, connecting the container to the interface br0 on the host.

The ip address and gateway of the container are automatically discovered from the ansible inventory. The vm_gateway entry IP is used as gateway while the entry associated with vm_name IP is used as static IP address.

Configuration variables

Name	Description
vm_name*	Name of the LXC container.
vm_size	Size of the VM logical volume. ['5G']
distro	Debian release name. ['buster']
auto_start	Auto-start container. [true]
domain*	The VM domain is set to dmz.$domain
vg_name**	LVM volume group name on the host.

**Note: If vg_name is not provided it will be derived from the ansible_lxc_host variable in the inventory entry of the guest. If the entry pointed by ansible_lxc_host doesn't set has an alterntive vg_name set, it will default to ansible_lxc_host+'-vg'.

Minimal example

group_vars/all.yaml:

---
domain: 'example.com'

hosts:

vm_gateway  ansible_host=10.0.2.1   ansible_user=root
physical1   ansible_host=10.0.1.1   ansible_user=root  vm_name=test-vg
vm1         ansible_host=10.0.2.10  ansible_user=root  ansible_lxc_host=physical1

vm1.yaml:

---
- hosts: vm1
  gather_facts: false # host may not exist yet
  tasks:
    - import_role: name='lxc_guest'
      vars:
       vm_name: '{{ inventory_hostname }}'
       vm_size: '1G'
      delegate_to: '{{ ansible_lxc_host }}'

Command line:

ansible-playbook -i hosts vm1.yaml

Requirements

On Ansible controller:

• connection_plugins/ssh_lxc.py

On LXC host:

• python3-lxc module.

See also

The playbook prepare_host.yaml provides a working configuration for the physical machine running LXC.