Wilt u uw code niet naar een gehoste Git-repository pushen? Draai dan je eigen Git-server in huis. Gogs is de gemakkelijkste manier om dat te doen. Zo stelt u het in.
Inhoudsopgave
Het probleem met door de cloud gehoste repositories
Wat is Gogs?
Hoe installeer ik Gogs
Een korte rondleiding door Gogs
De eenvoudigste Git-server – zonder uitzondering
Het probleem met door de cloud gehoste opslagplaatsen
Git is zonder twijfel het meest vooraanstaande versiebeheersysteem. Zelfs bij projecten met één ontwikkelaar biedt Git waarde en voordeel vanwege de versiebeheerfunctionaliteit. Voor projecten met meerdere ontwikkelaars brengt Git een geheel andere dimensie. Met een centrale, externe repository maakt Git een samenwerkingsmogelijkheid mogelijk die de manier verandert waarop uw ontwikkelingsteams versiebeheer bekijken.
Dat is de reden waarom services zoals GitHub, GitLab en BitBucket bestaan, en waarom ze zo'n acceptatie en groei hebben gezien. Alleen GitHub herbergt meer dan 200 miljoen repositories. Maar in de cloud gehoste repositories zijn niet voor iedereen geschikt. De meesten van hen brengen kosten in rekening voor het hosten van privérepository's. Sommigen van hen leggen opslaglimieten, gebruikerslimieten of limieten voor gegevensoverdracht op voor gratis accounts.
Zelfs als uw gebruik en teamgrootte binnen de beperkingen van de gratis accounts vallen, of zelfs als u bereid bent om voor een commerciële licentie te betalen, voelt u zich misschien niet op uw gemak bij het opslaan van uw codebasis in de cloud.
Het alternatief is om uw eigen Git-server lokaal op uw eigen netwerk te hosten of privé toegankelijk in uw eigen privécloud. Het opzetten van een Git-server die een webinterface biedt met de look, feel en opties die GitHub en vrienden zo populair hebben gemaakt, vereist een zekere mate van technische vaardigheid. Dat is waar Gogs om de hoek komt kijken.
Wat is Gogs?
Gogs is een relatief nieuw project, geschreven in Go , dat een eenvoudig te installeren, maar toch volledig uitgeruste Git-instantie levert. Er zijn geen grenzen aan teamgrootte, opslag of iets anders.
Zelfs als je een hobbyistische programmeur bent, kun je met Gogs als een Git-service op je lokale netwerk een kopie van je code opslaan, weg van je ontwikkelmachine. Wanneer u of iemand anders op een andere of nieuwe computer wilt werken, kloont u eenvoudig een repository van uw Gogs-server, net zoals u zou doen van GitHub.
Als u Als u Gogs vaak gaat gebruiken, zult u het waarschijnlijk handig vinden om het toe te voegen aan de opstarttoepassingen van de computer waarop het draait.
GERELATEERD: < sterk>Een Linux-programma uitvoeren bij het opstarten met systemd
Hoe Gogs te installeren
Om Gogs te installeren, downloadt u het juiste archiefbestand, pak het uit en voer het hoofdbinaire bestand uit. U vult een paar formulieren in en Gogs initialiseert uw repository en voegt u toe als beheerder. U kunt dan naar uw Gogs-instantie bladeren en gebruikers toevoegen en opslagplaatsen maken.
Gogs gebruikt een database voor zijn back-endopslag. Het ondersteunt MySQL, MariaDB, PostgreSQL en TiDB. Als u een van deze krachtige database-engines wilt gebruiken, moet u deze zelf lokaliseren en installeren voordat u Gogs installeert. Voor kleinere teams kunt u SQLite3 gebruiken. Als u kiest voor SQLite3, wordt het voor u geïnstalleerd. Git moet natuurlijk ook geïnstalleerd zijn.
Download het juiste binaire bestand.
- Download voor de meeste moderne Linux-distributies de “ Linux amd64” bestand.
- Als u een 32-bits versie van Linux gebruikt, download dan de “Linux 386” bestand.
- Als je op een Raspberry Pi 2 of eerder installeert, download dan de “Linux armv7” bestand.
- Als je installeert op een Raspberry Pi 3, 3+ of nieuwer, download dan de “Linux armv8” bestand.
- Als u een Intel Mac gebruikt, downloadt u de “macOS amd64” bestand.
- Voor een Apple Silicon Mac downloadt u de “macOS arm64” bestand.
We hebben de “Linux amd64” ZIP-bestand, voor installatie op een 64-bits computer met Ubuntu 22.10. Het bestand is klein – slechts ongeveer 25 MB – dus wees niet verbaasd als het erg snel downloadt. Dat is normaal.
Zoek het bestand op in uw bestandssysteem. Als u de standaard downloadlocatie van uw browser heeft behouden, bevindt het bestand zich waarschijnlijk in uw “~/Downloads” map. Klik er met de rechtermuisknop op en selecteer “Uitpakken” vanuit het contextmenu. Sommige bestandsbrowsers gebruiken mogelijk “Hier uitpakken” in plaats daarvan.
Er wordt een map uit het ZIP-bestand gehaald. Het is vernoemd naar het gedownloade bestand. In ons geval heette het “gogs_0.11.91_linux_amd64.”
Dubbelklik op de uitgepakte map en je ziet een andere map met de naam “gogs.”
Dubbelklik op de “gogs” map. Je ziet de Gogs-bestanden en -mappen. Klik met de rechtermuisknop in het bestandsbrowservenster en selecteer “Openen in terminal” vanuit het contextmenu.
Om uw Gogs-instantie te starten, typ dit commando:
./gogs web
Gogs wordt gestart en vertelt u dat het luistert op poort 3000.
Maak verbinding met uw Gogs-server door een webbrowser te openen en naar het IP-adres of de netwerknaam van de computer waarop Gogs draait te navigeren. Voeg “:3000” achter het IP-adres of de netwerknaam. Voeg geen witruimte toe.
Als u aan het browsen bent op de computer waarop Gogs draait, kunt u “localhost” als de machinenaam, zoals deze “localhost:3000.” Onze Gogs-computer heet “ubuntu-22-10.local”, dus vanaf een andere computer op hetzelfde netwerk is het adres waarnaar we moeten bladeren “ubuntu-22-10.local: 3000”, inclusief het poortnummer.
De eerste keer dat u dit doet, ziet u het formulier dat wat initiële instellingsinformatie vastlegt.
Het eerste wat we moeten doen is “SQLite3” van het “Databasetype” vervolgkeuzemenu en voer uw gebruikersnaam in het veld “Run User” veld.
Als je e-mailmeldingen wilt instellen, moet je er een paar configureren extra stappen. U moet de e-mails doorsturen via een SMTP-mailserver (Simple Mail Transfer Protocol) waarvoor u toestemming hebt om deze te gebruiken. Als u een Google Gmail-gebruiker bent, kunt u de Gmail SMTP-server van Google gebruiken.
Hiervoor zijn instellingen op de mailserver nodig om uw account in staat te stellen de e-mail te accepteren en door te sturen. Deze instellingen variëren van mailserver tot mailserver.
Gogs vereist dat u de volgende informatie over uw e-mailserver invoert.
- SMTP Host: Het adres en de poort van de e-mailserver. In ons voorbeeld is dit de SMTP-server van Google op smtp.gmail.com:587.
- Van: het e-mailadres waarvandaan de e-mail wordt verzonden. Voor Gmail moet dit het Gmail-e-mailadres zijn van het account dat u gebruikt.
- E-mail afzender: Moet hetzelfde zijn als hierboven. Dit is de e-mailaccount-ID die Gogs zal gebruiken om met de SMTP-server te praten.
- Wachtwoord afzender: dit is niet het wachtwoord voor het Gmail-account . Het is het applicatiespecifieke wachtwoord dat u van Google krijgt wanneer u uw account configureert, zodat een applicatie namens u e-mail kan verzenden.
- Registratiebevestiging inschakelen: om Gogs gebruikers te laten verifiëren’ e-mails, schakelt u dit selectievakje in. Nieuwe gebruikers ontvangen een e-mail met daarin een link. Ze moeten op klikken om te bewijzen dat het e-mailadres echt is en onder hun controle valt.
- Mailmeldingen inschakelen: schakel dit selectievakje in om e-mailmeldingen van Gogs toe te staan.
- De “.gitignore” menu kunt u een sjabloon selecteren voor uw “.gitignore” bestand geconfigureerd met instellingen volgens de geselecteerde talen. U kunt meer dan één keuze maken uit dit menu, om tegemoet te komen aan repositories die een combinatie van ontwikkelingstechnologieën gebruiken.
- De “licentie” In het menu “Readme” menu heeft een enkele optie, een standaard “README.md” bestand.
- › Deze telefoon heeft een 6,1-inch E-Ink-display
- › Telegram heeft nog een laatste grote update voor 2022
- › “Radiotuin” Laat je 's werelds radiostations ontdekken
- › Hoe u uw Reddit-gebruikersnaam kunt wijzigen
- › GPU-fans draaien niet: waarom het gebeurt en hoe het te verhelpen
- › Hoe speel je PS5-games in 1440p (en waarom je dat misschien niet wilt)
ul>
Natuurlijk, als je geen lastiggevallen door e-mails, kunt u alle e-mailinstellingen overslaan.
Klik op de blauwe “Install Gogs” knop wanneer u klaar bent om verder te gaan. Gogs schrijft een configuratiebestand, initialiseert de databaseopslag en start uw Git-instantie.
U ziet de hoofdpagina van Gogs.
Het eerste gebruikersaccount dat u aanmaakt, krijgt automatisch beheerdersrechten. Klik op de knop “Registreren” koppeling.
Voltooi de “Aanmelden” formulier met uw accountnaam, een wachtwoord voor dit account (twee keer invoeren) en de cijfers van de Captcha. Klik op de groene knop “Nieuw account maken” knop. U ziet de knop “Aanmelden” pagina.
Voer uw accountnaam en wachtwoord in en klik op de groene “Aanmelden” knop.
Een korte rondleiding door Gogs
Als je ook maar enigszins bekend bent met een andere Git-instantie die toegang heeft tot het web, zul je heel gemakkelijk je weg vinden in Gogs.
Het Gogs “Dashboard” weergave is een beetje schaars totdat je een repository hebt om mee te werken. Klik op de blauwe “+” knop en voltooi de “Nieuwe repository” formulier.
Het vraagt om een naam van de repository, of deze nu privé of openbaar is, en een beschrijving.
De volgende drie velden maken bestanden van sjablonen.
Vink de optie “Initialiseer deze repository met geselecteerde bestanden en sjabloon” selectievakje en klik op de groene knop “Create Repository” knop.
Uw nieuwe repository wordt voor u weergegeven. Gogs heeft onze drie standaardbestanden voor ons gemaakt en deze aan de repository toegevoegd met het commit-bericht “Initial commit.
We hebben de repository naar onze computer gekloond, een bestand toegevoegd met de naam “ack.c”, committe het en pushte het naar onze externe Gogs-repository. Dit alles werd gedaan met behulp van standaard Git-commando's.
Als verwacht, verschijnt ons nieuwe bestand in onze Gogs-repository.
Door op een bestand te klikken, krijgen we de inhoud van het individuele bestand te zien. Markdown-bestanden worden voor u geïnterpreteerd, met koppen, koppelingen, lijsten en alle andere Markdown-functies. “README.md” bestanden worden meestal geschreven in Markdown.
Door te klikken op de knop “Bewerken” potloodpictogram, kunnen we onze “README.md” het dossier. We hebben wat meer tekst toegevoegd, Markdown-tags gebruikt om hyperlinks en cursief in te voegen en onze wijzigingen doorgevoerd. Allemaal vanuit Gogs.
Terug in onze repositoryweergave, onze bijgewerkte “README.md” bestand wordt weergegeven en het bestand “README.md” vermelding in de bestandslijst toont een nieuw commit-bericht en updatetijd.
De eenvoudigste Git-server – Balk Geen
Gogs is een absolute triomf. Het combineert perfect functionaliteit met eenvoud.
Uit de doos zal het voldoen aan de behoeften van de meeste hobbyisten of kleine ontwikkelingsteams. Sommige van de geavanceerde opties worden geactiveerd door het configuratiebestand te bewerken dat zich standaard bevindt op “~/Downloads/gogs_0.12.10_linux_amd64/gogs/custom/conf/app.ini.” Merk op dat het pad de versie van Gogs die u gebruikt weergeeft.
Algemeen systeembeheer kan worden uitgevoerd vanuit het beheerderspaneel, te vinden op Uw profiel > Beheerderspaneel.
Hoewel de Gogs-documentatie kort en bondig is, betekent dat wel dat het gemakkelijk is om te vinden wat u zoekt, en de beschrijvingen zijn gedetailleerd genoeg voor u te volgen.
Als u op uw hoede bent voor door de cloud gehoste opslagplaatsen die uiteindelijk onder de controle van anderen staan, overweeg dan om Gogs lokaal te gebruiken. U verliest geen functionaliteit, maar u krijgt controle en gegarandeerde privacy.
GERELATEERD: Hoe u uw Git-versie kunt controleren en bijwerken< /p> LEES VOLGENDE