62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
# Playbooks
|
|
|
|
Qui vengono riportati i playbook disponibili, descrizione e utilizzo.
|
|
**NB** Ci si aspetta che i playbook siano idempotenti. In caso contrario e' importante riportarlo nella documentazione corrente.
|
|
|
|
### Bootstrap
|
|
Implementa la configurazione di base di un nodo per poter essere gestito dagli altri playbook, in particolare :
|
|
- crea l'utente ansible
|
|
- registra le chiavi ssh degli utenti configurati
|
|
|
|
**Target Hosts : all**
|
|
|
|
|
|
#### Parametri
|
|
Il playbook si aspetta le seguenti variabili
|
|
```
|
|
ansible_authorized_keys:
|
|
- label : <MY LABEL>
|
|
key: <MY>
|
|
```
|
|
|
|
#### Chiamata
|
|
Per lanciare il playbook e' necessario specificare l'utente da utilizzare per connettersi ed esguire il playbook con l'opzione *-e*'.
|
|
L'opzione '*-K*' invece permette di chiedere la password dell'utente remoto
|
|
|
|
```
|
|
ansible-playbook -i inventories/<INVENTORY>.yaml playbooks/bootstrap.yaml -e 'ansible_user=<SUDO USER>' -K
|
|
```
|
|
|
|
### VPN Server
|
|
Istanzia un server Wireguard abilitando il tunneling del traffico.
|
|
|
|
**Target Hosts : wireguard_server**
|
|
|
|
#### Generazione chiavi e configurazioni dei Peer
|
|
Genera in */wg_clients/< ANSIBLE_HOSTNAME >/* i file di configurazione per i peer configurati.
|
|
|
|
**NB**
|
|
Il playbook e' a conoscenza della chiave privata del peer solo se e' stato necessario generarla durante l'esecuzione. In caso contrario viene riportata solo la chiave pubblica ed e' compito dell'utente inserire la chiave privata.
|
|
|
|
Il playbook genera le chiavi nei seguenti casi :
|
|
- nessuna chiave pubblica e' stata fornita e il peer non e' gia' configurato sul server
|
|
- Force Regeneration = True
|
|
|
|
|
|
|
|
#### Parametri
|
|
Il playbook si aspetta le seguenti variabili
|
|
```
|
|
wg_interface: wg0
|
|
wg_port: 51820
|
|
wg_server_address: 192.168.101.1/32
|
|
|
|
wg_peers:
|
|
- name: <MY LABEL>
|
|
# publicKey:
|
|
ip: "192.168.101.4/32"
|
|
allowedIPs :
|
|
- "192.168.101.0/24"
|
|
- "10.22.0.0/16"
|
|
forceRegeneration: False
|
|
``` |