Commit c8966875 authored by Elena Grandi's avatar Elena Grandi
Browse files

Merge branch 'fuss-server'

parents 5d3a5b0b e16af6b9
***********
FUSS Server
***********
``fuss-server`` è uno script python che lancia un playbook ansible_ che
configura una macchina per poter funzionare come server in una rete
FUSS.
.. _ansible: https://docs.ansible.com/
fuss-server
===========
Lo script ``fuss-server`` è scritto per essere compatibile con python 2
e 3; nel momento in cui ansible passerà ad usare python 3 si potrà
eliminare la compatibilità python 2.
I vari sottocomandi corrispondono alle funzioni con lo stesso nome e
generalmente si concludono con l'``os.execvp`` di un comando di shell
per lanciare ansible; notare che questo termina l'esecuzione del
programma python, eventuale codice successivo non viene eseguito.
Playbook
========
Ansible viene chiamato con uno dei seguenti playbook, a seconda del
sottocomando usato:
``create.yml``
per configurare da zero un fuss-server.
``upgrade.yml``
per aggiornare la configurazione di un fuss-server.
``captive_portal.yml``
per applicare la configurazione aggiuntiva necessaria sui captive
portal.
``purge.yml``
per eliminare la configurazione del fuss-server.
Quest'ultimo ripristina alcuni file di configurazione dai backup, gli
altri non compiono direttamente azioni, ma richiamano ruoli dalla
directory ``roles``, in modo da poter condividere il codice, in
particolare tra ``create`` e ``upgrade``.
Pacchetti Debian
================
Il repository prevede la generazione di due pacchetti .deb,
``fuss-server`` e ``fuss-server-dependencies``; il primo contiene il
fuss-server vero e proprio, mentre il secondo è un metapacchetto che
dipende da tutti i pacchetti installati dal playbook ansible.
``fuss-server-dependencies`` non è necessario per l'uso di fuss-server,
ma è aggiunto per comodità per pre-installare (e soprattutto
pre-scaricare) tutti i pacchetti necessari.
Numeri di versione
------------------
Il pacchetto ``fuss-server`` è nativo, quindi il numero di versione è
del tipo X.Y.Z dove X è il numero di versione debian corrispondente (ad
esempio 8 per jessie, 9 per stretch, 10 per buster).
......@@ -13,6 +13,7 @@ Il presente manuale è una guida alla manutenzione ed allo sviluppo della distri
guide-progetto-fuss
pacchetti-e-repository
metapacchetti
fuss-server
Contribuisci
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment