Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ednz-cloud/manage_netplan
Ansible role to manage network configuration using netplan on debian-based systems. Mirror from https://git.ednz.fr/ansible-roles/manage_netplan.
https://github.com/ednz-cloud/manage_netplan
ansible ansible-role linux netplan network
Last synced: 10 days ago
JSON representation
Ansible role to manage network configuration using netplan on debian-based systems. Mirror from https://git.ednz.fr/ansible-roles/manage_netplan.
- Host: GitHub
- URL: https://github.com/ednz-cloud/manage_netplan
- Owner: ednz-cloud
- License: mit
- Created: 2023-04-11T20:39:22.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-02-05T21:43:41.000Z (10 months ago)
- Last Synced: 2024-05-08T00:21:16.025Z (6 months ago)
- Topics: ansible, ansible-role, linux, netplan, network
- Language: Jinja
- Homepage: https://ednz.fr
- Size: 44.9 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
manage_netplan
=========
> This repository is only a mirror. Development and testing is done on a private gitea server.
This role install and configure network interfaces using netplan for **debian-based** distributions.
Requirements
------------
None.
Role Variables
--------------
Available variables are listed below, along with default values. A sample file for the default values is available in `default/hashicorp_consul.yml.sample` in case you need it for any `group_vars` or `host_vars` configuration.
```yaml
manage_netplan_config_file: /etc/netplan/ansible-config.yaml # by default, set to /etc/netplan/ansible-config.yaml
```
This variable defines the path and file name that'll be used to copy over the netplan configuration.
```yaml
manage_netplan_renderer: networkd # by default, set to networkd
```
This variable defines the renderer that'll be used by netplan. Defaults to `networkd`, but `NetworkManager` is also an option.
```yaml
manage_netplan_remove_existing: false # by default, set to false
```
This variable defines whether or not to remove all existing netplan configuration when applying the new one. Defaults to `false`.
```yaml
manage_netplan_search_domain: example.org #by default, set to example.org
```
This variable defines the search domain to use in case you want to specify dns resolution inside of your netplan configuration. This can be left untouched if you do not intend to use it.
```yaml
manage_netplan_install: true # by default, set to true
```
This variable defines whether or not to install netplan and related packages when running this role. It is recommended to not change it to ensure that netplan and eventually NetworkManager are installed. If you are already making sure that these packages are installed elsewhere, you can set this to `false`.
```yaml
manage_netplan_apply: true # by default, set to true
```
This variable defines whether or not to apply the netplan configuration once it has been written to the target system. Defaults to `true`.
```yaml
manage_netplan_configuration: {} # by default, set to {}
```
This variable contains the content of your netplan file in yml format. This what will be used to generate the configuration file on the target host. An example file for this variable is available in `files/netplan_conf_example.yml`.
Dependencies
------------
`ednz_cloud.manage_apt_packages` to install needed packages for netplan.
Example Playbook
----------------
```yaml
# calling the role inside a playbook with either the default or group_vars/host_vars
- hosts: servers
roles:
- ednz_cloud.manage_netplan
```
License
-------
MIT / BSD
Author Information
------------------
This role was created by Bertrand Lanson in 2023.