srv6d.jool

Jool Ansible Role

This Ansible role installs Jool, which is an open-source tool for translating between IPv4 and IPv6.

Tests Ansible Galaxy

Example Playbook

Here’s an example of how to use the role in a playbook:

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

Role Variables

Variable Required Default Input Comments
jool_instances yes null list[dict] A list of dictionaries that define the Jool instance configuration in YAML format. Each configuration must include a type key set to either "nat64" or "siit".

Usage

For each Jool instance, a Systemd service will be created, which you can manage using the service name "jool.<instance-name>.service". To manage all Jool instances together, you can use the master service "jool.service".

Requirements

  • Rsync

Supported Distributions

This role has been tested on the following Debian-based distributions, but it might work on others too:

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

Known Issues

  • You cannot change the pool6 setting of a NAT64 instance while it is active. Doing so will cause an error.

License

GNU General Public License v3.0

Author Information

Marvin Vogt (m@rvinvogt.com)

Informazioni sul progetto

Jool, an open source SIIT and a NAT64 implementation for Linux.

Installa
ansible-galaxy install srv6d.jool
Licenza
gpl-3.0
Download
75
Proprietario
Infrastructure Software Engineer. Passionate about reliable, automated and efficient systems/software. Python & Rust