manala.network

#######################################################################################################

:exclamation: DEPRECATION :exclamation:

This repository and the role associated are deprecated in favor of the Manala Ansible Collection

You will find informations on its usage on the collection repository

#######################################################################################################

Ansible Role: Network Build Status

:exclamation: Report issues and send Pull Requests in the main Ansible Role repository :exclamation:

This role will handle network hosts, resolver and interfaces.

It's part of the Manala Ansible stack but can be used as a stand alone component.

Requirements

None.

Dependencies

None.

Installation

Ansible 2+

Using ansible galaxy cli:

ansible-galaxy install manala.network

Using ansible galaxy requirements file:

- src: manala.network

Role Handlers

Name Type Description
networking restart Service Restart networking server

Role Variables

Definition

Name Default Type Description
manala_network_hosts_file '/etc/hosts' String Host file path
manala_network_hosts {} Array Hosts
manala_network_resolver_config_file '/etc/resolv.conf' String Resolver file path
manala_network_resolver_config_template ~ String Resolver file template
manala_network_resolver_config ~ String/Array Resolver configuration
manala_network_interfaces_config_file '/etc/network/interfaces' String Interfaces file path
manala_network_interfaces_config_template ~ String Interfaces file template
manala_network_interfaces_config ~ String/Array Interfaces configuration
manala_network_interfaces_configs_exclusive false Boolean Exclusion of existing files additional interfaces configurations
manala_network_interfaces_configs_dir '/etc/network/interfaces.d' String Additional interfaces configurations directory path
manala_network_interfaces_configs_defaults {} Array Additional interfaces configurations defaults
manala_network_interfaces_configs [] Array Additional interfaces configurations directives
manala_network_routing_tables_file '/etc/iproute2/rt_tables' String Routing tables file path
manala_network_routing_tables {} Array Routing tables

Configuration examples

Hosts:

manala_network_hosts:
  189.234.23.35: bismuth.manala.local

Dict's array based hosts (deprecated):

manala_network_hosts:
  - 189.234.23.35: bismuth.manala.local

Content based interfaces config:

manala_network_interfaces_config: |
  # Loopback
  auto lo
  iface lo inet loopback
  # Eth0
  auto eth0
  iface eth0 inet static
    address 189.234.23.30
    netmask 255.255.255.0
    gateway 189.234.23.20
  # Eth1
  auto eth1
  iface eth1 inet manual
    pre-up ip link set dev $IFACE up
    post-down ip link set dev $IFACE down

Dict's array based interfaces config (deprecated):

manala_network_interfaces_config:
  # Loopback
  - auto lo
  - iface lo inet loopback
  # Eth0
  - auto eth0
  - iface eth0 inet static:
      - address: 189.234.23.30
      - netmask: 255.255.255.0
      - gateway: 189.234.23.20
  # Eth1
  - auto eth1
  - iface eth1 inet manual:
      - pre-up: ip link set dev $IFACE up
      - post-down: ip link set dev $IFACE down

Template based interfaces config:

manala_network_interfaces_config_template: network/interfaces.j2

Content based resolver config:

manala_network_resolver_config: |
  search manala.local
  nameserver 189.234.23.1
  nameserver 189.234.23.2

Dict's array based resolver config (deprecated):

manala_network_resolver_config:
  - search: manala.local
  - nameserver: 189.234.23.1
  - nameserver: 189.234.23.2

Template based resolver config:

manala_network_resolver_config_template: network/resolv.conf.j2

Routing tables:

manala_network_routing_tables:
  1: public

Dict's array based routing tables (deprecated):

manala_network_routing_tables:
  - 1: public

Interfaces configurations

manala_network_interfaces_configs_exclusive allows you to clean up existing interfaces configuration files into directory defined by the manala_network_interfaces_configs_dir key. Made to be sure no old or manually created files will alter current configuration.

manala_network_interfaces_configs_exclusive: true

manala_network_interfaces_configs:
  # Content based
  - file: content
    config: |
      auto eth1
      iface eth1 inet dhcp
  # Dicts array template based (deprecated)
  - file: foo
    config:
      - auto eth0:0
      - iface eth0:0 inet static:
        - address: 0.0.0.0
        - netmask: 255.255.255.255
  # Template based (file name based on template)
  - template: network/bar.j2
  # Template based (force file name)
  - file: baz
    template: network/bar.j2
  # Ensure interfaces config is absent
  - file: absent
    state: absent # "present" by default
  # Ignore config
  - file: ignore
    state: ignore
  # Flatten configs
  - "{{ my_custom_interfaces_configs_array }}"

Example playbook

- hosts: servers
  roles:
    - role: manala.network

Licence

MIT

Author information

Manala (http://www.manala.io/)

About

Handle network hosts, resolver and interfaces

Install
ansible-galaxy install manala.network
GitHub repository
License
Unknown
Downloads
2.5k
Owner
Manala is an open source project supported by the french web agency ELAO providing advanced ansible roles for website's infrastructures and far more.