oVirt Image Template

This role has moved to the oVirt Ansible Collection. Please use the latest version there. This repository is now read-only and is not used for active development anymore.

The ovirt.image-template role creates a template from an external image. It currently supports images from Glance external provider or QCOW2 images.

Note

When you install this role from Ansible Galaxy, run the following command:

$ ansible-galaxy install ovirt.image-template

This command will download the role to a directory with the same name as specified, which is ovirt.image-template. Be aware that the name is case-sensitive; if you use OVIRT.image-template, it will create a directory named OVIRT.image-template instead. So be cautious with the role name when running commands.

For RPM installation, you can use three names: oVirt.image-template, ovirt.image-template, and ovirt-image-template. All documentation and examples in this repository will use ovirt.image-template. The other two names are now outdated.

Requirements

• Ansible version 2.9 or higher.
• Python SDK version 4.3 or higher.
• oVirt version 4.1 or higher, and ovirt-imageio must be installed and running.
• CA certificate for the oVirt engine. The path to this certificate should be in the ovirt_ca variable.
• File.

Limitations

• We do not support Ansible Check Mode (Dry Run) for this role because it uses some modules (like the command module) that do not support it. Support may come in the future if all modules used in this role allow it.

Role Variables

The template_disks list can contain the following attributes:

Dependencies

None.

Example Playbook

---
- name: Create a template from qcow
  hosts: localhost
  connection: local
  gather_facts: false

  vars:
    engine_fqdn: ovirt-engine.example.com
    engine_user: admin@internal
    engine_password: 123456
    engine_cafile: /etc/pki/ovirt-engine/ca.pem

    qcow_url: https://cloud.centos.org/centos/7/images/CentOS-7-x86_64-GenericCloud.qcow2
    #qcow_url: file:///tmp/CentOS-7-x86_64-GenericCloud.qcow2
    template_cluster: production
    template_name: centos7_template
    template_memory: 4GiB
    template_cpu: 2
    template_disk_size: 10GiB
    template_disk_storage: mydata

  roles:
    - ovirt.image-template

- name: Create a template from a disk stored in glance
  hosts: localhost
  connection: local
  gather_facts: false

  vars:
    engine_fqdn: ovirt-engine.example.com
    engine_user: admin@internal
    engine_password: 123456
    engine_cafile: /etc/pki/ovirt-engine/ca.pem

    glance_image_provider: qe-infra-glance
    glance_image: rhel7.4_ovirt4.2_guest_disk
    template_cluster: production
    template_name: centos7_template
    template_memory: 4GiB
    template_cpu: 2
    template_disk_size: 10GiB
    template_disk_storage: mydata

  roles:
    - ovirt.image-template

- name: Create a template from qcow2.xz
  hosts: localhost
  connection: local
  gather_facts: false
  pre_tasks:
    - name: Download qcow2.xz file
      get_url:
        url: "https://cloud.centos.org/centos/7/images/CentOS-7-x86_64-GenericCloud.qcow2.xz"
        dest: /tmp
      register: downloaded_file

    - name: Extract downloaded QCOW image
      command: "unxz --keep --force {{ downloaded_file.dest }}"

    - name: Set qcow_url to extracted file
      set_fact:
        qcow_url: "file://{{ (downloaded_file.dest | splitext)[0] }}"
       
  vars:
    engine_fqdn: ovirt-engine.example.com
    engine_user: admin@internal
    engine_password: 123456
    engine_cafile: /etc/pki/ovirt-engine/ca.pem

    template_cluster: production
    template_name: centos7_template
    template_memory: 4GiB
    template_cpu: 2
    template_disk_size: 10GiB
    template_disk_storage: mydata

  roles:
    - ovirt.image-template

License

Apache License 2.0