Gitea ist ein selbst gehosteter Open-Source-Git-Server, der in Go geschrieben wurde. Es ist eine Gabel von Gogs. Gitea enthält einen Repository-Dateieditor, Projektproblemverfolgung, Benutzerverwaltung, Benachrichtigungen, integriertes Wiki und vieles mehr.
Gite ist eine leichtgewichtige Anwendung und kann auf Systemen mit geringer Leistung installiert werden. Wenn Sie nach einer Alternative zu Gitlab mit viel geringerem Speicherbedarf suchen und nicht den ganzen Schnickschnack benötigen, den Gitlab bietet, dann sollten Sie unbedingt Gitea ausprobieren.
Dieses Tutorial erklärt, wie man Gitea auf Ubuntu 18.04 installiert und konfiguriert. Dieselben Anweisungen gelten für Ubuntu 16.04 und jede andere Debian-basierte Distribution.
Voraussetzungen #
Gitea unterstützt SQLite-, PostgreSQL- und MySQL/MariaDBas-Datenbank-Backends.
Wir verwenden SQLite als Datenbank für Gitea. Wenn SQLite nicht auf Ihrem Ubuntu-System installiert ist, können Sie es installieren, indem Sie die folgenden Befehle als sudo-Benutzer eingeben:
sudo apt updatesudo apt install sqlite3
Installieren von Gitea #
Gitea stellt Docker-Images bereit und kann aus der Quelle, binär und als Paket installiert werden. Wir installieren Gitea aus der Binärdatei.
Installieren Sie Git #
Der erste Schritt besteht darin, Giton auf Ihrem Server zu installieren:
sudo apt updatesudo apt install git
Überprüfen Sie die Installation, indem Sie die Git-Version anzeigen:
git --versiongit version 2.17.1
Erstelle einen Git-Benutzer #
Erstellen Sie einen neuen Systembenutzer, der die Gitea-Anwendung ausführt, indem Sie Folgendes eingeben:
sudo adduser --system --group --disabled-password --shell /bin/bash --home /home/git --gecos 'Git Version Control' git
Der Befehl erstellt einen neuen Benutzer und eine neue Gruppe mit dem Namen git , und legen Sie das Home-Verzeichnis auf /home/git fest . Die Ausgabe sieht in etwa so aus:
Adding system user `git' (UID 111) ...
Adding new group `git' (GID 116) ...
Adding new user `git' (UID 111) with group `git' ...
Creating home directory `/home/git' ...
Gitea-Binärdatei # herunterladen
Besuchen Sie die Gitea-Download-Seite und laden Sie die neueste Binärdatei für Ihre Architektur herunter. Zum Zeitpunkt des Schreibens ist die neueste Version 1.10.2. Wenn eine neue Version verfügbar ist, ändern Sie die VERSION Variable im folgenden Befehl.
Laden Sie die Gitea-Binärdatei im /tmp herunter Verzeichnis mit dem folgenden wget Befehl:
VERSION=1.10.2sudo wget -O /tmp/gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
Die gitea binär kann von jedem Ort ausgeführt werden. Wir folgen der Konvention und verschieben die Binärdatei nach /usr/local/bin Verzeichnis:
sudo mv /tmp/gitea /usr/local/binMachen Sie die Binärdatei ausführbar:
sudo chmod +x /usr/local/bin/giteaFühren Sie die folgenden Befehle aus, um die Verzeichnisse zu erstellen und die erforderlichen Berechtigungen und Eigentumsrechte festzulegen:
sudo mkdir -p /var/lib/gitea/{custom,data,indexers,public,log}sudo chown git: /var/lib/gitea/{data,indexers,log}sudo chmod 750 /var/lib/gitea/{data,indexers,log}sudo mkdir /etc/giteasudo chown root:git /etc/giteasudo chmod 770 /etc/gitea
Die obige Verzeichnisstruktur wird von der offiziellen Gitea-Dokumentation empfohlen.
Die Berechtigungen der Datei /etc/gitea Verzeichnis sind auf 770 gesetzt damit der Installationsassistent die Konfigurationsdatei erstellen kann. Sobald die Installation abgeschlossen ist, werden wir restriktivere Berechtigungen festlegen.
Erstellen Sie eine Systemd-Unit-Datei #
Gitea stellt eine Systemd-Unit-Datei bereit, die bereits so konfiguriert ist, dass sie unserem Setup entspricht.
Laden Sie die Datei in /etc/systemd/system/ herunter Verzeichnis durch Eingabe von:
sudo wget https://raw.githubusercontent.com/go-gitea/gitea/master/contrib/systemd/gitea.service -P /etc/systemd/system/Wenn Sie fertig sind, aktivieren und starten Sie den Gitea-Dienst:
sudo systemctl daemon-reloadsudo systemctl enable --now gitea
Überprüfen Sie, ob der Dienst erfolgreich gestartet wurde:
sudo systemctl status gitea● gitea.service - Gitea (Git with a cup of tea)
Loaded: loaded (/etc/systemd/system/gitea.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2020-01-04 21:27:23 UTC; 3s ago
Main PID: 14804 (gitea)
Tasks: 9 (limit: 1152)
CGroup: /system.slice/gitea.service
└─14804 /usr/local/bin/gitea web --config /etc/gitea/app.ini
...
Gitea konfigurieren #
Nachdem Gitea heruntergeladen wurde und ausgeführt wird, ist es an der Zeit, die Installation über die Weboberfläche abzuschließen.
Standardmäßig wartet Gitea auf Port 3000 auf Verbindungen auf allen Netzwerkschnittstellen.
Wenn auf Ihrem Server eine UFW-Firewall läuft, müssen Sie den Gitea-Port öffnen:
Um Datenverkehr auf Port 3000 zuzulassen , geben Sie den folgenden Befehl ein:
sudo ufw allow 3000/tcp
Öffnen Sie Ihren Browser und geben Sie http://YOUR_DOMAIN_IR_IP:3000 ein , und ein Bildschirm ähnlich dem folgenden wird angezeigt:
Datenbankeinstellungen:
- Datenbanktyp:SQLite3
- Pfad:Verwenden Sie einen absoluten Pfad,
/var/lib/gitea/data/gitea.db
Allgemeine Anwendungseinstellungen:
- Site-Titel:Geben Sie den Namen Ihrer Organisation ein.
- Repository-Stammpfad:Belassen Sie den Standard
/home/git/gitea-repositories. - Git-LFS-Stammpfad:Belassen Sie den Standard
/var/lib/gitea/data/lfs. - Als Benutzername ausführen:git
- SSH-Serverdomäne:Geben Sie Ihre Domäne oder Server-IP-Adresse ein.
- SSH-Port:22, ändern Sie ihn, wenn SSH auf einem anderen Port lauscht
- Gitea HTTP Listen Port:3000
- Gitea-Basis-URL:Verwenden Sie http und Ihre Domain- oder Server-IP-Adresse.
- Protokollpfad:Belassen Sie den Standard
/var/lib/gitea/log
Wenn Sie fertig sind, klicken Sie auf die Schaltfläche „Gitea installieren“. Die Installation erfolgt sofort. Wenn Sie fertig sind, werden Sie zur Anmeldeseite weitergeleitet.
Klicken Sie auf den Link „Jetzt anmelden“. Der erste registrierte Benutzer wird automatisch zur Admin-Gruppe hinzugefügt.
Ändern Sie die Berechtigungen der Gitea-Konfigurationsdatei in schreibgeschützt mit:
sudo chmod 750 /etc/giteasudo chmod 640 /etc/gitea/app.ini
Das ist es. Gitea wurde auf Ihrem Ubuntu-Rechner installiert.
Konfigurieren von Nginx als SSL-Terminierungsproxy #
Dieser Schritt ist optional, wird aber dringend empfohlen. Um Nginx als Reverse-Proxy zu verwenden, benötigen Sie eine Domain oder Subdomain, die auf die öffentliche IP Ihres Servers verweist. In diesem Tutorial verwenden wir git.example.com .
Installieren Sie zunächst Nginx und generieren Sie mithilfe der folgenden Anleitungen ein kostenloses SSL-Zertifikat von Let’s Encrypt:
- So installieren Sie Nginx unter Ubuntu 18.04
- Nginx mit Let’s Encrypt auf Ubuntu 18.04 sichern
Sobald Sie fertig sind, öffnen Sie Ihren Texteditor und bearbeiten Sie die Blockdatei des Domänenservers:
sudo nano /etc/nginx/sites-enabled/git.example.comserver {
listen 80;
server_name git.example.com;
include snippets/letsencrypt.conf;
return 301 https://git.example.com$request_uri;
}
server {
listen 443 ssl http2;
server_name git.example.com;
proxy_read_timeout 720s;
proxy_connect_timeout 720s;
proxy_send_timeout 720s;
client_max_body_size 50m;
# Proxy headers
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
# SSL parameters
ssl_certificate /etc/letsencrypt/live/git.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/git.example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/git.example.com/chain.pem;
include snippets/letsencrypt.conf;
include snippets/ssl.conf;
# log files
access_log /var/log/nginx/git.example.com.access.log;
error_log /var/log/nginx/git.example.com.error.log;
# Handle / requests
location / {
proxy_redirect off;
proxy_pass http://127.0.0.1:3000;
}
}
Vergessen Sie nicht, git.example.com durch Ihre Gitea-Domain zu ersetzen und den richtigen Pfad zu den SSL-Zertifikatsdateien festzulegen. Der HTTP-Datenverkehr wird auf HTTPS umgeleitet
Starten Sie den Nginx-Dienst neu, damit die Änderungen wirksam werden:
sudo systemctl restart nginxÄndern Sie als Nächstes die Gitea-Domäne und die Stamm-URL. Öffnen Sie dazu die Konfigurationsdatei und bearbeiten Sie die folgenden Zeilen:
sudo nano /etc/gitea/app.ini[server]
DOMAIN = git.example.com
ROOT_URL = https://git.example.com/
Starten Sie den Gitea-Dienst neu, indem Sie Folgendes eingeben:
sudo systemctl restart gitea
An diesem Punkt ist der Gitea-Proxy konfiguriert und Sie können darauf zugreifen unter:https://git.example.com
E-Mail-Benachrichtigungen konfigurieren #
Damit Gitea Benachrichtigungs-E-Mails senden kann, können Sie entweder Postfix installieren oder einen Transaktions-Mail-Dienst wie SendGrid, MailChimp, MailGun oder SES verwenden.
Um E-Mail-Benachrichtigungen zu aktivieren, öffnen Sie die Konfigurationsdatei und bearbeiten Sie die folgenden Zeilen:
sudo nano /etc/gitea/app.ini[mailer]
ENABLED = true
HOST = SMTP_SERVER:SMTP_PORT
FROM = SENDER_EMAIL
USER = SMTP_USER
PASSWD = YOUR_SMTP_PASSWORD
Stellen Sie sicher, dass Sie die richtigen SMTP-Serverinformationen eingeben.
Starten Sie den Gitea-Dienst neu, damit die Änderungen wirksam werden:
sudo systemctl restart giteaUm die Einstellungen zu überprüfen und eine Test-E-Mail zu senden, melden Sie sich bei Gitea an und gehen Sie zu:Site-Administration> Konfiguration> SMTP-Mailer-Konfiguration.
Gitea ermöglicht es Ihnen auch, sich mit Slack zu verbinden, indem Sie einen Web-Webhook erstellen und Benachrichtigungen an Ihre Slack-Kanäle senden.
Aktualisiere Gitea #
Um auf die neueste Gitea-Version zu aktualisieren, laden Sie einfach die Binärdatei herunter und ersetzen Sie sie.
-
Stoppen Sie den Gitea-Dienst:
sudo systemctl stop gitea -
Laden Sie die neueste Gitea-Version herunter und verschieben Sie sie nach
/usr/local/binVerzeichnis:VERSION=<THE_LATEST_GITEA_VERSION>wget -O /tmp/gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64sudo mv /tmp/gitea /usr/local/bin -
Machen Sie die Binärdatei ausführbar:
sudo chmod +x /usr/local/bin/gitea -
Starten Sie den Gitea-Dienst neu:
sudo systemctl restart gitea
Das ist es.