[TUT] Gitea - Schlanke GIT Variante

Hi zusammen,

In diesem Tutorial stelle ich Euch eine Anleitung zur Verfügung, mit der ihr die Entwicklungsplattform Gitea installieren könnt. Gitea ist ein minimalistischer Git-Server, mit dem man seine Softwareprojekte verwalten kann (Versionsverwaltung, Bug Tracker, Wiki etc.)

Voraussetzungen:

• installiertes Macvlan (entweder bordintern oder über dieses Tutorial: [TUT] MacVlan konfigurieren - Schritt für Schritt Anleitung )
• Portainer Stacks oder bordintern Docker Projekt (für Portainer: [TUT] Portainer - Installationsanleitung)
• Watchtower (wenn automatische Updates erwünscht sind): [TUT] Watchtower - Automatische Updates für Docker Container

Vorbereitung (Ermittlung von UID und GID):

1. Per SSH auf Eere NAS verbinden (muss natürlich aktiviert sein)
2. Mit eurem Admin-Account anmelden
3. id ausführen
4. Werte für UID und GID notieren

Installation:

1. Dateimanager öffnen
2. Verzeichnis gitea im Docker-Verzeichnis erzeugen
3. Im Portainer neuen Stack oder im Docker neues Projekt (Compose-Konfiguration) mit Namen "gitea" anlegen
4. folgenden Code in die Konfiguration kopieren:

services:
    server:
        image: docker.gitea.com/gitea:latest
        container_name: Gitea
        hostname: Gitea
        restart: unless-stopped
        volumes:
            - /volume1/docker/gitea:/data
            - /volume2/gitea-repositories:/data/git/repositories    # Verzeichnis für Repositories, löschen wenn kein eigenes Verzeichnis gewünscht
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
        ports:
            - '3000:3000'               # Port für Webzugriff
            - '22:22'                   # Port für SSH-Zugriff
        environment:
            - USER_UID=1000
            - USER_GID=10
            - GITEA__SERVER__ROOT_URL=http://192.168.178.200/      # Gewünschte (Sub-)Domain eintragen
        labels:
            - "com.centurylinklabs.watchtower.enable=true"  # Watchtower Label für automatische Updates  
        networks:
            default:
                ipv4_address: 192.168.178.200       # IP-Adresse gemäß eigenen Wünschen anpassen

networks:
    default:
        name: mvl           # Namen entsprechend eigenem MacVlan anpassen
        external: true

5. Deploy bzw. Bereit stellen
6. Gitea ist über http://192.168.178.200:3000 erreichbar

Hinweise:

• Beim ersten Aufruf der Webseite kommt man zur Erstkonfiguration.
• Keine Verzeichnispfade in der Erstkonfiguration ändern, es sei denn, man weiß genau, was man tut. Das Verzeichnis kann im Compose code (siehe oben) geändert werden.
• Ist eine E-Mail-Benachrichtigung erwünscht, muss hier auch gleich ein entsprechender Server und Zugangsdaten eingetragen werden. Ein nachträgliches Aktivieren ist schwierig bis nicht möglich.
• Es empfiehlt sich auch gleich einen Administrator anzulegen. Ansonsten ist der erste registrierte Benutze automatisch Administrator.
• Soll Gitea direkt unter einer (Sub-)Domain erreichbar sein (direkt oder z.B. per nginx), muss der entsprechende Environment-Eintrag angepasst werden (ROOT_URL).

Viel Spaß damit