Guix Channel per MastodonStartPage.

Giacomo Leidi f5408c4399 mastostart-gnu: Aggiunge crawl job alla configurazione. 3 years ago
mastostart-gnu f5408c4399 mastostart-gnu: Aggiunge crawl job alla configurazione. 3 years ago
LICENSE d6e841a314 Initial commit 3 years ago
README.md 5bbd3d214a Aggiorna README.md 3 years ago

README.md

Mastostart Guix

Mastostart Guix è un repository di software per il gestore di pacchetti GNU Guix e configurazioni di sistema per MastodonStartpage.

Installare Guix

È possibile installare Guix sulla maggior parte delle distribuzioni. Il metodo consigliato al momento è questo script che fa da wizard per l'installazione, qui per fare a mano. La wiki di Arch ha altre info interessanti.

Abilitare il channel

Mastostart Guix può essere installato come Guix channel. Per farlo, aggiungilo al tuo ~/.config/guix/channels.scm:

(cons* (channel
        (name 'mastostart)
        (url "https://git.lattuga.net/goodoldpaul/mastostart-guix"))
       %default-channels)

Configurazione

La documentazione ufficiale sulle configurazioni è qui e qui i vari modi per istanziarle in locale o remoto.

Container

I container sono meccanismi di isolamento forniti da Linux 3.19 in poi. Necessitano di meno risorse rispetto alle macchine virtuali perchè che condividono kernel e altre risorse con la macchina host.

N.B.: Attualmente, questo comando va lanciato come root, se preferite non farlo potete usare la macchina virtuale.

Per lanciare un container locale che serve la startpage sulla porta 80:

sudo `guix system container mastostart-gnu/system/mastostart.scm --network`

Macchina virtuale

Le macchine virtuali forniscono meccanismi di isolamento più efficaci dei container al prezzo di un maggior consumo di risorse.

Per lanciare una macchina virtuale locale che serve la startpage sulla porta 8080:

`guix system vm mastostart-gnu/system/mastostart.scm` -nic user,model=virtio-net-pci,hostfwd=tcp::8080-:80

Immagine Docker

Per generare un'immagine Docker che serva la pagina sulla porta 80:

guix system docker-image mastostart-gnu/system/mastostart.scm

Per generare ed eseguire l'immagine generata:

image_path="`guix system docker-image mastostart-gnu/system/mastostart.scm`"
image_id="`docker load < $image_path`"
container_id="`docker create $image_id`"
docker start $container_id

N.B.: A seconda di cosa vuoi eseguire nel container Docker, potrebbe dover essere necessario fornirgli ulteriori permessi. Per esempio, se intendi installare software tramite Guix dentro il container Docker, potresti dover passare l'opzione --privileged a docker create.