Hostsharing Wiki - Benutzerbeiträge [de]

Gitea

2019-02-04T08:44:43Z

Hsh00-mih: Einrücking in monitrc wiederhergestellt

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel <code>xyz00-gitea</code>.

2. Anlegen einer Domain. In unserem Beispiel <code>gitea.hs-example.de</code>.

3. Anlegen eines Datenbank-Benutzers. Hier <code>xyz00_giteadbuser</code>.

4. Anlegen einer Datenbank. Hier <code>xyz00_giteadb</code>.

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl <code>hsscript</code>:

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',shell:'/bin/bash'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary (hier die 64-Bit-Version,
für die shared Server h01 bis h08 bitte die 32-Bit-Version gitea-1.7.0-linux-i386 herunterladen).

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis <code>doms/gitea.hs-example.de</code> und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei <code>htdocs-ssl/.htaccess</code> mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea <code>app.ini</code>.
Sie befindet sich in dem Verzeichnis <code>~/custom/conf</code>.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = geheim
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Der Git-Service ist dann im Browser unter der Adresse gitea.hs-example.de erreichbar.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad <code>~/bin/gitea-start.sh</code> ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad <code>~/bin/gitea-stop.sh</code> an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei <code>~/.monitrc</code> mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de
#
check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei <code>~/.logrotate</code>:

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-02-04T08:36:13Z

Hsh00-mih: gitea-stopp.sh -> gitea-stop.sh um es konsistent haben, sowie zusammengehörige Zeilen einer Datei zusammengeführt

Eigene PHP Version

2019-01-01T16:53:02Z

Hsh00-mih: Anpassungen bzgl. "--with-curl" und "--with-openssl" sowie "/fastcgi-bin"

{{Textkasten|gelb|Aktuelle PHP Version|Dieser Artikel bezieht sich auf ältere PHP Versionen.
Wer eine aktuellere PHP-Version benötigt als in Debian Stable vorhanden, folgt bitte der Anleitung [[Aktuelles_PHP_mit_phpenv]]}}

Falls Anwendungen nach dem Upgrade auf Jessie übergangsweise eine ältere PHP-Version benötigen, kann im Paket eine
eigene Version compiliert werden.

<pre>
mkdir php54
cd php54
wget http://de1.php.net/distributions/php-5.4.45.tar.gz
tar zxf php-5.4.45.tar.gz
</pre>

<pre>
./configure --prefix $HOME/php-5.4.45 --enable-mbstring --with-xmlrpc --enable-soap --enable-zip --with-gd --with-jpeg-dir --with-png-dir --with-freetype-dir --enable-intl --with-xsl --with-mysqli=/usr/bin/mysql_config --with-pdo-mysql --enable-pdo=shared --with-pdo-mysql=shared --with-pdo-sqlite=shared --with-zlib --with-mysql

# eigentlich auch noch --with-curl --with-openssl
# die jedoch ggf. inkompatibel zu den aktuellen Bibliotheken bei Hostsharing sind
# oft kann man jedoch darauf verzichten

make
make install
</pre>

Hardlink:
<pre>
ln php-cgi /home/pacs/xyz00/users/xyz/php-5.4.45/bin/php-cgi
</pre>

oder eine eigenes phpstub, falls ein Hardlink nicht erwünscht ist:

Dazu die Dateien aus /usr/local/src/phpstub in folgendes Verzeichnis
kopieren:

<pre>
php/phpstub
</pre>

in der phpstub.c den folgenden Pfad geändert:

<pre>
execl("/home/pacs/xyz00/php-5.4.45/bin/php-cgi", "php", NULL);
make
</pre>

Die erzeugte phpstub als myphpstub in die entsprechenden Domain
fastcgi[-ssl] Verzeichnisse kopieren.

Weiter die
<pre>
/etc/php5/cgi/php.ini
</pre>

nach ./fastcgi kopiert.

'''ACHTUNG:''' killall php -u $USER wirkt nicht, prozesse mit ps aux kontrolliert und kill

Änderung der .htaccess der entsprechenden Domains
<pre>
AddType application/x-httpd-phpfastcgi .php
Action application/x-httpd-phpfastcgi /fastcgi-bin/myphpstub
</pre>

/fastcgi-bin ist dabei kein echtes Verzeichnis, sondern ist in der Apache Konfiguration (/etc/apache2/sites-available/example.com) definierter Alias.

== Mögliche Probleme mit MySQL-Passwort umgehen ==

Alle hsadmin definierte MySQL-Passworte sind aus Kompatibilitätsgründen als 16-Byte-Zeichenkette gespeichert.
Um das zu umgehen, ändern Sie das Passwort mit MySQL-Mitteln:
<pre>
xyz00@h0x:~$ mysql -u xyz00_mysql -p
Enter password:

mysql> SET SESSION old_passwords=0;
mysql> SET PASSWORD FOR 'xyz00_mysql'@'%' = PASSWORD('geheim');
</pre>

Damit wir das Passwort als 41-Byte-Zeichenkette gespeichert.

ACHTUNG: Nach jeder Änderung mit hsadmin wird wieder ein 16-Byte-Hash gespeichert!

----
[[Kategorie:HSDoku]]
[[Kategorie:Upgrade Wheezy zu Jessie]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]