An open API service indexing awesome lists of open source software.

https://github.com/debops/ansible-ifupdown

Manage network interface configuration in /etc/network/interfaces
https://github.com/debops/ansible-ifupdown

Last synced: 10 months ago
JSON representation

Manage network interface configuration in /etc/network/interfaces

Awesome Lists containing this project

README

          

## [![DebOps](https://debops.org/images/debops-small.png)](https://debops.org) ifupdown

[![Travis CI](https://img.shields.io/travis/debops/ansible-ifupdown.svg?style=flat)](https://travis-ci.org/debops/ansible-ifupdown)
[![test-suite](https://img.shields.io/badge/test--suite-ansible--ifupdown-blue.svg?style=flat)](https://github.com/debops/test-suite/tree/master/ansible-ifupdown/)
[![Ansible Galaxy](https://img.shields.io/badge/galaxy-debops.ifupdown-660198.svg?style=flat)](https://galaxy.ansible.com/debops/ifupdown)

`ifupdown` is a set of high-level scripts in Debian/Ubuntu Linux
distributions which can be used to configure network interfaces, bridges,
VLAN interfaces, bonding, and so on. You can find example configuration and
usage guides guides on the [NetworkConfiguration] page of the [Debian Wiki].

`debops.ifupdown` is an Ansible role which wraps `ifupdown` in an easy to
use, and Ansible-friendly interface. It aims to be a safe and reliable way
to let you configure network interfaces on hosts managed using Ansible. It
can be used either as a standalone role configured using role/inventory
variables, or as a dependency of another role, to provide network
configuration as needed.

[NetworkConfiguration]: https://wiki.debian.org/NetworkConfiguration
[Debian Wiki]: https://wiki.debian.org/

### Installation

This role requires at least Ansible `v2.2.0`. To install it, run:

```Shell
ansible-galaxy install debops.ifupdown
```

### Documentation

More information about `debops.ifupdown` can be found in the
[official debops.ifupdown documentation](https://docs.debops.org/en/latest/ansible/roles/ansible-ifupdown/docs/).

### Are you using this as a standalone role without DebOps?

You may need to include missing roles from the [DebOps common
playbook](https://github.com/debops/debops-playbooks/blob/master/playbooks/common.yml)
into your playbook.

[Try DebOps now](https://debops.org/) for a complete solution to run your Debian-based infrastructure.

### Authors and license

- [Maciej Delmanowski](https://docs.debops.org/en/latest/debops-keyring/docs/entities.html#debops-keyring-entity-drybjed) (maintainer) | [e-mail](mailto:drybjed@gmail.com) | [Twitter](https://twitter.com/drybjed) | [GitHub](https://github.com/drybjed)
- [Robin Schneider](https://docs.debops.org/en/latest/debops-keyring/docs/entities.html#debops-keyring-entity-ypid) | [e-mail](mailto:ypid@riseup.net) | [GitHub](https://github.com/ypid)

License: [GPL-3.0](https://tldrlegal.com/license/gnu-general-public-license-v3-%28gpl-3%29)

***

This role is part of [DebOps](https://debops.org/). README generated by [ansigenome](https://github.com/nickjj/ansigenome/).