Jool Ansible Role

Ansible role to install Jool, an open source IPv4/IPv6 translator.

Example Playbook

- hosts: aftrs
  roles:
    - srv6d.jool
  vars:
    jool_instances:
      - instance: nat64-minimal
        type: nat64
        framework: netfilter
        global:
          pool6: 64:ff9b::/96

Role Variables

Usage

For each Jool instance, a Systemd service will be created that can be managed with the service name "jool.<instance-name>.service". To manage all Jool instances at once, the master service "jool.service" can be used.

Requirements

• Rsync

Supported distributions

The role is tested on the following, but may also work with other debian based distributions:

• Ubuntu
  • 20.04 LTS (Focal Fossa)
  • 22.04 LTS (Jammy Jellyfish)

Known Issues

• The pool6 argument of an existing NAT64 instance cannot be changed while it is active and doing so will result in an error.

License

GNU General Public License v3.0

Author Information

Marvin Vogt (m@rvinvogt.com)