ansible-role-awx_convert

Convert AWX export into Configuration-as-Code, usable by the role 'awx_import'

Dependencies

Roles

None

Collections

None

Platforms

Supported platforms

• Red Hat Enterprise Linux 8¹
• Red Hat Enterprise Linux 9¹
• Red Hat Enterprise Linux 10¹
• RockyLinux 8¹
• RockyLinux 9¹
• RockyLinux 10¹
• OracleLinux 8¹
• OracleLinux 9¹
• OracleLinux 10¹
• AlmaLinux 8¹
• AlmaLinux 9¹
• AlmaLinux 10¹
• Debian 11 (Bullseye)¹
• Debian 12 (Bookworm)¹
• Debian 13 (Trixie)¹
• Ubuntu 20.04 LTS¹
• Ubuntu 22.04 LTS¹
• Ubuntu 24.04 LTS¹
• Fedora 42¹
• Fedora 43¹

Note: ¹ : no automated testing is performed on these platforms

Role Variables

defaults/main.yml

# Host to execute code from
awx_delegation_host: localhost

# Should the hosts & groups be extracted from inventory (only for old exports)
awx_extract_from_inventory: false

# List of AWX resources to convert
awx_convert_resources:
  - settings
  - organizations
  - credential_types
  - credentials
  # - execution_environments
  - inventory
  - inventory_sources
  - job_templates
  - notification_templates
  - projects
  - teams
  - users
  - workflow_job_templates
  # - roles  ## Not yet implemented
  - schedules
  # - applications  ## Not yet implemented
  # - system_job_templates  ## Not yet implemented
  - groups
  - hosts

# Dict of additional variable files
awx_convert_vars:
  credential_types:
    - injectors
    - inputs
  groups:
    - variables
  hosts:
    - variables
  inventory:
    - variables
  inventory_sources:
    - source_vars
  job_templates:
    - extra_vars
  schedules:
    - extra_data
  workflow_job_templates:
    - extra_vars

Example Playbook

molecule/default/converge.yml

- name: sample playbook for role 'awx_convert' pre playbook
  ansible.builtin.import_playbook: converge-pre.yml
  when: molecule_converge_pre is undefined or molecule_converge_pre | bool
- name: sample playbook for role 'awx_convert'
  hosts: all
  become: 'no'
  vars:
    molecule_driver: '{{ lookup(''env'', ''MOLECULE_DRIVER_NAME'') }}'
    awx_export_path: /tmp/awx
    awx_config_path: /tmp/awx1
  tasks:
    - name: Include role 'awx_convert'
      ansible.builtin.include_role:
        name: awx_convert