Introduction

Set up the network interfaces on your host. This mainly involves editing the /etc/network/interfaces file.

Requirements

None.

Role Variables

Check the comment in the default variables file for details on how to configure.

Dependencies

None.

Example Playbook

- hosts: whatever
  roles:
    - triplepoint.network_interfaces

Role Testing

This role is tested using molecule, with pipenv for managing dependencies and the Python environment.

Setting Up Your Environment

pip install pipenv

After installing pipenv, create a virtual environment with:

pipenv install --dev

Running Tests

Once your environment is ready, run molecule like this:

pipenv run molecule test

Regenerating the Lock File

You may not need to do this often, but if you change Python package requirements using pipenv install {some_package} or by editing the Pipfile, or if the dependencies are outdated, you might need to update the Pipfile.lock:

pipenv update --dev

Make sure to commit the updated Pipfile.lock after this is done.

To Do

• Switch from ifupdown to netplan.

License

MIT

Notes

• Check the Debian Networking documentation on Ethernet Interfaces.
• For information on VLANs and bridging, visit http://blog.frosty-geek.net/2011/02/ubuntu-tagged-vlan-interfaces-and.html.
• For VLAN interfaces, refer to http://manpages.ubuntu.com/manpages/xenial/man5/vlan-interfaces.5.html.