~/magostinelli - fediverso

Forgejo con Docker: Git self-hosted senza fronzoli

Unknown — Fri, 11 Jul 2025 00:00:00 +0000

Da tempo utilizzo Git per gestire i miei progetti personali, sia software che di configurazione. Per anni mi sono affidato al pc di qualcunaltro (es: Gitlab o GitHub), ma la dipendenza da un servizio centralizzato, per quanto comodo, inizia a starmi stretta. Così ho cercato una soluzione più allineata alla mia filosofia: Forgejo, un fork comunitario di Gitea, leggero e facilmente self-hostabile.

services: forgejo: image: codeberg.org/forgejo/forgejo:latest container_name: forgejo restart: always environment: - USER_UID=1000 - USER_GID=1000 volumes: - ./data:/data - /etc/timezone:/etc/timezone:ro - /etc/localtime:/etc/localtime:ro - ./robots.txt:/data/gitea/public/robots.txt:ro expose: - "3000" networks: - forgejo_net networks: forgejo_net: driver: bridge </code></pre>
/etc/nginx/sites-available/forgejo.conf server { listen 80; server_name git.miodominio.it; return 301 https://$host$request_uri; } server { listen 443 ssl; server_name git.miodominio.it; ssl_certificate /etc/letsencrypt/live/git.miodominio.it/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/git.miodominio.it/privkey.pem; location / { proxy_pass http://localhost:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } </code></pre> Dopo aver creato il file, attivare con:
ln -s /etc/nginx/sites-available/forgejo.conf /etc/nginx/sites-enabled/ nginx -t && systemctl reload nginx </code></pre>
</a> Backup automatico</h2>
Il backup rappresenta un step fondamentale del nostro setup, conviene implementarne subito uno all'avvio del servizio, cosi non ce ne dimenticvheremo e terremo i nostri dati al sicuro. Ricordiamoci che qui salveremo il risultato di diverse ore di programmazione, studio e prove!
I nostri dati si trovano nel volume data di cui sopra, quindi sarà sufficiente salvare il docker file e la directory data. Io consiglio di usare #borg ma potete usare il softwsre che preferite, trovo particolarmente utile aggiungere questa nuova directory alle procedure di salvataggio che sicuremante avrete già per tutto il resto. (se non le avete potete anche smettere di leggere questo blog, tornate quando ne avrete implementata una).

</a> Configurazioni iniziali</h2>
A questo punto, dopo l'installazione, non ci resta che accedere via web al nostro software e fare le prime configurazioni. È possibile creare utenti, organizzazioni, concedere permessi e creare tutti i repository che si desiderano.
Ciascun progetto può essere impostato ad accesso privatp o pubblico.
In questo modo sarà semplicissimo collaborare in più persone allo stesso progetto, tenendo traccia delle varie modifiche.
Infine è anche possibile importare direttamente altri repository git.
</a> Runner e Action</h2>
Forgejo, essendo un fork di Gitea, supporta un sistema di CI/CD integrato chiamato Actions, simile a GitHub Actions, e permette di eseguire job di build o deploy tramite runner personalizzati.
Io stesso ne faccio uso, è uno dei motivi per cui mi sto trovando benissimo con forgejo! Ho varie configurazione a seconda del progetto ospitato, ma essenzialmente queste si occupano di effettuare il "deploy" del codice, cioé copiano a destinazione (server di sviluppo o di produzione a seconda dei casi), il codice modificato, cosi che sia pronto all'uso. In questo modo, grazie alla history di git, sarà sempre possibile tornare indietro, nonché tenere traccia delle modifiche nel tempo.
</a> Come funziona</h3>
Le Actions sono definite da file YAML nei repository (.forgejo/workflows/), e possono contenere job con step eseguiti su runner registrati.
I runner sono agent installati su macchine (stessa VPS o remote), che si collegano al server Forgejo e attendono job da eseguire.
Una volta definita la condizione scatenante (es: commit su ramo main, rilascio di una nuova versione, ecc) partirà il worksflow che abbiamo definito, con la possibilità di verificarne lo stato di esecuzione in tempo reale. Infine è anche possibile andare a vedere i log delle esecuzione precedenti.
All'interno di una action si possono usare #secret e #variabili, in modo da poter riusare il codice della action e allo stesso tempo mantenere al sicuro le credenziali.
export RUNNER_VERSION=$(curl -X 'GET' https://data.forgejo.org/api/v1/repos/forgejo/runner/releases/latest | jq .name -r | cut -c 2-) wget -O forgejo-runner https://code.forgejo.org/forgejo/runner/releases/download/v${RUNNER_VERSION}/forgejo-runner-${RUNNER_VERSION}-linux-amd64 chmod +x forgejo-runner sudo mv forgejo-runner /usr/local/bin/forgejo-runner sudo useradd -m -s /bin/bash forgejo-runner sudo usermod -aG docker forgejo-runner </code></pre> Rechiamoci sull'interfaccia web di Forgejo: Forgejo > Repository > Settings > Actions > Runners > "Generate new token"
sudo -i -u forgejo-runner forgejo-runner register </code></pre>
sudo echo " [Unit] Description=Forgejo Act Runner After=network.target docker.service Requires=docker.service [Service] User=forgejo-runner Group=forgejo-runner ExecStart=/usr/local/bin/forgejo-runner daemon Restart=always WorkingDirectory=/home/forgejo-runner [Install] WantedBy=multi-user.target" > /etc/systemd/system/forgejo-runner.service sudo systemctl daemon-reload sudo systemctl enable forgejo-runner sudo systemctl start forgejo-runner systemctl status forgejo-runner </code></pre>

Repository del proprio codice, diviso come si preferisce: singoli progetti, organizzazioni, ecc.</li>
Possibilità di creare utenti per collaboratori/amici con controllo sugli accessi/permessi.</li>
Automatizzo test, build, deploy senza dipendere da servizi esterni.</li>
Nessuna dipendenza da fornitori terzi e nessun limite di spazio, esecuzioni, personalizzazioni.</li>
Versionamento del codice, e nel caso di ci/cd garanzia di riproducibilità</li>
Pocchissime risorse necessarie lato server</li>
Vuoi mettere quanto è figo avere il proprio servizio di versionamento?</li> </ul>
</a> Conclusioni</h2>
Forgejo è una soluzione Git solida, coerente con un approccio decentralizzato. Semplice da gestire, veloce da installare, e adatta anche per chi – come me – preferisce sapere dove stanno i propri dati. Per ora lo utilizzo solo per progetti personali, ma potrei iniziare a usarlo anche per collaborazioni future.
Non vi resta che provarlo, fatemi sapere le vostre impressioni con un commento nel #fediverso su questo articolo.

Writefreely: il blog della semplicità

Unknown — Sun, 15 Sep 2024 00:00:00 +0000

Questo #blog è realizzato con il software #writefreely, la più semplice piattaforma per scrivere contenuti permanenti sul web. 
</a> Caratteristiche</h2>
Si tratta di un software minimalista con cui creare un Blog, o anche un'intera comunità di più blog.
Tra le funzionalità, abbiamo l'autosaving, un editor lineare, senza distrazioni, con il supporto di #markup language. Quella che può sembrare una limitazione, invece è un vantaggio: ci si concentra sul contenuto, e non sull'apparenza.
Ci sono sia il supporto per il feed rss che la federazione con il #fediverso. 
</a> Gestione Immagini</h2>
Dopo averlo provato, l'unica cose di cui sentivo la mancanza era una gestione delle #immagini, ma ho risolto in maniera molto semplice e utile, vi lascio all'articolo che avevo scritto a tal proposito (basterà cliccare sul tag #immagini).
##Personalizzazione E' possibile configurarlo per gestire più blog o uno soltanto (il sito sui cui vi trovato è in modalità mono).

Ciascun blog, può essere configurato i 3 modalità:

Pubblico: tutti leggono i vostri articoli.</li>
Privato: accessibile solo agli utenti registrati</li>
Protetto da password: unica per tutti per poter leggere</li> </ol>
Riguardo al punto 1, starà poi a voi decidere se renderlo indicizzabile dai motori di ricerca oppure no, semplicemente configurando il file #robots.txt
Esistono 3 modalità di visualizzazione dei post:

Blog: vengono mostrate le data degli articoli che saranno visualizzati dal più recente.</li>
Novel: nessuna data degli articoli, ordinamento dal primo post in poi</li>
Notebook: nessuna data degli articoli, ordinamento dal post più recente.</li> </ol>

Infine è disponibile un campo per la firma da personalizzare, questo "pezzetto" di testo, o codice, sarà presente in calce a tutti gli articoli.
</a> Conclusioni</h2>
Personalmente trovo sia davvero piacevole aprire la schermata di nuovo articolo e trovare un schermo pulito, vuoto, in cui concentrarsi sulla scrittura e quindi sul contenuto, less is more!
Ho scelto questo software perché non avevo bisogno di fare chissà quale cose strabilianti, ma appunto la necessità era quella di scrivere qualcosa utile per gli altri, ma anche per me (scrivere mi rilassa).
Costa aspettate a provarlo? Per chi non si vuol sbattere (o non ha dove farlo) nell'installazione, consiglio questo sito dove potete aprire il vostro blog writefreely: https://noblogo.org

Writefreely e uso delle immagini

Unknown — Thu, 07 Dec 2023 00:00:00 +0000

Quando ho deciso di riaprire un blog, ho optato per il software #writefreely, per due buone ragioni: la prima per la sua semplicità, la seconda perché si integra con il #fediverso (#actvitypub).
Una delle cont indicazioni della sua semplicità è il suo limite con le immagini, infatti non supporta, nativamente, il caricamento delle immagini, cosa che trovo un po' scomoda per un blog.
Quindi mi sono messo a pensare cercando di fare necessità virtù. Dato che ho un mio #server personale (dove è ospitato anche questo blog), mi è venuto naturale creare un nuovo #virtualhost su #apache (il webserver che uso). In questo modo posso caricare tutte le immagini che voglio senza limiti. Alla soluzione mancava un ultima cosa, ovvero come gestire il caricamento delle immagini. Esistono vari software opensource da poter installare (es: lutim</a>), ma ho scartato questa ipotesi perché si sarebbe trattato dell'ennesimo software da gestire, solo per poter caricare una manciata di immagini. Dato su questo stesso server uso #nextcloud, mi è venuta un'idea geniale: montare la directory usata per il virtual host come archivio esterno! In questo modo il caricamento dei file è comunque protetto all'accesso nextcloud, il quale mi fornisce anche una semplice interfaccia per il caricamento delle #immagini!
Prima la salutarvi, proviamola questa soluzione per le immagini! Ecco qua due immagini, scaricate dal web a aggiunte a nextcloud direttamente da dispositivo mobile! (addirottura la seconda è in formato #svg)

A presto.
P. S. Questo articolo è allo stesso tempo un test, ho provato ad inserire un po' di hashtag in giro, vediamo come funziona.