[nat64_appliance] Add support for downloading pre-built images

Introduce cifmw_nat64_appliance_image_url parameter to download
pre-built NAT64 images, with optional checksum verification support.

Signed-off-by: Miguel Angel Nieto Jimenez <[email protected]>

Author: mnietoji

roles/nat64_appliance/defaults/main.yml

@@ -40,6 +40,11 @@ cifmw_nat64_appliance_memory: 2
 cifmw_nat64_appliance_cpus: 2
 cifmw_nat64_appliance_ssh_pub_keys: []
 
+# Image download configuration
+# Set cifmw_nat64_appliance_image_url to download a pre-built image
+cifmw_nat64_appliance_image_url: ""
+cifmw_nat64_appliance_image_checksum: ""  # Optional: "sha256:xxxxx"
+cifmw_nat64_appliance_download_timeout: 600  # 10 minutes
 
 cifmw_nat64_ipv6_prefix: "2620:cf:cf:fc00::/64"
 cifmw_nat64_ipv6_tayga_address: "2620:cf:cf:fc00::3"

roles/nat64_appliance/tasks/cleanup.yml

@@ -32,8 +32,19 @@
       community.libvirt.virt:
         command: list_vms
 
-    - name: Stop the nat64_appliance VM
+    - name: Get nat64_appliance VM state
       when: cifmw_nat64_appliance_name in _list_vms.list_vms
+      register: _vm_state
+      community.libvirt.virt:
+        command: status
+        name: "{{ cifmw_nat64_appliance_name }}"
+        uri: "{{ cifmw_nat64_libvirt_uri }}"
+
+    - name: Stop the nat64_appliance VM
+      when:
+        - cifmw_nat64_appliance_name in _list_vms.list_vms
+        - _vm_state.status is defined
+        - _vm_state.status == "running"
       community.libvirt.virt:
         command: destroy
         name: "{{ cifmw_nat64_appliance_name }}"

roles/nat64_appliance/tasks/main.yml

@@ -29,52 +29,66 @@
     state: directory
     mode: "0755"
 
-- name: Install required RPM packages
-  tags:
-    - packages
-  become: true
-  ansible.builtin.package:
-    name:
-      - python3-pip
-      - qemu-img
-      - dosfstools
-      - xfsprogs
-    state: present
+- name: Download pre-built NAT64 appliance image
+  when:
+    - cifmw_nat64_appliance_image_url | length > 0
+  ansible.builtin.get_url:
+    url: "{{ cifmw_nat64_appliance_image_url }}"
+    dest: "{{ cifmw_nat64_appliance_workdir }}/nat64-appliance.qcow2"
+    checksum: "{{ cifmw_nat64_appliance_image_checksum | default(omit) }}"
+    timeout: "{{ cifmw_nat64_appliance_download_timeout }}"
+    mode: "0644"
 
-- name: Install diskimage-builder in virtualenv
-  tags:
-    - packages
-  ansible.builtin.pip:
-    virtualenv_command: "python3 -m venv"
-    virtualenv: "{{ cifmw_nat64_appliance_venv_dir }}"
-    name:
-      - diskimage-builder
-      - setuptools
+- name: Build NAT64 appliance image from source
+  when:
+    - cifmw_nat64_appliance_image_url | length == 0
+  block:
+    - name: Install required RPM packages
+      tags:
+        - packages
+      become: true
+      ansible.builtin.package:
+        name:
+          - python3-pip
+          - qemu-img
+          - dosfstools
+          - xfsprogs
+        state: present
 
-- name: Copy files to cifmw_nat64_appliance_dir
-  ansible.builtin.copy:
-    src: "{{ item }}"
-    dest: "{{ cifmw_nat64_appliance_workdir }}/{{ item }}"
-    mode: preserve
-  loop:
-    - "elements/"
-    - nat64-appliance.yaml
+    - name: Install diskimage-builder in virtualenv
+      tags:
+        - packages
+      ansible.builtin.pip:
+        virtualenv_command: "python3 -m venv"
+        virtualenv: "{{ cifmw_nat64_appliance_venv_dir }}"
+        name:
+          - diskimage-builder
+          - setuptools
+
+    - name: Copy files to cifmw_nat64_appliance_dir
+      ansible.builtin.copy:
+        src: "{{ item }}"
+        dest: "{{ cifmw_nat64_appliance_workdir }}/{{ item }}"
+        mode: preserve
+      loop:
+        - "elements/"
+        - nat64-appliance.yaml
 
-- name: Clone edpm-image-builder (reset-bls-entries dib element)
-  ansible.builtin.git:
-    repo: https://github.com/openstack-k8s-operators/edpm-image-builder.git
-    dest: "{{ cifmw_nat64_appliance_workdir }}/edpm-image-builder"
-    version: main
+    - name: Clone edpm-image-builder (reset-bls-entries dib element)
+      ansible.builtin.git:
+        repo: https://github.com/openstack-k8s-operators/edpm-image-builder.git
+        dest: "{{ cifmw_nat64_appliance_workdir }}/edpm-image-builder"
+        version: main
 
-- name: Build the nat64-appliance image using DIB
-  become: "{{ cifmw_nat64_appliance_run_dib_as_root | default(false) | bool }}"
-  environment:
-    ELEMENTS_PATH: "{{ cifmw_nat64_appliance_workdir }}/elements:{{ cifmw_nat64_appliance_workdir }}/edpm-image-builder/dib/"
-    DIB_IMAGE_CACHE: "{{ cifmw_nat64_appliance_workdir }}/cache"
-    DIB_DEBUG_TRACE: '1'
-  cifmw.general.ci_script:
-    chdir: "{{ cifmw_nat64_appliance_workdir }}"
-    output_dir: "{{ cifmw_nat64_appliance_basedir }}/artifacts"
-    creates: "{{ cifmw_nat64_appliance_workdir }}/nat64-appliance.qcow2"
-    script: "{{ cifmw_nat64_appliance_venv_dir }}/bin/diskimage-builder nat64-appliance.yaml {{ extra_args | default('') }}"
-    executable: "/bin/bash"
+    - name: Build the nat64-appliance image using DIB
+      become: "{{ cifmw_nat64_appliance_run_dib_as_root | default(false) | bool }}"
+      environment:
+        ELEMENTS_PATH: "{{ cifmw_nat64_appliance_workdir }}/elements:{{ cifmw_nat64_appliance_workdir }}/edpm-image-builder/dib/"
+        DIB_IMAGE_CACHE: "{{ cifmw_nat64_appliance_workdir }}/cache"
+        DIB_DEBUG_TRACE: '1'
+      cifmw.general.ci_script:
+        chdir: "{{ cifmw_nat64_appliance_workdir }}"
+        output_dir: "{{ cifmw_nat64_appliance_basedir }}/artifacts"
+        creates: "{{ cifmw_nat64_appliance_workdir }}/nat64-appliance.qcow2"
+        script: "{{ cifmw_nat64_appliance_venv_dir }}/bin/diskimage-builder nat64-appliance.yaml {{ extra_args | default('') }}"
+        executable: "/bin/bash"