Infra — Personal Infrastructure as Code

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/
│   └── roles/
│
├── dotfiles/
│   ├── common/
│   ├── desktop/
│   ├── 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
• i profili workstation e server sono gia presenti in inventory e nei ruoli, ma non sono ancora inclusi nel playbook principale

Desktop

Sistema operativo:

• Void Linux

Window manager:

• i3

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 e servizi desktop correlati
• 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 modello e la struttura dei ruoli sono presenti, ma l'orchestrazione automatica tramite ansible/site.yml verra completata in una fase successiva.

---

Server

Sistema operativo:

• Ubuntu LTS

Configurazione:

• nessun ambiente grafico

Macchina:

• prometheus

Profilo minimale orientato a servizi server.

Anche questo profilo e gia rappresentato in inventory e nei ruoli, ma non e ancora agganciato al playbook principale.

---

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_i3	configurazione desktop i3
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 due blocchi:

all  -> dotfiles_common
void -> packages_void + services_runit + profile_desktop_i3

Questo significa che, allo stato attuale:

• i desktop Void (ikaros, nymph) sono il target operativo principale
• inventory, gruppi e ruoli per workstation Ubuntu e server Ubuntu restano nel repository come base per l'estensione futura

Dotfiles

La directory dotfiles/ contiene le configurazioni utente versionate.

dotfiles/
├── common
├── desktop
├── 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
• collection community.general
• accesso locale o SSH alle macchine target, in base a come e definito l'inventory

Installazione base:

pip install ansible
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 pacchetti, servizi runit e profilo desktop i3
• 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

---

Bootstrap di una nuova macchina

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

git clone <repo>
cd infra
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.

---

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:

• completamento dell'orchestrazione per workstation Ubuntu e server Ubuntu
• hardening sicurezza server
• configurazione backup
• testing automatico playbook
• integrazione CI
• supporto ad altre distribuzioni Linux

---

Licenza

Questo progetto è distribuito sotto licenza LGPL-3.0.