Skip to content

Latest commit

 

History

History
142 lines (111 loc) · 3.32 KB

README.md

File metadata and controls

142 lines (111 loc) · 3.32 KB
Raw

Ansible Role: qemu_img

An ansible role to create QEMU disk images.

Requirements

This role use the qemu-img commmand. This role will install qemu_img package for your GNU/Linux distribution. This roles is test on the following GNU/Linux distributions.

  • Archlinux
  • AlmaLinux
  • Debian
  • Centos
  • Fedora
  • RedHat
  • Rocky
  • Suse
  • Ubuntu

Role tasks, tags, variables and templates

Tasks

  • install

    All installation-related tasks are defined in the install playbook. This allows you to install the required packages and start/enable the required service with tasks_from in the include_role, import_role, … ansible modules.

    See example below.

Tags

  • install

    Install the required packages.

Variables

  • qemu_img: "name space"

The data can be in variables or a list (array). When a list is used, the role will loop over the list and create all defined QEMU disk images.

  • dest: required. The destination image.
  • src: optional. The source image, a new image will be created if not defined.
  • size: optional. required if no src is defined. The size of the destination image.
  • owner: uid, default 0. The file owner of the destination image.
  • group: gid, default 0. The file group of the destination image.
  • mode: mode, default '0400'. The permissions of the destination image.
  • remote_src: boolean, default: false. When the source file is in remote host.
  • format: format, default: qcow2. The disk image format.
  • overwrite: boolean, default: false. Overwrite destination if already exists.

Dependencies

None

Example Playbooks

Install the required packages

---
- name: Install libvirt & co
  gather_facts: true 
  hosts: all
  become: true
  tasks:
    - name: Install the requirements
      include_role:
        name: "{{ item }}"
        tasks_from:
          install
      with_items:
        - stafwag.libvirt 
        - stafwag.qemu_img

Create a new qemu image

---
- name: Create a new disk image
  gather_facts: no 
  become: true
  hosts: localhost
  roles:
    - role: stafwag.qemu_img
      vars:
        qemu_img:
          dest: datadisk.qcow2 
          size: 20G 
          format: qcow2

Copy a disk image and resize it

---
- name: Copy a disk image and resize it
  gather_facts: no 
  become: true
  hosts: localhost
  roles:
    - role: stafwag.qemu_img
      vars:
        qemu_img:
          dest: /var/lib/libvirt/images/tstdebian.qcow2 
          format: qcow2
          size: 50G
          src: /home/staf/Downloads/isos/debian/arm64/cloud/debian-10-openstack-arm64.qcow2

Create multiple disk images

---
- name: Create multiple disk images
  gather_facts: no 
  become: true
  hosts: localhost
  roles:
    - role: stafwag.qemu_img
      vars:
        qemu_img:
          - dest: /var/lib/libvirt/images/tstdebian.qcow2 
            src: /home/staf/Downloads/isos/debian/arm64/cloud/debian-10-openstack-arm64.qcow2
          - dest: /var/lib/libvirt/images/tstdebian_data001.qcow 
            size: 20G
          - dest: /var/lib/libvirt/images/tstdebian_data002.qcow 
            size: 20G

License

MIT/BSD

Author Information

Created by Staf Wagemakers, email: staf@wagemakers.be, website: https://www.wagemakers.be, my company: https://mask27.dev