Non vuoi inviare il tuo codice a un repository Git ospitato? Quindi esegui il tuo server Git internamente. Gogs è il modo più semplice per farlo. Ecco come configurarlo.
Sommario
Il problema con i repository ospitati nel cloud
Cos'è Gogs?
Come installare Gogs
Un rapido tour di Gogs
Il server Git più semplice – Nessuno escluso
Il problema con i repository ospitati nel cloud
Senza dubbio, Git è il sistema di controllo della versione preminente. Anche con progetti a sviluppatore singolo, Git offre valore e vantaggi grazie alla sua funzionalità di controllo delle versioni. Per i progetti multi-sviluppatore, Git offre un'altra dimensione completamente. Con un repository remoto centrale, Git abilita una funzionalità collaborativa che trasformerà il modo in cui i tuoi team di sviluppo visualizzano il controllo della versione.
Ecco perché esistono servizi come GitHub, GitLab e BitBucket e perché hanno visto una tale diffusione e crescita. GitHub da solo ospita oltre 200 milioni di repository. Ma i repository ospitati nel cloud non sono adatti a tutti. La maggior parte di loro fa pagare per ospitare repository privati. Alcuni impongono limiti di archiviazione, limiti utente o limiti di trasferimento dati sugli account gratuiti.
Anche se il tuo utilizzo e le dimensioni del tuo team rientrano nelle restrizioni degli account gratuiti, o anche se lo desideri per pagare una licenza commerciale, potresti semplicemente non sentirti a tuo agio nell'archiviare la tua base di codice nel cloud.
L'alternativa è ospitare il tuo server Git localmente sulla tua rete o accessibile privatamente nel tuo cloud privato. La configurazione di un server Git che fornisce un'interfaccia web con l'aspetto, la sensazione e le opzioni che GitHub e i suoi amici hanno reso così popolare richiedeva un certo grado di abilità tecnica. È qui che entra in gioco Gogs.
Cos'è Gogs?
Gogs è un progetto relativamente nuovo, scritto in Gos , che offre un'istanza Git facile da installare ma completa di tutte le funzionalità. Non ci sono limiti alle dimensioni del team, allo spazio di archiviazione o altro.
Anche se sei un programmatore per hobby, l'utilizzo di Gogs come servizio Git sulla tua rete locale ti consente di archiviare una copia del tuo codice lontano dalla tua macchina di sviluppo. Quando tu o qualcun altro vuoi lavorare su un computer diverso o nuovo, devi semplicemente clonare un repository dal tuo server Gogs proprio come faresti da GitHub.
Se sei Utilizzerai spesso Gogs, probabilmente troverai conveniente aggiungerlo alle applicazioni di avvio del computer su cui è in esecuzione.
RELAZIONATO: < forte>Come eseguire un programma Linux all'avvio con systemd
Come installare Gogs
Per installare Gogs, devi scaricare il file di archivio appropriato, decomprimerlo ed eseguire il binario principale. Compili alcuni moduli e Gogs inizializza il tuo repository e ti aggiunge come utente amministratore. Puoi quindi accedere alla tua istanza Gogs e aggiungere utenti e creare repository.
Gogs utilizza un database per l'archiviazione back-end. Supporta MySQL, MariaDB, PostgreSQL e TiDB. Se desideri utilizzare uno di questi potenti motori di database, devi individuarlo e installarlo tu stesso, prima di installare Gogs. Per i team più piccoli, puoi utilizzare SQLite3. Se opti per SQLite3, è installato per te. Ovviamente, dovrai avere installato anche git.
Scarica il file binario appropriato.
- Per la maggior parte delle distribuzioni Linux moderne, scarica il file “ Linux amd64” file.
- Se utilizzi una versione a 32 bit di Linux, scarica il file “Linux 386”
- Se stai installando su un Raspberry Pi 2 o precedente, scarica il file “Linux armv7”
- Se stai installando su un Raspberry Pi 3, 3+ o successivo, scarica il file “Linux armv8” file.
- Se utilizzi un Mac Intel, scarica il file “macOS amd64” file.
- Per un Apple Silicon Mac, scarica il file “macOS arm64” file.
Abbiamo scaricato “Linux amd64” ZIP, per l'installazione su un computer a 64 bit con Ubuntu 22.10. Il file è piccolo, solo circa 25 MB, quindi non sorprenderti se viene scaricato molto velocemente. È normale.
Individua il file nel tuo file system. Se hai mantenuto la posizione di download predefinita del browser, il file sarà probabilmente nella cartella “~/Downloads” directory. Fai clic con il pulsante destro del mouse e seleziona “Estrai” dal menu contestuale. Alcuni browser di file potrebbero utilizzare “Estrai qui” invece.
Dal file ZIP viene estratta una directory. Prende il nome dal file scaricato. Nel nostro caso, si chiamava “gogs_0.11.91_linux_amd64.”
Fai doppio clic sulla directory estratta e vedrai un'altra directory chiamata “gogs.”
Fai doppio clic sull'icona “gogs” directory. Vedrai i file e le directory di Gogs. Fai clic con il pulsante destro del mouse nella finestra del browser dei file e seleziona “Apri nel terminale” dal menu contestuale.
Per avviare la tua istanza Gogs, digita questo comando:
./gogs web
Gogs si avvia e ti dice che è in ascolto sulla porta 3000.
Connettiti al tuo server Gogs aprendo un browser Web e navigando fino all'indirizzo IP o al nome di rete del computer su cui è in esecuzione Gogs. Aggiungi “:3000” dopo l'indirizzo IP o il nome della rete. Non includere spazi bianchi.
Se stai navigando sul computer su cui è in esecuzione Gogs, puoi utilizzare “localhost” come nome della macchina, come questo “localhost:3000.” Il nostro computer Gogs si chiama “ubuntu-22-10.local”, quindi da un altro computer sulla stessa rete, l'indirizzo a cui dobbiamo navigare è “ubuntu-22-10.local: 3000”, incluso il numero di porta.
La prima volta che lo fai, vedrai il modulo che acquisisce alcune informazioni di configurazione iniziale.
La prima cosa che dobbiamo fare è selezionare “SQLite3” dal “Tipo di database” menu a discesa e inserisci il tuo nome utente nel campo “Esegui utente” campo.
Se vuoi impostare le notifiche email dovrai configurare alcune passaggi aggiuntivi. Dovrai inoltrare le e-mail tramite un server di posta SMTP (Simple Mail Transfer Protocol) che sei autorizzato a utilizzare. Se sei un utente Google Gmail, puoi utilizzare il server SMTP Gmail di Google.
Ciò richiederà le impostazioni sul server di posta per consentire al tuo account di accettare e inoltrare l'e-mail. Queste impostazioni variano da server di posta a server di posta.
Gogs richiede di inserire le seguenti informazioni sul tuo server di posta.
- Host SMTP: L'indirizzo e la porta del server di posta elettronica. Nel nostro esempio, questo è il server SMTP di Google all'indirizzo smtp.gmail.com:587.
- Da: l'indirizzo email da cui verrà inviata l'email. Per Gmail questo dovrebbe essere l'indirizzo email Gmail dell'account che stai utilizzando.
- Email mittente: Deve essere uguale a quello sopra. Questo è l'ID dell'account email che Gogs utilizzerà per comunicare con il server SMTP.
- Password mittente: questa non è la password dell'account Gmail . È la password specifica per l'applicazione che ottieni da Google quando configuri il tuo account per consentire a un'applicazione di inviare email per tuo conto.
- Abilita conferma registrazione: Per fare in modo che Gogs verifichi gli utenti’ e-mail, seleziona questa casella di controllo. I nuovi utenti riceveranno un'email con un link al suo interno. Devono fare clic su per dimostrare che l'indirizzo e-mail è autentico e sotto il loro controllo.
- Abilita notifica e-mail: seleziona questa casella di controllo per consentire le notifiche e-mail da Gogs.
- Il “.gitignore” ti consente di selezionare un modello per il tuo “.gitignore” file configurato con le impostazioni in base alle lingue selezionate. Puoi effettuare più di una scelta da questo menu, per soddisfare i repository che utilizzano una combinazione di tecnologie di sviluppo.
- La “Licenza” ti consente di scegliere una licenza da un elenco completo.
- Il menu “Leggimi” ha un'unica opzione, un'opzione predefinita “README.md”
- › 10 funzionalità di Discord che dovresti usare
- › Steam Deck troppo lento? Prova il “Cyberdeck”
- › Un altro paese sta rendendo USB-C obbligatorio sui telefoni
- › Fa male dormire accanto al telefono?
- › Il lancio della palla di Capodanno a New York ha un pessimo gioco nel metaverso
- › Ecco come usare la tua casa intelligente per ingannare i ladri
ul>
Certo, se non vuoi essere infastidito dalle e-mail, puoi saltare tutte le impostazioni e-mail.
Fai clic sul pulsante blu “Installa Gogs” quando sei pronto per procedere. Gogs scrive un file di configurazione, inizializza l'archiviazione del database e avvia la tua istanza Git.
Vedrai la home page principale di Gogs.
Al primo account utente che crei verranno assegnati automaticamente i diritti di amministratore. Fai clic sul pulsante “Registrati” link.
Completa il modulo “Iscriviti” modulo con il nome del tuo account, una password per questo account (inseriscila due volte) e le cifre del Captcha. Fai clic sul pulsante verde “Crea nuovo account” pulsante. Vedrai il pulsante “Accedi” page.
Inserisci il nome e la password del tuo account e fai clic su la scritta verde “Accedi” button.
Un rapido tour di Gogs
Se hai familiarità con qualsiasi altra istanza Git accessibile dal Web, troverai molto facilmente la tua strada per Gogs.
Il “Dashboard” view è un po' scarsa fino a quando non hai un repository con cui lavorare. Fai clic sul pulsante blu “+” e completa il pulsante “Nuovo repository” form.
Richiede il nome del repository, privato o pubblico, e una descrizione.
I prossimi tre campi creano file dai modelli.
Spunta la casella “Inizializza questo repository con i file e il modello selezionati” e fai clic sulla casella verde “Crea repository” pulsante.
Il tuo nuovo repository viene visualizzato per te. Gogs ha creato per noi i nostri tre file standard e li ha aggiunti al repository con il messaggio di commit “Initial commit.”
Abbiamo clonato il repository sul nostro computer, aggiunto un file chiamato “ack.c”, ne ho eseguito il commit e l'ho inviato al nostro repository Gogs remoto. Tutto questo è stato fatto utilizzando i comandi Git standard.
As previsto, il nostro nuovo file viene visualizzato nel nostro repository Gogs.
Cliccando su un file ci mostra il contenuto del singolo file. I file Markdown vengono interpretati per te, con intestazioni, collegamenti, elenchi e tutte le altre funzionalità di Markdown. “LEGGIMI.md” i file sono solitamente scritti in Markdown.
Facendo clic sul pulsante “Modifica” icona della matita, possiamo modificare direttamente il nostro “README.md” file. Abbiamo aggiunto altro testo, utilizzato tag Markdown per inserire collegamenti ipertestuali e corsivo e confermato le nostre modifiche. Tutto da Gogs.
Tornando nella nostra vista repository, il nostro “README.md” viene visualizzato il file e il file “README.md” la voce nell'elenco dei file mostra un nuovo messaggio di commit e l'ora di aggiornamento.
Il server Git più semplice – Nessuna barra
Gogs è un trionfo assoluto. Unisce perfettamente funzionalità e semplicità.
Pronta all'uso, soddisferà le esigenze della maggior parte degli hobbisti o dei piccoli team di sviluppo. Alcune delle sue opzioni avanzate vengono attivate modificando il file di configurazione che, per impostazione predefinita, si trova in “~/Downloads/gogs_0.12.10_linux_amd64/gogs/custom/conf/app.ini.” Tieni presente che il percorso rifletterà la versione di Gogs che stai utilizzando.
L'amministrazione generale del sistema può essere eseguita dal pannello di amministrazione, disponibile in Il tuo profilo > Pannello di amministrazione.
Sebbene la documentazione di Gogs sia breve al punto da essere concisa, ciò significa che è facile trovare quello che stai cercando e le descrizioni sono abbastanza dettagliate per seguire.
Se diffidate dei repository ospitati nel cloud che sono in definitiva sotto il controllo di altri, prendete in considerazione l'utilizzo di Gogs localmente. Non perderai funzionalità, ma otterrai il controllo e la privacy garantita.
RELAZIONATO: Come controllare e aggiornare la tua versione di Git< /p> LEGGI SUCCESSIVO