Gogs ist der einfachste Weg, einen lokalen Git-Server zu betreiben (So richten Sie ihn ein)

Gogs

Sie möchten Ihren Code nicht in ein gehostetes Git-Repository übertragen? Dann betreiben Sie Ihren eigenen Git-Server im Haus. Gogs ist der einfachste Weg, dies zu tun. So richten Sie es ein.

Inhaltsverzeichnis

Das Problem mit in der Cloud gehosteten Repositories
Was ist Gogs?
So installieren Sie Gogs
Ein kurzer Rundgang durch Gogs
Der einfachste Git-Server – ohne Ausnahme

Das Problem mit in der Cloud gehosteten Repositories

Ohne Zweifel ist Git das herausragende Versionskontrollsystem. Selbst bei Einzelentwicklerprojekten bietet Git aufgrund seiner Versionierungsfunktionalität einen Mehrwert und Nutzen. Für Projekte mit mehreren Entwicklern bringt Git eine ganz andere Dimension. Mit einem zentralen Remote-Repository ermöglicht Git eine Zusammenarbeitsfähigkeit, die die Art und Weise verändert, wie Ihre Entwicklungsteams die Versionskontrolle sehen.

VERWANDTEWas ist GitHub und wofür wird es verwendet?

Aus diesem Grund gibt es Dienste wie GitHub, GitLab und BitBucket und sie haben eine solche Akzeptanz und ein solches Wachstum erlebt. Allein GitHub hostet über 200 Millionen Repositories. Aber in der Cloud gehostete Repositories sind nicht für jeden geeignet. Die meisten von ihnen erheben Gebühren für das Hosten privater Repositories. Einige von ihnen erlegen Speicherbeschränkungen, Benutzerbeschränkungen oder Datenübertragungsbeschränkungen für kostenlose Konten auf.

Auch wenn Ihre Nutzung und Teamgröße in die Beschränkungen der kostenlosen Konten passt oder selbst wenn Sie dazu bereit sind um für eine kommerzielle Lizenz zu bezahlen, fühlen Sie sich möglicherweise nicht wohl dabei, Ihre Codebasis in der Cloud zu speichern.

Die Alternative besteht darin, Ihren eigenen Git-Server entweder lokal in Ihrem eigenen Netzwerk oder privat zugänglich in Ihrer eigenen privaten Cloud zu hosten. Die Einrichtung eines Git-Servers, der eine Weboberfläche mit dem Look, Feel und den Optionen bietet, die GitHub und Co. so populär gemacht haben, erforderte früher ein gewisses Maß an technischem Geschick. Hier kommt Gogs ins Spiel.

Was ist Gogs?

Gogs ist ein relativ neues Projekt, das in Go geschrieben wurde , das eine einfach zu installierende und dennoch voll funktionsfähige Git-Instanz bereitstellt. Es gibt keine Grenzen für Teamgröße, Speicherplatz oder sonstiges.

Selbst wenn Sie ein Hobby-Programmierer sind, können Sie mit Gogs als Git-Dienst in Ihrem lokalen Netzwerk eine Kopie Ihres Codes außerhalb Ihres Entwicklungscomputers speichern. Wenn Sie "oder jemand anderes" auf einem anderen oder neuen Computer arbeiten möchten, klonen Sie einfach ein Repository von Ihrem Gogs-Server, genau wie Sie es von GitHub tun würden.

Wenn Sie möchten Wenn Sie Gogs häufig verwenden, werden Sie es wahrscheinlich bequem finden, es zu den Startanwendungen des Computers hinzuzufügen, auf dem es ausgeführt wird.

VERWANDTE BEZUG: < stark>So führen Sie ein Linux-Programm beim Start mit systemd aus

So installieren Sie Gogs

Um Gogs zu installieren, laden Sie es herunter die entsprechende Archivdatei, entpacken Sie sie und führen Sie die Hauptbinärdatei aus. Sie füllen einige Formulare aus, und Gogs initialisiert Ihr Repository und fügt Sie als Administrator hinzu. Sie können dann zu Ihrer Gogs-Instanz navigieren und Benutzer hinzufügen und Repositories erstellen.

Gogs verwendet eine Datenbank für seinen Back-End-Speicher. Es unterstützt MySQL, MariaDB, PostgreSQL und TiDB. Wenn Sie eine dieser leistungsstarken Datenbank-Engines verwenden möchten, müssen Sie sie selbst suchen und installieren, bevor Sie Gogs installieren. Für kleinere Teams können Sie SQLite3 verwenden. Wenn Sie sich für SQLite3 entscheiden, wird es für Sie installiert. Natürlich muss auch git installiert sein.

Laden Sie die entsprechende Binärdatei herunter.

  • Für die meisten modernen Linux-Distributionen laden Sie die “ Linux amd64” Datei.
  • Wenn Sie eine 32-Bit-Version von Linux verwenden, laden Sie die “Linux 386” Datei.
  • Wenn Sie auf einem Raspberry Pi 2 oder älter installieren, laden Sie die “Linux armv7” Datei.
  • Wenn Sie auf einem Raspberry Pi 3, 3+ oder höher installieren, laden Sie die “Linux armv8” Datei.
  • Wenn Sie einen Intel-Mac verwenden, laden Sie die “macOS amd64” Datei.
  • Laden Sie für einen Apple Silicon Mac die “macOS arm64” Datei.

Wir haben die “Linux amd64” ZIP-Datei, zur Installation auf einem 64-Bit-Computer mit Ubuntu 22.10. Die Datei ist klein – nur etwa 25 MB – also seien Sie nicht überrascht, wenn sie sehr schnell heruntergeladen wird. Das ist normal.

Suchen Sie die Datei in Ihrem Dateisystem. Wenn Sie den standardmäßigen Download-Speicherort Ihres Browsers beibehalten haben, befindet sich die Datei wahrscheinlich im Verzeichnis “~/Downloads” Verzeichnis. Klicken Sie mit der rechten Maustaste darauf und wählen Sie “Extrahieren” aus dem Kontextmenü. Einige Dateibrowser verwenden möglicherweise “Hier extrahieren” stattdessen.

Ein Verzeichnis wird aus der ZIP-Datei extrahiert. Es ist nach der heruntergeladenen Datei benannt. In unserem Fall hieß es “gogs_0.11.91_linux_amd64.”

Doppelklicken Sie auf das extrahierte Verzeichnis und Sie sehen ein weiteres Verzeichnis namens “gogs.”

Doppelklicken Sie auf die “Gogs” Verzeichnis. Sie sehen die Gogs-Dateien und -Verzeichnisse. Klicken Sie mit der rechten Maustaste in das Dateibrowserfenster und wählen Sie „Im Terminal öffnen“ aus. aus dem Kontextmenü.

Um Ihre Gogs-Instanz zu starten, Geben Sie diesen Befehl ein:

./gogs web

Gogs startet und teilt Ihnen mit, dass es auf Port 3000 lauscht.

Stellen Sie eine Verbindung zu Ihrem Gogs-Server her, indem Sie einen Webbrowser öffnen und zur IP-Adresse oder zum Netzwerknamen des Computers navigieren, auf dem Gogs ausgeführt wird. Fügen Sie “:3000” nach der IP-Adresse oder dem Netzwerknamen. Fügen Sie keine Leerzeichen ein.

Wenn Sie auf dem Computer surfen, auf dem Gogs ausgeführt wird, können Sie “localhost” als Maschinenname, etwa “localhost:3000.” Unser Gogs-Computer heißt “ubuntu-22-10.local”, also müssen wir von einem anderen Computer im selben Netzwerk aus die Adresse “ubuntu-22-10.local aufrufen: 3000”, einschließlich der Portnummer.

Wenn Sie dies zum ersten Mal tun, sehen Sie das Formular, das einige anfängliche Einrichtungsinformationen erfasst.

Als erstes müssen wir “SQLite3” aus dem “Datenbanktyp” Dropdown-Menü und geben Sie Ihren Benutzernamen in das Feld “Run User” Feld.

Wenn Sie E-Mail-Benachrichtigungen einrichten möchten, müssen Sie einige konfigurieren zusätzliche Schritte. Sie müssen die E-Mails über einen SMTP-Mailserver (Simple Mail Transfer Protocol) weiterleiten, zu dessen Verwendung Sie berechtigt sind. Wenn Sie ein Nutzer von Google Gmail sind, können Sie den SMTP-Server von Google Gmail verwenden.

Dies erfordert Einstellungen auf dem Mailserver, damit Ihr Konto die E-Mail annehmen und weiterleiten kann. Diese Einstellungen variieren von Mailserver zu Mailserver.

Gogs verlangt von Ihnen die Eingabe der folgenden Informationen über Ihren E-Mail-Server.

  • SMTP-Host: Die Adresse und der Port des E-Mail-Servers. In unserem Beispiel ist dies der SMTP-Server von Google unter smtp.gmail.com:587.
  • Von: Die E-Mail-Adresse, von der die E-Mail gesendet wird. Für Gmail sollte dies die Gmail-E-Mail-Adresse des Kontos sein, das Sie verwenden.
  • Absender-E-Mail: Muss gleich wie oben sein. Dies ist die E-Mail-Konto-ID, die Gogs verwendet, um mit dem SMTP-Server zu kommunizieren.
  • Absenderpasswort: Dies ist nicht das Passwort für das Gmail-Konto . Es ist das anwendungsspezifische Passwort, das Sie von Google erhalten, wenn Sie Ihr Konto konfigurieren, damit eine Anwendung E-Mails in Ihrem Namen senden kann.
  • Registrierungsbestätigung aktivieren: Um Gogs Benutzer verifizieren zu lassen’ E-Mails, aktivieren Sie dieses Kontrollkästchen. Neue Benutzer erhalten eine E-Mail mit einem darin enthaltenen Link. Sie müssen auf klicken, um zu beweisen, dass die E-Mail-Adresse echt ist und unter ihrer Kontrolle steht.
  • E-Mail-Benachrichtigung aktivieren: Aktivieren Sie dieses Kontrollkästchen, um E-Mail-Benachrichtigungen von Gogs zuzulassen.

Natürlich, wenn Sie das nicht möchten von E-Mails belästigt werden, können Sie alle E-Mail-Einstellungen überspringen.

Klicken Sie auf das blaue “Gogs installieren” Schaltfläche, wenn Sie fortfahren möchten. Gogs schreibt eine Konfigurationsdatei, initialisiert den Datenbankspeicher und startet Ihre Git-Instanz.

Sie sehen die Hauptseite von Gogs.

Das erste von Ihnen erstellte Benutzerkonto erhält automatisch Administratorrechte. Klicken Sie auf “Registrieren” Link.

Vervollständigen Sie das “Anmelden” Formular mit Ihrem Kontonamen, einem Passwort für dieses Konto (zweimal eingeben) und den Ziffern aus dem Captcha. Klicken Sie auf das grüne “Neues Konto erstellen” Knopf. Sie sehen die Seite “Anmelden” Seite.

Geben Sie Ihren Kontonamen und Ihr Passwort ein und klicken Sie auf das grüne “Anmelden” Schaltfläche.

Eine schnelle Tour durch Gogs

Wenn Sie mit irgendeiner anderen Git-Instanz mit Webzugriff vertraut sind, werden Sie sich sehr leicht in Gogs zurechtfinden.

Das Gogs “Dashboard” view ist ein wenig spärlich, bis Sie ein Repository haben, mit dem Sie arbeiten können. Klicken Sie auf das blaue “+” Schaltfläche und vervollständigen Sie das “Neue Repository” Form.

Es fragt nach einem Repository-Namen, ob privat oder öffentlich, und einer Beschreibung.

Die nächsten drei Felder erstellen Dateien aus Vorlagen.

  • Das “.gitignore” Menü können Sie eine Vorlage für Ihre “.gitignore” Datei, die mit Einstellungen gemäß den ausgewählten Sprachen konfiguriert ist. Sie können in diesem Menü mehr als eine Auswahl treffen, um Repositories gerecht zu werden, die eine Mischung aus Entwicklungstechnologien verwenden.
  • Die “Lizenz” können Sie eine Lizenz aus einer umfassenden Liste auswählen.
  • Die “Readme” Menü hat eine einzige Option, eine Standardeinstellung “README.md” Datei.

Markieren Sie das “Dieses Repository mit ausgewählten Dateien und Vorlagen initialisieren” Kontrollkästchen und klicken Sie auf das grüne “Repository erstellen” Schaltfläche.

Ihr neues Repository wird Ihnen angezeigt. Gogs hat unsere drei Standarddateien für uns erstellt und sie mit der Commit-Nachricht „Initial commit“ zum Repository hinzugefügt.

Wir haben das Repository auf unseren Computer geklont und eine Datei namens “ack.c”, es festgeschrieben und in unser entferntes Gogs-Repository gepusht. All dies wurde mit standardmäßigen Git-Befehlen durchgeführt.

As Wie erwartet wird unsere neue Datei in unserem Gogs-Repository angezeigt.

Ein Klick auf eine Datei zeigt uns den Inhalt der einzelnen Datei. Markdown-Dateien werden für Sie interpretiert, mit Überschriften, Links, Listen und allen anderen Markdown-Funktionen. “README.md” Dateien werden normalerweise in Markdown geschrieben.

Durch Klicken auf die Schaltfläche “Bearbeiten” Stiftsymbol können wir unsere “README.md” Datei. Wir haben etwas mehr Text hinzugefügt, Markdown-Tags verwendet, um Hyperlinks und Kursivschrift einzufügen, und unsere Änderungen übernommen. Alles innerhalb von Gogs.

Zurück in unserer Repository-Ansicht, unsere aktualisierte “README.md” Datei wird angezeigt und die Datei “README.md” Eintrag in der Dateiliste zeigt eine neue Commit-Nachricht und die Aktualisierungszeit.

Der einfachste Git-Server – Balken Keine

Gogs ist ein absoluter Triumph. Es verbindet Funktionalität perfekt mit Einfachheit.

Out of the box erfüllt es die Anforderungen der meisten Bastler oder kleinen Entwicklungsteams. Einige der erweiterten Optionen werden durch Bearbeiten der Konfigurationsdatei aktiviert, die sich standardmäßig unter “~/Downloads/gogs_0.12.10_linux_amd64/gogs/custom/conf/app.ini befindet.” Beachten Sie, dass der Pfad die Version von Gogs widerspiegelt, die Sie verwenden.

Die allgemeine Systemadministration kann über das Admin-Panel durchgeführt werden, das Sie unter Ihr Profil > Admin-Panel.

Obwohl die Gogs-Dokumentation kurz und knapp gehalten ist, bedeutet dies, dass Sie leicht finden, wonach Sie suchen, und die Beschreibungen detailliert genug sind Ihnen zu folgen.

Wenn Sie in der Cloud gehostete Repositorys misstrauisch finden, die letztlich unter der Kontrolle anderer stehen, sollten Sie Gogs lokal verwenden. Sie verlieren keine Funktionalität, aber Sie erhalten Kontrolle und garantierten Datenschutz.

VERWANDTE ARTIKEL: So überprüfen und aktualisieren Sie Ihre Git-Version< /p> WEITER LESEN

  • › Dieses Telefon hat ein 6,1-Zoll-E-Ink-Display
  • › Telegram hat ein letztes großes Update für 2022
  • › “Funkgarten” Ermöglicht es Ihnen, die Radiosender der Welt zu entdecken
  • › So ändern Sie Ihren Reddit-Benutzernamen
  • › GPU-Lüfter drehen sich nicht: Warum es passiert und wie es behoben werden kann
  • › Wie man PS5-Spiele in 1440p spielt (und warum Sie das vielleicht nicht wollen)

Posted

in

by

Tags: