/ansible-ifupdown

Manage network interface configuration in /etc/network/interfaces

Primary LanguageShellGNU General Public License v3.0GPL-3.0

DebOps project ifupdown

Travis CI test-suite Ansible Galaxy

This role can be used to manage network interface configuration on Debian and derivative operating systems. It manages configuration in the /etc/network/ directory and can be used to create different interface layouts across the cluster.

The debops.ifupdown role tries to recognize several environments (LXC container, OpenVZ container, system with installed NetworkManager) and can automatically select one of the suggested configurations. For most scenarios, debops.ifupdown will try to configure up to two network interfaces (non-existent interfaces are gracefully skipped) with network bridges attached to them, which allows to easily connect virtual machines or containers to the public or private network.

In case an advanced configuration is required (more than two network interfaces, bonding, modem connections, NAT, etc.), you can easily override the automatically selected configuration using Ansible inventory. This role can also be used as a dependency of another role which allows for example to easily manage NAT networks using the debops.subnetwork role.

Some features of interface declarations require additional packages. One of those packages is resolvconf (as defined in ifupdown_packages) which will start to manage your /etc/resolv.conf file.

Installation

This role requires at least Ansible v1.8.0. To install it, run:

ansible-galaxy install debops.ifupdown

Documentation

More information about debops.ifupdown can be found in the official debops.ifupdown documentation.

Are you using this as a standalone role without DebOps?

You may need to include missing roles from the DebOps common playbook into your playbook.

Try DebOps now for a complete solution to run your Debian-based infrastructure.

Authors and license

ifupdown role was written by:

License: GPLv3


This role is part of the DebOps project. README generated by ansigenome.