Ansible Role LVM

Description

Prepare a block EBS device and create volume group, logical volume, filesystem and fstab entry. This role is necessary for instances that store services' data on separated EBS for persistence.

Prerequisites

• An EC2 instance running Ubuntu 18.04 minimal having EBS other than the root devices attached.

Required variables

A configuration block like this is required:

---
- hosts: jenkins_master
  gather_facts: true
  become: true
  vars:
    ansible_ssh_user             : "ubuntu"
    ansible_ssh_private_key_file : "~/.ssh/nfq-tools"
    ansible_python_interpreter   : "/usr/bin/python3"
    project_name  : "nfq"
    env           : "tools"
    terraform_version : "0.12.6"
    terraform_dir     : "/var/lib/terraform-0.12.6"
    ansible_version   : "2.8.1"
    awscli_version    : "1.16.225"
  roles:
    - role: nfq.lvm
      vars:
        lvm_config:
          pvs:
            - "/dev/nvme1n1"
          vgs:
            data:
              pvs:
                - "/dev/nvme1n1"
          lvs:
            - name: "jenkins"
              vg: data
              size: "+100%FREE"
        filesystems_config:
          data:
            dev: "/dev/data/jenkins"
            type: ext4
            opts: ''
        mounts_config:
          data:
            dev: "/dev/data/jenkins"
            fstype: ext4
            opts: 'noatime,nodiratime'
            mountpoint: "/var/lib/jenkins"
            dump: '0'
            passno: '2'
            state: mounted

lvm_config:

• pvs: a list of devices to be used as the physical volumes
• vgs: one or more volume group and its component pvs, in a list
• lvs: a list of one or more logical volume:
  • name: name of the logical volume
  • vg: the volume group that this volume resides in
  • size: Size of the volume, following lvcreate syntax.

filesystems_config:

• dev: device path pointing to the logical volume
• type: filesystem type. Note: The role will not manage dependency of filesystems type (i.e. playbooks need to install mkfs packages on their own)
• opts: mkfs additional options

mount_config:

Configs that correspond to an /etc/fstab entry

Defaults

n/a

Optional variables

n/a

Tags

• install: Create the set EBS > VG > LV > filesystem

Notes

n/a