Il tour di Ansible, parte 4: Nextcloud – Collabora, push, database sull'host e occ, ruolo per ruolo

Parte 4 del tour di Ansible: perché esiste ogni pezzo di Nextcloud, come viene distribuito su K3s, configurato con occ e aggiornato in sicurezza.

Illustrazione per la serie del tour di Ansible

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski

Parte 4 del tour di Ansible. Dopo il blog nella parte 3, ecco la seconda applicazione: Nextcloud. La serie descrive la release v3.3.0, con le modifiche successive aggiunte come aggiornamenti. Ciò che coincide con il blog viene solo accennato; l’attenzione è su ciò che è diverso.

Nextcloud è un cloud per file: file, calendari, contatti, cartelle di gruppo e – con Collabora – documenti modificati insieme nel browser. Due dei tre server lo fanno girare, per gruppi di dimensioni molto diverse, con lo stesso codice e valori diversi nell’inventario. Il lavoro è diviso tra next_mariadb e next_redis (database e cache sull’host), next_k3s_deploy (Nextcloud, Collabora e il servizio push come oggetti Kubernetes), next_config (le impostazioni di Nextcloud) e nextcloud_verify, più il playbook di aggiornamento.

Indice

🏗️ Cosa gira, e perché

Una richiesta fa lo stesso percorso che sul blog: ingress, sidecar nginx, PHP-FPM in un unico pod. Tutto ciò che sta intorno è diverso:

  • Due directory separate sull’host per l’applicazione e per i dati degli utenti. Una nuova immagine sostituisce i file dell’applicazione, i file degli utenti restano dove sono e vengono salvati in backup in modo indipendente.
  • MariaDB e Redis sull’host, non nel cluster. Il database è il componente più pesante e più prezioso; sull’host ottiene la sandbox systemd completa, un proprio dominio SELinux e nessuno strato di volumi tra dati e disco. Redis gestisce i lock dei file: due client di sincronizzazione che salvano lo stesso file nello stesso istante non devono corromperlo.
  • Collabora Online, una suite per ufficio che gira sul server e viene visualizzata nel browser. Nextcloud e Collabora parlano via WOPI: l’editor chiede al file server un file e di salvarne una versione, firmando con una chiave.
  • notify_push tiene aperta una connessione WebSocket con i client e segnala le modifiche. Senza di lui ogni client chiede ogni trenta secondi.
  • Un CronJob esegue i task in background ogni cinque minuti; le anteprime vengono generate in anticipo da un’app invece che al primo clic.

🗄️ next_mariadb e next_redis: servizi sull’host

MariaDB riceve una sandbox systemd prima di partire per la prima volta. Per questo il ruolo ricarica systemd direttamente e non tramite un handler: un handler girerebbe alla fine del play, e su un server nuovo il database partirebbe prima senza sandbox. Questa sandbox è stata anche il teatro del bug più importante di settembre: NoNewPrivileges impediva a MariaDB di entrare nel suo dominio SELinux, e il database è girato senza confinamento per cinque settimane nonostante SELinux fosse in enforcing. Il deep dive su MariaDB racconta quella storia. Dal 16 ottobre 2026 MariaDB ha la propria /tmp in RAM; non va combinata con PrivateTmp=yes, altrimenti vince in silenzio la directory su disco.

Due storie più piccole mostrano quanto possano essere silenziosi i bug. Lo slow query log ha bisogno di una directory che MariaDB non crea da sola; senza di essa il database girava con lo slow log spento in silenzio – una diagnosi che sembrava accesa e non raccoglieva niente. E all’utente dell’exporter veniva riassegnato il privilegio a ogni esecuzione, perché MariaDB riporta REPLICATION CLIENT con il suo nome più recente BINLOG MONITOR e il ruolo chiedeva quello vecchio.

L’utente del database di Nextcloud può fare login solo dalla rete dei pod. Anche con un errore nel firewall, MariaDB rifiuterebbe questo login da qualsiasi altro posto.

Redis ascolta sull’indirizzo dell’host, così i pod possono raggiungerlo. All’inizio c’era una sola regola del firewall tra internet e Redis – e che un livello di protezione possa fallire in silenzio qui non è teoria: fail2ban una volta è rimasto morto sul blog per due giorni senza che nessuno se ne accorgesse. Redis ha quindi una password, che arriva a Nextcloud tramite un secret. Dal 26 ottobre 2026 Redis arriva dal module stream AppStream redis:7 invece che dal 6.2 predefinito di EL9.

Il punto: un database è facile da far partire e difficile da confinare come si deve. Dopo ogni hardening, ps -eZ mostra se gira ancora nel suo dominio.

🚀 next_k3s_deploy: Nextcloud, Collabora e push

La stessa struttura del blog, con una differenza di comportamento: aspetta solo quando un oggetto è cambiato davvero. Come fa un pod a raggiungere un database fuori dal cluster? Con un service senza selettore di pod e un oggetto Endpoints compilato a mano che punta all’host. Per Nextcloud, mariadb e redis diventano così nomi qualsiasi nel cluster.

Il pod di Nextcloud si installa da solo a partire dalle variabili d’ambiente al primo avvio contro un database vuoto. Importante in esercizio: questi valori vengono letti solo quella volta. Dopo, le credenziali stanno in config.php, e cambiare solo il secret non cambia niente. Per una nuova versione major l’entrypoint esegue l’upgrade prima che parta PHP-FPM; può durare minuti, quindi la startup probe concede dieci minuti prima che intervenga la liveness probe. Per upload fino a 2 GB tre numeri devono combaciare: il limite di PHP, quello del sidecar nginx e quello dell’ingress. Il template lo dice esattamente dove i valori vengono impostati.

Le impostazioni proprie arrivano come custom.config.php da una ConfigMap, accanto al config.php di Nextcloud: lingua, durata della sessione, cache e locking, anteprime, il proxy fidato. I file di configurazione successivi vincono, quindi un valore impostato qui non può derivare tramite l’interfaccia web. La cache del bytecode ha 256 MB e spazio per 20.000 file: con tutte le sue app un’installazione ha fino a 17.800 file PHP, e il vecchio limite di 10.000 faceva ricompilare una parte di essi a ogni richiesta.

Dal 26 ottobre 2026 il pod di Nextcloud fa un rollout senza downtime finché l’immagine resta la stessa – per modifiche di configurazione e rebuild dello stesso tag. Quando l’immagine cambia resta su Recreate, perché in quel caso l’entrypoint copia il nuovo codice ed esegue l’upgrade; nel frattempo nessun vecchio pod deve servire dalla stessa directory. Il ruolo lo decide a ogni esecuzione e poi torna al rolling update.

Collabora firma ogni richiesta WOPI con una chiave che Nextcloud verifica. L’immagine attuale non crea più questa chiave da sola; girava senza, e Nextcloud non poteva verificare che le richieste venissero davvero da Collabora. Il ruolo la crea una volta e la passa da openssl direttamente in un secret – la chiave privata non tocca mai il disco. Collabora è l’unico container che non rinuncia a tutte le capability: costruisce una propria sandbox per ogni documento e per farlo ha bisogno di diritti che una scelta tirata a indovinare dalla documentazione potrebbe rompere in un modo che si vede solo quando un utente apre un file. Le sue probe chiedono una pagina da due byte invece del documento discovery da 43 KB: il kubelet chiude la connessione dopo 10 KB, e Collabora registrava ogni chiusura del genere come due errori. Sul server più grande Collabora può usare sei core su otto dal 26 ottobre 2026; mentre generava anteprime sbatteva contro il vecchio limite di quattro.

La regola di rete su Nextcloud ha un obiettivo diverso rispetto al blog. Collabora elabora documenti arbitrari caricati dagli utenti – un punto d’ingresso più plausibile della maggior parte del codice PHP – e non ha alcun motivo di parlare mai con MariaDB o Redis. La regola quindi gli permette solo richieste dall’ingress e da Nextcloud, il DNS e le callback WOPI sulla porta 443 dell’host, esplicitamente non 3306 e 6379 sullo stesso indirizzo.

Ingress e login. La stessa struttura di master e minion del blog, con un minion per /push/ che porta gli header WebSocket. Il suo nome conta: il controller ordina le location regex per nome dell’ingress, e il nome sbagliato ha fatto rispondere per prima la route catch-all di Nextcloud durante il primo rollout. Il 26 ottobre 2026 è anche venuto fuori che il rate limit conosceva solo /login – ma Nextcloud invia il suo form a /index.php/login. Da luglio né il rate limit né il filtro di fail2ban avevano visto un solo login reale; ora entrambi conoscono entrambi i percorsi.

App e push. Per le app l’inventario elenca solo le deviazioni volute: quali restano forzatamente spente e quali devono essere accese. Se dopo un upgrade major un’app non ha ancora una versione compatibile, resta spenta, e il ruolo riporta esattamente quale – invece di interrompersi al primo errore. Il binario di notify_push arriva con un’app; la sua versione è quindi un’annotation nel template del pod, così un aggiornamento dell’app rifà il rollout del pod e binario e app non possono mai andare fuori sincrono.

Il punto: un percorso che credi sia quello della pagina di login non è necessariamente quello che usa l’applicazione. Testa le regole di protezione con quello che il browser invia davvero.

⚙️ next_config: leggere, confrontare, impostare

Le impostazioni di Nextcloud si impostano con occ, seguendo uno schema: leggere il valore attuale, confrontarlo con quello desiderato, scrivere solo se non coincidono. Un’esecuzione senza modifiche non riporta niente, e un valore che qualcuno ha cambiato nell’interfaccia web viene ripristinato e compare come modifica. Così il controllo del drift ha senso anche per le impostazioni dell’applicazione, non solo per i file. Le impostazioni della posta prima venivano riscritte tutte e nove a ogni esecuzione e riportavano comunque “ok” – una password SMTP cambiata non si vedeva mai.

Il file più istruttivo del ruolo è la policy delle password: almeno 12 caratteri e un controllo contro le password trapelate note, per il quale dal server escono solo i primi cinque caratteri dell’hash. Quando l’app è stata attivata su un server, ogni utente con una password più vecchia di 300 giorni è rimasto chiuso fuori, admin compreso. Un’impostazione del vecchio server era rimasta inosservata nel database finché non è stata attivata l’app che la legge. Da allora il ruolo imposta esplicitamente ogni chiave della policy, comprese quelle che devono essere spente.

Il punto: prima di attivare un’app, leggi quale configurazione ha già. Dopo una migrazione spesso c’è più di quanto pensi.

🔄 nextcloud-update.yml: un aggiornamento con cura

Un cloud per file da cui dipendono delle persone merita un aggiornamento attento. Il playbook si rifiuta di girare senza --limit e su un’istanza che non è sana – in maintenance mode o con un upgrade del database in sospeso. Poi riavvia solo i deployment la cui immagine è stata ricostruita upstream, esegue occ upgrade e gli aggiornamenti delle app, e dopo riavvia il pod una seconda volta. Il motivo: Nextcloud gira con opcache.validate_timestamps=0, quindi PHP non controlla mai se un file è cambiato. Senza quel riavvio continuerebbe a girare il vecchio codice, correzioni di sicurezza comprese.

Se qualcosa va storto, la parte rescue mostra stato, pod e la fine di nextcloud.log e prende una decisione prudente: esce dalla maintenance mode solo se l’upgrade in sé è stato completato. Altrimenti gli utenti finirebbero su un’istanza aggiornata a metà.

Il punto: una cache che non ricontrolla mai i file è veloce e ha bisogno di un riavvio dopo ogni aggiornamento del codice. Questo va nella procedura di aggiornamento, non nella memoria di qualcuno.

🛠️ In esercizio

  • Aggiornamenti: ansible-playbook nextcloud-update.yml --limit <host>, prima con --check. Una nuova versione major è un nuovo tag dell’immagine in versions.yml e un’esecuzione completa – sempre una versione major alla volta, con release notes e prima uno snapshot.
  • “Non è stato possibile caricare Office”, un nuovo tentativo funziona: un breve intoppo tra browser, Collabora e Nextcloud. Se succede spesso, Collabora ha bisogno di più processi pre-avviati o di più memoria.
  • Maintenance mode dopo un aggiornamento fallito: prima occ status; se c’è un upgrade in sospeso, esegui occ upgrade e leggine l’output, solo dopo spegni la maintenance mode.
  • Utenti chiusi fuori dalla policy delle password: occ config:app:get password_policy expiration deve essere 0.
  • Il disco si riempie: l’allarme arriva all'80 percento. Il cestino conserva 180 giorni; le anteprime si possono rigenerare e ripulire con occ preview:cleanup, mai con rm.

🎯 Le lezioni della parte 4

  • Ciò che è prezioso va sull’host, ciò che è sostituibile nel cluster – e un service senza selettore dà ai servizi dell’host un nome nel cluster.
  • I valori della prima installazione vengono letti una volta sola; dopo vale config.php.
  • Una regola di rete segue il punto d’ingresso più probabile, qui Collabora.
  • Leggere, confrontare, impostare – anche per le impostazioni dell’applicazione, così il controllo del drift le vede.
  • Prima di attivare un’app, leggi la sua configurazione esistente.

🧭 Dove va il tour adesso

Con la parte 4 sono coperte entrambe le applicazioni. La parte 5 raccoglie tutti i ruoli di sicurezza in un unico posto, la parte 6 il monitoraggio. La tecnologia alla base di questa parte è spiegata nel deep dive su Nextcloud.

Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli