Repository configuration

docs/pacchetti-e-repository.rst

@@ -195,3 +195,45 @@ file spuri, e nel caso cancellarli a mano.
 
 Configurazione del repository
 =============================
+
+Il file ``/iso/repo/conf/distributions`` definisce le distribuzioni
+utilizzate nel repository, con snippet di configurazione come::
+
+    Origin: FUSS
+    Label: FUSS
+    Suite: jessie
+    Codename: jessie
+    Version: 8.0
+    Architectures: i386 amd64 source
+    Components: main contrib
+    Description: FUSS 8.0
+    SignWith: C00D47EF47AA6DE72DFE1033229CF7A871C7C823
+
+inoltre nello stesso file sono definite le versioni precedenti e future
+della distribuzione. Al momento attuale la configurazione riguarda fino
+alla versione 10 di Debian (codename ``buster``).
+
+Le varie distribuzioni sono raggiungibili da apt usando, in
+``/etc/apt/sources.list``::
+
+    deb http://archive.fuss.bz.it CODENAME_DISTRIBUZIONE main contrib
+
+e la chiave con la quale viene firmato il repository si può installare
+su una macchina debian o derivate eseguendo, da root::
+
+   # wget -qO - https://archive.fuss.bz.it/apt.key | apt-key add -
+
+Aggiunta di nuova distribuzione e/o nuovo repository
+----------------------------------------------------
+
+Oltre al file ``/iso/repo/conf/distributions`` per indicare la nuova
+distribuzione e/o nuovo repository, è necessario:
+
+* Creare una cartella per lo spool di incoming dei pacchetti in
+  ``/iso/incoming/<nuova distribuzione>``
+* Aggiungere la descrizione e il path relativo al punto precedente nel
+  file ``/iso/repo/conf/incoming``
+* Aggiungere allo script ``/iso/bin/post-upload`` l'esecuzione del
+  processing del nuovo path di incoming. In questo script vanno tolte
+  quelle non più usate quando è certo che non ci saranno più nuovi
+  pacchetti per una specifica distribuzione.