Differences between revisions 1 and 20 (spanning 19 versions)
Revision 1 as of 2016-10-03 10:43:03
Size: 3801
Editor: crudo
Comment: Guida all'installazione
Revision 20 as of 2017-03-08 10:14:26
Size: 2493
Editor: crudo
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from Wiki
Line 3: Line 4:
= Linee guida: Wiki =
Line 4: Line 6:
= Wiki = Consiglio: puoi leggere il codice di altre pagine premendo il tasto `Edit`
o `More Actions:` → `Raw Text`. ;)
Line 6: Line 9:
== Installazione == == Creare una nuova pagina ==
Line 8: Line 11:
La wiki è gestita da MoinMoin 1.9 in esecuzione su FreeBSD 10.2
La seguente documentazione fa riferimento a tale
configurazione, ciononostante il setup è facilmente riproducibile.
Prima di creare una nuova pagina è necessario pensare a che nome attribuirgli.
Il nome farà parte dell'indirizzo della pagina e deve essere in formato
CamelCase: la prima lettera deve essere maiuscola (le pagine utente possono non
seguire questa regola). Se il nome contiene più parole esse devono essere
scritte unite, con la prima lettera di ogni parola maiuscola. Trovi
informazioni più dettagliate alla pagina [[WikiName]].
Line 12: Line 18:
Si danno per scontati:
 * un sistema host già in esecuzione;
 * un filesystem pronto ad ospitare jail;
 * una instanza di Nginx all'interno di una jail già configurato e in
   esecuzione.
== Scrivere una nuova pagina ==
Line 18: Line 20:
È consigliato avere uno snapshot aggiornato dell'archivio dei ports prima di
procedere.
All'inizio della pagina inserisci alcuni metadati sul formato della sintassi e
la lingua del documento.
Line 21: Line 23:
{{{#!highlight bash
zfs create /usr/local/jails/unit_moinmoin
cd /usr/local/jails/unit_moinmoin
fetch -q -o - ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/10.2-RELEASE/base.txz | tar xpf -
mkdir -p usr/ports var/ports/packages var/ports/distfiles var/ports/obj
echo "nameserver 10.1.1.1" > etc/resolv.conf
{{{
#format wiki
#language it
Line 29: Line 28:
/etc/jail.conf
{{{
exec.start = "/bin/sh /etc/rc";
exec.stop = "/bin/sh /etc/rc.shutdown";
exec.clean;
Quindi scrivi il titolo della pagina, dovrebbe più o meno rispecchiare il nome.
Il titolo va indicato con la sintassi `= Titolo della pagina =` in una riga
priva di altro contenuto.
Line 35: Line 32:
host.hostname = "$host.oikia.unit.macaomilano.org"; Le sezioni della pagina assumono una forma gerarchica in base al numero di `=`.
Una sezione di primo livello si indicherà con `== Sezione 1 ==`, una di secondo
con `=== Sezione 1.1 ===`, e via discorrendo. Trovi
[[HelpOnMoinWikiSyntax#Headings_and_table_of_contents|qui]] maggiori
informazioni.
Line 37: Line 38:
path = "/usr/local/jails/$host";
mount.fstab = "/etc/jail.fstab.d/$host.fstab";
Dividi il tuo testo in paragrafi che concludano un concetto. Separa ogni
paragrafo con una riga vuota. Inserisci inoltre una riga vuota prima e dopo aver
definito una sezione.
Line 40: Line 42:
http-proxy {
  interface = "re0";
  ip4.addr = "re0|10.1.1.3/24";
  $host = "http-proxy";
  allow.mount.devfs;
  allow.mount.procfs;
  mount.devfs;
  mount.procfs;
  enforce_statfs = 1;
}
Per favore, scrivi la pagina in locale usando un editor degno di questo nome e
imposta a 80 caratteri il limite della riga. Sono ammesse eccezioni (URL,
tabelle).
Line 51: Line 46:
unit_moinmoin {
  interface = "re0";
  ip4.addr = "re0|10.1.1.9/24";
  $host = "unit_moinmoin";
  allow.mount.devfs;
  allow.mount.procfs;
  mount.devfs;
  mount.procfs;
  enforce_statfs = 1;
}
}}}
Puoi scrivere in ''corsivo'' inserendo il testo tra una coppia di `''` o in
'''grassetto''' usando `'''`. Trovi [[HelpOnFormatting|qui]] maggiori
informazioni.
Line 63: Line 50:
/etc/jail.fstab.d/unit_moinmoin.fstab
{{{
/usr/ports /usr/local/jails/unit_moinmoin/usr/ports nullfs ro 0 0
}}}
Puoi linkare una pagina interna con la sintassi `[[NomeDellaPagina]]` oppure
con [[NomeDellaPagina|testo del link che sarà mostrato]].
Line 68: Line 53:
/usr/local/jails/unit_moinmoin/etc/rc.conf
{{{
uwsgi_enable="YES"
uwsgi_flags="-T --ini /usr/local/www/unit/uwsgi.ini"
}}}
Puoi linkare una pagina esterna cona la stessa sintassi, inserendo un URL
valido al posto del [[WikiName]]. Se inserisci un link esterno considera di
aggiungere l'opzione per aprirlo in una nuova scheda del browser. Esempio:
`[[http://www.macaomilano.org|MACAO|target="_blank"]]`. Trovi
[[HelpOnLinking|qui]] maggiori informazioni.
Line 74: Line 59:
/usr/local/jails/unit_moinmoin/etc/make.conf
{{{
CFLAGS = -O2 -pipe
MAKE_JOBS_NUMBER = 4

WRKDIRPREFIX= /var/ports/obj
DISTDIR= /var/ports/distfiles
PACKAGES= /var/ports/packages

DEFAULT_VERSIONS=python=2.7 ssl=libressl

OPTIONS_UNSET+= DEBUG DOCS EXAMPLES TESTS NLS IPV6

lang_perl5.20_UNSET += PERL_64BITINT
}}}

/usr/local/jails/http-proxy/usr/local/etc/nginx/sites-available/wiki.unit.macaomilano.org.conf
{{{
server {
  listen 80;
  server_name wiki.unit.macaomilano.org;
  return 301 https://$server_name$request_uri;
}

server {
  listen 443 ssl;
  server_name wiki.unit.macaomilano.org;

  access_log /var/log/nginx/wiki.unit.macaomilano.org-access.log;
  error_log /var/log/nginx/wiki.unit.macaomilano.org-error.log error;

  ssl on;
  ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
  ssl_prefer_server_ciphers on;
  ssl_ciphers 'EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH';
  ssl_session_cache shared:SSL:5m;
  ssl_session_timeout 5m;
  ssl_dhparam /path/to/dhparam.pem;
  ssl_certificate /path/to/unit.macaomilano.org-bundle.pem;
  ssl_certificate_key /path/to/unit.macaomilano.org.key;

  location / {
    uwsgi_pass 10.1.1.9:9000;
    include uwsgi_params;
  }
}
}}}

{{{#!highlight bash
jexec http-proxy "ln -s ln -s /usr/local/etc/nginx/sites-available/wiki.unit.macaomilano.org.conf /usr/local/etc/nginx/sites-enabled/
jexec http-proxy service nginx reload
}}}


{{{#!highlight bash
jexec unit_moinmoin csh
cd /usr/ports/www/uwsgi
make config-recursive
make install clean
cd /usr/ports/www/moinmoin
make config-recursive
make install
make MOINTYPE=WSGI MOINDEST=/usr/local/www/unit instance
exit
}}}

/usr/local/jails/unit_moinmoin/usr/local/www/unit/uwsgi.ini
{{{
[uwsgi]
socket = 10.1.1.9:9000
chmod-socket = 660

chdir = /usr/local/www/unit
wsgi-file = moin.wsgi

master
workers = 2
max-requests = 200
harakiri = 30
die-on-term
}}}

{{{#!highlight bash
jexec unit_moinmoin "service uwsgi start"
}}}
Per tutto il resto ti invito a leggere la
[[HelpOnMoinWikiSyntax|guida ufficiale alla sintassi]]
e la [[HelpContents|guida completa di MoinMoin]] :D

Linee guida: Wiki

Consiglio: puoi leggere il codice di altre pagine premendo il tasto Edit o More Actions:Raw Text. ;)

Creare una nuova pagina

Prima di creare una nuova pagina è necessario pensare a che nome attribuirgli. Il nome farà parte dell'indirizzo della pagina e deve essere in formato CamelCase: la prima lettera deve essere maiuscola (le pagine utente possono non seguire questa regola). Se il nome contiene più parole esse devono essere scritte unite, con la prima lettera di ogni parola maiuscola. Trovi informazioni più dettagliate alla pagina WikiName.

Scrivere una nuova pagina

All'inizio della pagina inserisci alcuni metadati sul formato della sintassi e la lingua del documento.

#format wiki
#language it

Quindi scrivi il titolo della pagina, dovrebbe più o meno rispecchiare il nome. Il titolo va indicato con la sintassi = Titolo della pagina = in una riga priva di altro contenuto.

Le sezioni della pagina assumono una forma gerarchica in base al numero di =. Una sezione di primo livello si indicherà con == Sezione 1 ==, una di secondo con === Sezione 1.1 ===, e via discorrendo. Trovi qui maggiori informazioni.

Dividi il tuo testo in paragrafi che concludano un concetto. Separa ogni paragrafo con una riga vuota. Inserisci inoltre una riga vuota prima e dopo aver definito una sezione.

Per favore, scrivi la pagina in locale usando un editor degno di questo nome e imposta a 80 caratteri il limite della riga. Sono ammesse eccezioni (URL, tabelle).

Puoi scrivere in corsivo inserendo il testo tra una coppia di '' o in grassetto usando '''. Trovi qui maggiori informazioni.

Puoi linkare una pagina interna con la sintassi [[NomeDellaPagina]] oppure con testo del link che sarà mostrato.

Puoi linkare una pagina esterna cona la stessa sintassi, inserendo un URL valido al posto del WikiName. Se inserisci un link esterno considera di aggiungere l'opzione per aprirlo in una nuova scheda del browser. Esempio: [[http://www.macaomilano.org|MACAO|target="_blank"]]. Trovi qui maggiori informazioni.

Per tutto il resto ti invito a leggere la guida ufficiale alla sintassi e la guida completa di MoinMoin :D

WikiGuideLines (last edited 2017-09-15 09:35:52 by crudo)