Gitea: cos'è? Il tuo server Git su Saplo

Gitea è una piattaforma gratuita e leggera per ospitare repository Git sul tuo server, con pull request, problemi e wiki. GitHub Team addebita ogni account aggiuntivo nell'organizzazione, così come GitLab Premium, e un'agenzia che serve più clienti paga per lo stesso repository in pratica più volte, perché ogni cliente vuole la propria organizzazione. Gitea è un server Git open source che installi sul tuo Box, ottieni un browser di codice, pull request, problemi e wiki per ogni repository, e il numero di utenti e repository non costa nulla. Di seguito trovi una guida passo passo su come installare Gitea su Saplo.

Perché Gitea invece di GitHub o GitLab

Mantenere il codice nel cloud di qualcun altro ha senso finché il team è piccolo, ma cresce con il numero di account:

• GitHub Team e GitLab Premium addebitano una tariffa mensile per ogni utente dell'organizzazione, quindi uno sviluppatore aggiuntivo o un nuovo cliente dell'agenzia significa una voce in più sulla fattura, anche se usano il sistema solo una volta a settimana,
• i repository privati dei clienti conservati nel cloud di terzi sono dati fuori dal tuo controllo, il che può essere un problema con gli accordi di riservatezza,
• un'agenzia che serve molti clienti crea un'organizzazione separata per ognuno, e ogni organizzazione ha il suo contatore di posti.

Gitea funziona come un singolo container Docker sul tuo Box, quindi puoi creare repository senza limiti, gli account utente vengono aggiunti manualmente dall'amministratore e il costo totale è il costo del Box stesso, indipendentemente dal fatto che il team sia composto da due o venti persone.

Gitea contro GitHub e GitLab

Tutti e tre offrono un browser di codice, pull request e issue, la differenza sta nel dove risiedono i dati e quanto costa ogni account aggiuntivo:

• GitHub ha la community più grande e il maggior numero di integrazioni, ma le organizzazioni private pagano per ogni account e il codice dei clienti si trova sui server Microsoft,
• GitLab aggiunge CI/CD integrato, a costo di un consumo di risorse ancora maggiore se lo installi autonomamente, e il piano Premium con tutte le funzionalità addebita una tariffa per utente,
• Gitea è più leggero di entrambi, si avvia come un singolo container invece di un intero stack di microservizi, e puoi creare repository e account illimitati sul tuo Box.

Se un team o un'agenzia non ha bisogno di CI/CD integrato o di un'enorme community di progetti pubblici, ma solo di un posto per il codice dei clienti sotto il loro pieno controllo, Gitea è la scelta migliore.

Requisiti

Per installare Gitea su Saplo, hai bisogno di:

• Un Box con Docker in esecuzione (il motore lo abilita automaticamente durante l'installazione dal catalogo; è richiesto il nesting nel container, che Saplo ha per impostazione predefinita),
• Minimo 512 MB di RAM libera sul Box e 5 GB di spazio su disco, il che significa che il piano Box S è sufficiente (27 € all'anno),
• Un dominio o sottodominio *.saploapp.pl incluso nel Prezzo di ogni piano, su cui verrà ospitato il Pannello Gitea,
• Non è necessario creare manualmente un database separato - il motore crea automaticamente un database MySQL e lo collega al container, proprio come con WordPress o Ghost.

Installazione passo dopo passo

1. Nel Pannello Saplo, vai su Catalogo delle applicazioni e seleziona Gitea (categoria "Business").
2. Indica un Box con un minimo di 512 MB di RAM libera, su cui verrà installato il server Git, e il dominio o sottodominio sotto il quale opererà il pannello.
3. Conferma l'installazione. Il motore installa un container dall'immagine ufficiale gitea/gitea, crea un database MySQL, salta la procedura guidata di installazione web e crea immediatamente un account amministratore con una password casuale, collegato a nginx, che serve il pannello sotto il dominio specificato con SSL gratuito.
4. Dopo docker compose up, il motore attende che Gitea completi la Migrazione dello schema del database prima di tentare di creare l'account amministratore, e verifica che il container sia effettivamente in esecuzione prima di considerare l'installazione completata.
5. I dati di accesso dell'amministratore (login, password) vengono salvati nel file GITEA-SETUP.txt nella directory dell'applicazione.

Prima configurazione

1. Vai all'indirizzo del dominio, ad esempio kod.saploapp.pl, e accedi con il nome utente admin e la password dal file GITEA-SETUP.txt.
2. Cambia la password subito dopo il primo accesso (icona dell'account in alto a destra, Impostazioni, Account).
3. La registrazione pubblica è disabilitata - i nuovi utenti vengono aggiunti manualmente in Site Administration, Users, Create User Account, proprio come in Ghost o Listmonk, perché è uno strumento privato del team, non un servizio pubblico.
4. Crea il primo repository (New Repository), clonalo all'indirizzo del dominio via HTTPS e fai il primo commit - il server SSH integrato è disabilitato, il clone e il push funzionano solo via HTTPS.
5. Per i repository dei clienti puoi creare un'organizzazione separata (Create Organization) e aggiungere solo gli utenti che devono avere accesso.

Gitea su Saplo vs. GitHub Team e GitLab Premium

Domande frequenti

Posso clonare i repository tramite SSH? No, l'accesso a Gitea su Saplo è solo tramite HTTPS. Il server SSH integrato è disabilitato perché Saplo non espone la porta 22 delle applicazioni client all'esterno.

Tutti possono creare un account da soli? No, la registrazione pubblica è disabilitata. I nuovi account vengono creati manualmente dall'amministratore nel Pannello di amministrazione del sito.

Gitea ha un CI/CD integrato come GitLab? Non in questa installazione. Gitea si concentra su repository, pull request, problemi e wiki. Per l'automazione delle build, è necessario un runner separato o uno strumento esterno.

È possibile migrare repository esistenti da GitHub o GitLab? Sì, Gitea ha un importatore di repository integrato da URL. Devi solo fornire il link al repository sorgente e le credenziali di accesso, se è privato.

Se il tuo team o la tua agenzia paga oggi per altri account su GitHub o GitLab e vuole avere il pieno controllo del codice dei clienti, scrivici. Ti aiuteremo a scegliere il Box più adatto al tuo team.