https://github.com/victorock/ansible-role-net-setup
Data-driven Network Configuration
https://github.com/victorock/ansible-role-net-setup
Last synced: 3 months ago
JSON representation
Data-driven Network Configuration
- Host: GitHub
- URL: https://github.com/victorock/ansible-role-net-setup
- Owner: victorock
- License: gpl-3.0
- Created: 2018-09-28T19:41:59.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-11-22T08:18:59.000Z (over 6 years ago)
- Last Synced: 2025-01-11T06:10:09.793Z (4 months ago)
- Size: 36.1 KB
- Stars: 1
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
[](https://travis-ci.org/victorock/ansible-role-net-setup)
Role Name
=========
Data-Driven Network Setup adopting net_* modules to enforce desired state.
Requirements
------------
No specific requirements for this role.
Role Variables
--------------
For additional details regarding the variables supported by each net_* modules
consult the official [ansible documentation]( http://docs.ansible.com/ansible/latest/list_of_network_modules.html)
Variables to create users.
```
net_users:
- name: ansible
privilege: 15
configured_password: ansible
sshkey: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
- name: netconf
privilege: 15
configured_password: ansible
sshkey: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
```
Variables to configure system dns/hostname configuration.
```
net_system:
state: present
hostname: switchname
domain_name: acme.com
domain_search:
- ansible.com
- redhat.com
name_servers:
- 8.8.8.8
- 8.8.4.4
```
Variables to test pings from the network device.
```
net_pings:
- count: 1
dest: 127.0.0.1
source: 127.0.0.1
vrf: management
```
Variables to define logging configurations.
```
net_loggings:
- dest: host
name: 1.1.1.1
facility: kernel
level: critical
- dest: host
name: 1.1.1.2
facility: kernel
level: warning
```
Variables to configure banner message for motd or login.
```
net_banner:
state: present
banner: motd
text: "This system management is automated by Ansible"
```
Variables to create static routes.
```
net_static_routes:
- prefix: 2.2.2.2
mask: 255.255.255.0
next_hop: 1.1.1.1
admin_distance: 1
```
Variables to configure L2 parameters on interfaces.
```
net_l2_interfaces:
- name: ethernet1/6
mode: access
access_vlan: 66
- name: ethernet1/5
mode: trunk
native_vlan: 93
trunk_vlans:
- 90
- 91
- 92
trunk_allowed_vlans:
- 90
- 91
- 92
```
Variables to create vlans and associate interfaces to them.
```
net_vlans:
- name: ANSIBLEVLAN10
state: present
vlan_id: 10
interfaces:
- ethernet1/4
- name: ANSIBLEVLAN90
state: present
vlan_id: 90
- name: ANSIBLEVLAN91
state: present
vlan_id: 91
- name: ANSIBLEVLAN92
state: present
vlan_id: 92
- name: ANSIBLEVLAN93
state: present
vlan_id: 93
```
Variables to configure l3 interfaces.
```
net_l3_interfaces:
- name: loopback0
ipv4: 127.0.0.1/32
```
Variables to create VRFs and associate interfaces to them.
```
net_vrf:
- name: control
rd: "1:1"
interfaces:
- loopback0
```
Variables to configure low-level interfaces parameters.
```
net_interfaces:
- name: ethernet1/3
description: interface description
enabled: yes
mtu: 9000
speed: 10g
```
Variables to configure link-aggregation interfaces.
```
net_linkaggs:
- name: port-channel13
members:
- Ethernet1/3
mode: active
min_links: 1
```
Variables to specify interfaces where to activate LLDP.
```
net_lldp_interface:
- name: port-channel13
```
Dependencies
------------
No dependencies from other roles.
Example Playbook
----------------
```YAML
- name: "Baseline Configuration"
hosts: network
connection: network_cli
gather_facts: no
roles:
- role: victorock.net_setup
autorun: true
```
License
-------
GPLv3
Author Information
------------------
Victor da Costa, created this role to use it as part of ansible network workshops.
To have up-to-date information and materials regarding network workshops, visit
[linklight documentation](http://network-automation.github.com/linklight)