Wer nach einem Update der macOS-Installationen ein Befehl wie z.B. Git eingeben möchte und folgende Meldung erhält:
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun
muss die Command Line Developer Tools mittels des Befehls:
xcode-select --install
nachinstallieren. Danach können die Befehle im Terminal wie gewohnt ausgeführt werden.
Auf dem Markt existieren eine Reihe von Git-Clients für die unterschiedlichsten Systeme. Unter macOS nutze ich neben dem Terminal den freien Git-Client GitX. Allerdings wird dieser seit einiger Zeit nicht mehr aktiv weiter entwickelt, sodass ich auf der Suche nach einer Alternative war. Fündig geworden bin ich beim Git-Client Fork.
Der Git-Client Fork mit einem geöffneten Git-Repository
Neben den klassischen Funktionalitäten, bietet Fork erweiterte Funktionalität zur Auflösung von Merge-Konflikten sowie eine interaktive Rebase-Funktionalität. Bezogen werden kann der Client über die offizielle Seite unter git-fork.com. Fork steht für macOS und Windows zur Verfügung. Vertrieben wird der Client als Freeware.
In den letzten Monaten überarbeitete ich mein Buch Selfhosting: Server aufsetzen und betreiben. Wie der Name es andeutet, handelt das Buch vom Betrieb eines eigenen Servers. Im Grunde geht es darum einen Server und seine Dienste aufzusetzen und zu betreiben. Als Betriebssystem wird Ubuntu 18.04 LTS genutzt. Die erste Version erschien im Juli 2015, was mittlerweile knapp vier Jahre her ist. Unter anderem deswegen wurde das Buch komplett überarbeitet.
Der Umfang des Buches hat um 65 Prozent, gegenüber der ersten Version zugenommen. Neben der kompletten Umstellung auf Ubuntu 18.04 LTS wurden viele weitere Themen in das Buch aufgenommen, so wird nun detailliert auf die Erzeugung von Zertifikaten mittels Let’s Encrypt eingegangen, es wird die Aktualisierung des Servers oder die Nutzung von MariaDB genauer beleuchtet und es wurde auf viele weitere Themen genauer und umfangreicher eingegangen.
Die neue Version von Selfhosting ist nun verfügbar
Nach einer kurzen Einleitung behandelt das Buch die Beschaffung eines Servers, die anschließende Installation und Grundeinrichtung. Dazwischen werden benötigte Linux-Grundlagen vermittelt. Nach der Grundeinrichtung werden speziellere Setups, wie Virtualisierung mittels KVM und verschlüsselte Server, beschrieben. Anschließend geht es an die Einrichtung unterschiedlichster Servertypen, wie Mail-, Game- oder Webserver. Neben diesen werden weitere Dienste wie Git und XMPP besprochen. In den weiteren Abschnitten des Buches wird auf Themen wie das Backup von Servern, der Sicherheit, Wartung und Verwaltung derselben eingegangen.
Erhältlich ist das Buch unter anderem bei Amazon, Beam, Google Play, eBook.de und iTunes. Bei den meisten Anbietern, wird das Buch, wenn es bereits gekauft wurde, automatisch aktualisiert. Weitere Informationen über das Buch befinden sich auf der entsprechenden Seite.
Nach der Installation von Gitea läuft dieses standardmäßig über unverschlüsseltes HTTP. Um dies zu ändern muss die app.ini welche sich im Verzeichnis /home/git/gitea/custom/conf/ befindet bearbeitet werden:
nano /home/git/gitea/custom/conf/app.ini
In der Sektion server welche für gewöhnlich wie folgt aussieht:
[server] SSH_DOMAIN = localhost DOMAIN = localhost HTTP_PORT = 3000 ROOT_URL = http://example.org:3000/ DISABLE_SSH = false SSH_PORT = 22 LFS_START_SERVER = true LFS_CONTENT_PATH = /home/git/gitea/data/lfs LFS_JWT_SECRET = plgd0f1J4RlmWFnk9K4oHeV6Wey_vI55x7uC81Rp5Mc OFFLINE_MODE = false
müssen einige Änderungen vorgenommen werden. Die Schlüssel PROTOCOL, CERT_FILE und KEY_FILE müssen hinzugefügt und die ROOT_URL angepasst werden. Danach sollte die server-Sektion in etwa so aussehen:
[server] SSH_DOMAIN = localhost DOMAIN = localhost HTTP_PORT = 3000 PROTOCOL = https CERT_FILE = custom/https/cert.pem KEY_FILE = custom/https/key.pem ROOT_URL = https://example.org:3000/ DISABLE_SSH = false SSH_PORT = 22 LFS_START_SERVER = true LFS_CONTENT_PATH = /home/git/gitea/data/lfs LFS_JWT_SECRET = plgd0f1J4RlmWFnk9K4oHeV6Wey_vI55x7uC81Rp5Mc OFFLINE_MODE = false
Nachdem die Konfiguration gespeichert wurde muss das passende Zertifikat erzeugt werden:
cd /home/git/gitea/custom/ mkdir https cd https ./gitea cert -ca=true -duration=8760h0m0s -host=example.org
Alternativ und in den meisten Fall sinnvoller ist es allerdings an dieser Stelle Zertifikate von Let’s Encrypt einzubinden. Dazu müssen die Zertifikate für die Domain im ersten Schritt erzeugt werden:
letsencrypt certonly
Anschließend muss die app.ini angepasst werden:
nano /home/git/gitea/custom/conf/app.ini
Dort werden die Werte für CERT_FILE und KEY_FILE so konfiguriert das sie auf die Let’s Encrypt-Zertifikate zeigen:
CERT_FILE = /etc/letsencrypt/live/example.org/fullchain.pem KEY_FILE = /etc/letsencrypt/live/example.org/privkey.pem
Damit ist Gitea nach einem Neustart des Service per HTTPS und damit verschlüsselt erreichbar.
Vor ein paar Jahren schrieb ich eine Anleitung, in der es darum ging Gogs zu installieren. Schon damals hatte sich eine Abspaltung unter dem Namen Gitea herausgelöst, welche einen Community zentrierten Ansatz bei der Entwicklung fuhr. Gitea ist eine vollwertige Lösung, welche einen Git-Server, eine Weboberfläche und weitere Entwicklerwerkzeuge, wie einen Bugtracker und eine Wiki bereitstellt.
Gitea
Zur Installation von Gitea muss im ersten Schritt Git installiert werden:
apt-get install git
Nachdem dies geschehen ist, wird ein Nutzer für Gitea angelegt und in dessen Kontext gewechselt:
adduser --disabled-password --gecos "" git su git cd
Nun kann Gitea heruntergeladen werden. Dazu muss der passende Download-Link über die Projektseite ermittelt werden:
wget https://dl.gitea.io/gitea/1.8.3/gitea-1.8.3-linux-amd64
Im Normalfall sollte hierbei die Linux-AMD64-Version genutzt werden. Nach dem Download kann Gitea für den ersten Testlauf gestartet werden:
mkdir gitea mv gitea-1.8.3-linux-amd64 gitea/gitea cd gitea chmod 755 gitea ./gitea
Nach dem Start kann Gitea im Browser unter der URL aufgerufen werden:
http://example.org:3000/
Sobald der erste Testlauf erfolgreich durchgeführt wurde, sollte Gitea wieder beendet werden. Im nächsten Schritt muss die systemd-Unit eingerichtet werden, welche dafür sorgt, dass der Service automatisch gestartet wird. Dazu wird im ersten Schritt die entsprechende Datei angelegt:
nano /etc/systemd/system/gitea.service
Diese Datei wird nun mit folgendem Inhalt befüllt:
[Unit] Description=Gitea (Git with a cup of tea) After=syslog.target After=network.target #After=mysqld.service #After=postgresql.service #After=memcached.service #After=redis.service [Service] # Modify these two values and uncomment them if you have # repos with lots of files and get an HTTP error 500 because # of that ### #LimitMEMLOCK=infinity #LimitNOFILE=65535 Type=simple User=git Group=git WorkingDirectory=/home/git/gitea ExecStart=/home/git/gitea/gitea web Restart=always Environment=USER=git HOME=/home/git # If you want to bind Gitea to a port below 1024 uncomment # the two values below ### #CapabilityBoundingSet=CAP_NET_BIND_SERVICE #AmbientCapabilities=CAP_NET_BIND_SERVICE [Install] WantedBy=multi-user.target
Nachdem die systemd-Unit angelegt wurde, kann sie aktiviert und gestartet werden:
systemctl enable gitea systemctl start gitea
Damit wird Gitea automatisch gestartet und läuft als Service im Hintergrund. Im Browser kann Gitea nun aufgerufen werden und installiert werden. Dazu wird der Anmelden-Button in der Weboberfläche gedrückt oder alternativ die URL:
http://example.org:3000/install
aufgerufen. In der Installationsroutine wird unter anderem die Datenbank-Verbindung definiert und es besteht die Möglichkeit einen administrativen Nutzer anzulegen. Für kleinere Installation kann SQLite3 als Datenbank-Backend bedenkenlos genutzt werden.
Sollten Fehler bei der Installation des Services oder bei Gitea aufgetreten sein, so lohnt es sich in das systemd-Log mittels:
systemctl status gitea
hineinzuschauen. Das Gitea-eigenen Logs befindet sich bei dieser Installation unter /home/git/gitea/log/:
/home/git/gitea/log/gitea.log /home/git/gitea/log/http.log /home/git/gitea/log/xorm.log