Questo repository contiene la configurazione Infrastructure as Code (IaC) utilizzata per gestire e mantenere allineate diverse macchine personali tramite Ansible.

L'obiettivo è avere una singola fonte di verità per:

configurazione delle macchine
pacchetti installati
servizi di sistema
configurazioni utente (dotfiles)

Il repository consente di gestire più sistemi operativi e profili macchina mantenendo una struttura modulare, riproducibile e idempotente.

Architettura del progetto

infra/
├── ansible/
│   ├── ansible.cfg
│   ├── site.yml
│   ├── inventory/
│   │   ├── hosts.yml
│   │   ├── group_vars/
│   │   └── host_vars/
│   ├── templates/
│   └── roles/
│
├── dotfiles/
│   ├── common/
│   ├── desktop/
│   ├── server/
│   ├── workstation/
│   ├── ikaros/
│   └── nymph/
│
├── scripts/
├── secrets/
└── README.md

Il repository è diviso in due componenti principali:

Componente	Scopo
ansible	provisioning e configurazione macchine
dotfiles	configurazioni utente versionate

Macchine gestite

Il repository modella attualmente tre tipologie di profilo.

Nota sullo stato attuale del playbook principale:

ansible/site.yml applica oggi in automatico il profilo desktop su host Void Linux
ansible/site.yml applica anche il profilo ubuntu_workstation con setup apt, systemd, dotfiles workstation, firewall UFW e integrazione GNOME
ansible/site.yml applica anche il profilo ubuntu_server con baseline apt, systemd, dotfiles server e firewall UFW

Desktop

Sistema operativo:

Void Linux

Sessioni desktop:

ikaros: i3
nymph: i3 + Hyprland con scelta sessione a login

Macchine:

ikaros
nymph

Queste macchine condividono la stessa configurazione base desktop e vengono mantenute allineate tramite Ansible.

Lo stato attuale del profilo desktop include, tra le altre cose:

dotfiles comuni e desktop
sessione i3 su tutti i desktop Void e sessione Hyprland opzionale su nymph
emptty con scelta sessione a login su nymph e default host-specific sugli altri desktop
pacchetti Void Linux e servizi runit
Flatpak con remoto Flathub
GNOME Keyring e bootstrap della posta via script dedicato

Workstation

Sistema operativo:

Ubuntu LTS

Desktop environment:

GNOME

Macchina:

deadalus

Questo profilo è pensato per sviluppo e lavoro.

Il profilo workstation Ubuntu e agganciato al playbook principale e include gia una base operativa per uso desktop e sviluppo.

Lo stato attuale del profilo workstation include:

installazione pacchetti base Ubuntu via apt
installazione e configurazione di Docker dal repository ufficiale
gestione dei dotfiles workstation e rendering dei template dedicati
installazione di Google Chrome e pacchetti Snap workstation
gestione delle estensioni GNOME da website e dello stato desiderato delle estensioni abilitate
attivazione del firewall UFW

Server

Sistema operativo:

Ubuntu LTS

Configurazione:

nessun ambiente grafico

Macchina:

prometheus

Profilo orientato a servizi server e gestione di dotfiles dedicati.

Lo stato attuale del profilo server include:

installazione pacchetti base Ubuntu via apt
installazione e configurazione di Docker dal repository ufficiale
abilitazione dei servizi systemd dichiarati in inventory/group vars
copia dei dotfiles server e rendering dei template server
attivazione del firewall UFW con regola SSH esplicita

Utente del profilo server:

il profilo usa server_username, server_user_group e server_user_home definiti in ansible/inventory/group_vars/server.yml
per default server_username eredita username, ma puo essere sovrascritto per tutti gli host server via inventory oppure a runtime con extra vars
esempio override da CLI:

ansible-playbook ansible/site.yml --limit prometheus -e server_username=myuser

se necessario puoi passare anche:

ansible-playbook ansible/site.yml --limit prometheus -e server_username=myuser -e server_user_group=mygroup -e server_user_home=/srv/myuser

Composizione della configurazione

La configurazione finale di una macchina è ottenuta combinando più livelli.

common configuration
+ OS configuration
+ profile configuration
+ host overrides

Esempio per ikaros:

common + void + desktop + ikaros

Esempio per nymph:

common + void + desktop + nymph

Questo approccio consente di:

mantenere configurazioni condivise
applicare override specifici per host
evitare duplicazioni

Ruoli Ansible

I principali ruoli attualmente presenti sono:

Role	Descrizione
base	configurazione base comune
packages_void	installazione pacchetti su Void
packages_ubuntu	installazione pacchetti su Ubuntu
services_runit	gestione servizi runit
services_systemd	gestione servizi systemd
profile_desktop_common	bootstrap desktop Void condiviso
profile_desktop_i3	sessione desktop i3
profile_desktop_hyprland	sessione desktop Hyprland
profile_desktop_host	override desktop specifici per host
profile_workstation_gnome	configurazione workstation GNOME
profile_server	configurazione server
dotfiles_common	distribuzione dotfiles comuni
dotfiles	distribuzione configurazioni utente

Stato attuale del playbook principale

Il playbook ansible/site.yml e attualmente composto da quattro blocchi:

all  -> dotfiles_common
void -> packages_void + services_runit + profile_desktop_common + profile_desktop_i3 + profile_desktop_hyprland + profile_desktop_host
ubuntu_workstation -> packages_ubuntu + services_systemd + profile_workstation_gnome
ubuntu_server -> packages_ubuntu + services_systemd + profile_server

Questo significa che, allo stato attuale:

i desktop Void (ikaros, nymph) restano il target operativo piu completo
la workstation Ubuntu (deadalus) e gestita con pacchetti, servizi, dotfiles, estensioni GNOME e firewall
il server Ubuntu (prometheus) e gestito con pacchetti, servizi, dotfiles server e firewall

Dotfiles

La directory dotfiles/ contiene le configurazioni utente versionate.

dotfiles/
├── common
├── desktop
├── server
├── workstation
├── ikaros
└── nymph

Le configurazioni sono applicate tramite Ansible e organizzate per livelli:

Livello	Scopo
common	configurazioni condivise
profile	configurazioni per tipo macchina
host	override specifici

Requisiti

Per utilizzare il repository sono necessari:

Python 3
Ansible
ansible-lint
yamllint
shellcheck
collection community.general
accesso locale o SSH alle macchine target, in base a come e definito l'inventory

Installazione base:

python3 -m pip install ansible ansible-lint yamllint shellcheck-py
ansible-galaxy collection install community.general

Gestione segreti:

il repository supporta il caricamento opzionale di secrets/vault.yml
secrets/vault.yml.example funge da template/esempio
se secrets/vault.yml non e presente, il playbook continua comunque senza caricare variabili locali opzionali

Utilizzo

Eseguire il playbook principale:

ansible-playbook ansible/site.yml

Allo stato attuale questo comando:

distribuisce i dotfiles comuni a tutti gli host
per gli host Void applica bootstrap desktop condiviso, sessioni i3/Hyprland e override specifici per host
per gli host ubuntu_workstation applica pacchetti Ubuntu, servizi systemd, profilo workstation GNOME, UFW, dotfiles, Snap e template dedicati
per gli host ubuntu_server applica pacchetti Ubuntu, servizi systemd, profilo server, UFW, dotfiles e template dedicati
non riavvia automaticamente emptty; le modifiche al display manager vanno applicate manualmente da SSH o da una TTY separata
carica secrets/vault.yml solo se presente

Per validare prima di applicare:

ansible-playbook ansible/site.yml --syntax-check
ansible-playbook ansible/site.yml --limit ikaros --check --diff
ansible-playbook ansible/site.yml --limit nymph --check --diff
ansible-playbook ansible/site.yml --limit deadalus --check --diff
ansible-playbook ansible/site.yml --limit prometheus --check --diff
ansible-lint ansible/site.yml
ansible-lint ansible/roles
yamllint ansible/

Per testare un override dell'utente server senza modificare l'inventory:

ansible-playbook ansible/site.yml --limit prometheus --check --diff -e server_username=myuser

Per validazioni piu mirate:

ansible-playbook ansible/site.yml --limit <host> --tags <tag1>,<tag2> --check --diff
ansible-playbook ansible/site.yml --limit <host> --start-at-task "<task name>" --check --diff
ansible-lint ansible/roles/<role>
yamllint ansible/path/to/file.yml

Bootstrap di una nuova macchina

Una nuova macchina può essere inizializzata con i seguenti passaggi:

git clone <repo>
cd <repo-dir>
ansible-galaxy collection install community.general
ansible-playbook ansible/site.yml

Dopo l'esecuzione del playbook la macchina verra configurata secondo il profilo definito e i ruoli attualmente orchestrati.

Per il flusso mail desktop esiste inoltre uno script dedicato:

scripts/bootstrap_mail.sh

Lo script si occupa del bootstrap dei secret nel keyring, del primo sync con mbsync e dell'inizializzazione di mu usando la configurazione mail generata dai template.

Se modifichi questo script, valida almeno con:

sh -n scripts/bootstrap_mail.sh
shellcheck scripts/bootstrap_mail.sh

Filosofia del progetto

Il repository segue alcuni principi chiave:

Infrastructure as Code
configurazione dichiarativa
idempotenza
ambienti riproducibili
separazione tra configurazione sistema e configurazione utente

Questo consente di ricreare qualsiasi macchina partendo esclusivamente dal repository.

Roadmap

Possibili evoluzioni future:

hardening sicurezza server
configurazione backup
testing automatico playbook
integrazione CI
supporto ad altre distribuzioni Linux

Licenza

Questo progetto è distribuito sotto licenza LGPL-3.0.

Languages

Emacs Lisp 46.3%

Shell 33.9%

Scheme 6.7%

Jinja 5.5%

PowerShell 4.9%

Other 2.7%