Go to file
Jan Christian Grünhage cc47859428
initial commit
2020-04-13 12:18:15 +02:00
defaults initial commit 2020-04-13 12:18:15 +02:00
handlers initial commit 2020-04-13 12:18:15 +02:00
meta initial commit 2020-04-13 12:18:15 +02:00
tasks initial commit 2020-04-13 12:18:15 +02:00
templates initial commit 2020-04-13 12:18:15 +02:00
vars initial commit 2020-04-13 12:18:15 +02:00
README.md initial commit 2020-04-13 12:18:15 +02:00

README.md

Network Manager Role

Configure system connections managed by NetworkManager by templating the nmconnection files. Right now, only wireguard and wifi connection types are supported.

Requirements

The role doesn't install anything currently, so NetworkManager should already be installed, including the nmcli cli tool.

Role Variables

A description of the settable variables for this role should go here, including any variables that are in defaults/main.yml, vars/main.yml, and any variables that can/should be set via parameters to the role. Any variables that are read from other roles and/or the global scope (ie. hostvars, group vars, etc.) should be mentioned here as well.

Dependencies

A list of other roles hosted on Galaxy should go here, plus any details in regards to parameters that may need to be set for other roles, or variables that are used from other roles.

Example Playbook

- hosts: all
  roles:
    - network-manager
  vars:
    network_manager_connections:
      - id: home-wifi
        uuid: 851139a3-54b5-4736-8dc0-f04d4b9de366
	type: wifi
	interface_name: wlan0
	wifi:
	  ssid: home-wifi
	  key_mgmt: wpa-psk
	  psk: "secret wifi passphrase"
      - id: wireguard
        uuid: 3ecc827f-2dfb-4972-885b-98f6316e7d2f
	type: wireguard
	interface_name: wg0
	wireguard:
	  # generate with `wg genkey > privkey`
	  private_key: UJHMW7viOL4zEbTSW8t1tHnGzAEqHv7bIYfHeYyLsWg=
	  listen_port: 45678 # optional
	  peers:
	      # generate with `wg pubkey < privkey > pubkey`
	    - public_key: K5juPTGX3f6ZVwOh4rFYBHtMUPeJHdOWbleMo4l9Ynw=
	      endpoint: 1.2.3.4:56789 # optional
	      allowed_ips:
	        - "0.0.0.0/0"
		- "::0/0"
	      # generate with `wg genpsk > presharedkey`, optional
	      preshared_key: 9keMl5YXH/rVzdpvJx/lRsyeKVnC7bqlKljTxJ+BJs4=

License
-------

AGPL-3.0-only