Sådan installeres Gitea på Debian 9

Gitea er et alternativt open source, selvhostet versionskontrolsystem drevet af Git. Gitea er skrevet i Golang og er en letvægtsløsning, der skal hostes på enhver platform.

Forudsætninger

• Ny Vultr Debian 9-instans.
• Ikke-root-bruger med sudoprivilegier.
• Nginx
• Git
• MariaDB

Trin 1: Installer Nginx

Opdater din pakkeliste.

sudo apt update

Installer Nginx.

sudo apt -y install nginx

Når installationen er fuldført, skal du køre følgende kommandoer for at starte og aktivere Nginx-tjenesten.

sudo systemctl enable nginx.service
sudo systemctl start nginx.service

Trin 2: Installer Git

Dette kan gøres med følgende kommando.

sudo apt -y install git

Trin 3: Installer MariaDB Database Server

Gitea understøtter følgende databaseservere.

• MariaDB/MySQL
• PostgreSQL
• SQLite
• TiDB

Til denne tutorial vil vi bruge MariaDB-serveren og -klienten.

sudo apt -y install mariadb-server mariadb-client

Når du er færdig, skal du sørge for, at MariaDB er aktiveret og kører.

sudo systemctl enable mariadb.service
sudo systemctl start mariadb.service

Kør derefter kommandoen nedenfor for at sikre MariaDB-serveren ved at oprette en root-adgangskode og ikke tillade ekstern root-adgang.

sudo mysql_secure_installation

Når du bliver bedt om det, skal du besvare spørgsmålene nedenfor ved at følge vejledningen.

Enter current password for root (enter for none): Just press the Enter
Set root password? [Y/n]: Y
New password: Enter password
Re-enter new password: Repeat password
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]:  Y
Reload privilege tables now? [Y/n]:  Y

Genstart MariaDB.

sudo systemctl restart mariadb.service

Indtast kommandoen nedenfor for at logge ind på MariaDB-konsollen.

sudo mysql -u root -p

Indtast derefter den adgangskode, du oprettede ovenfor, for at logge ind. Du vil se MariaDB-velkomstbeskeden.

Opret en database kaldet gitea.

CREATE DATABASE gitea;

Opret en databasebruger kaldet giteausermed en ny adgangskode.

CREATE USER 'giteauser'@'localhost' IDENTIFIED BY 'new_password_here';

Sørg for at erstatte new_password_heremed en stærk og kompleks adgangskode.

Giv derefter brugeren fuld adgang til databasen.

GRANT ALL ON gitea.* TO 'giteauser'@'localhost' IDENTIFIED BY 'user_password_here' WITH GRANT OPTION;

Gem til sidst dine ændringer og afslut.

FLUSH PRIVILEGES;
EXIT;

Trin 4: Forbered Gitea-miljøet

Opret en bruger til at køre Gitea.

sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git

Opret den nødvendige mappestruktur.

sudo mkdir -p /var/lib/gitea/{custom,data,indexers,public,log}
sudo chown git:git /var/lib/gitea/{data,indexers,log}
sudo chmod 750 /var/lib/gitea/{data,indexers,log}
sudo mkdir /etc/gitea
sudo chown root:git /etc/gitea
sudo chmod 770 /etc/gitea

Trin 5: Installer Gitea

Gitea binær kan downloades ved at køre følgende kommandoer.

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

Kopier det binære til en global placering.

sudo cp gitea /usr/local/bin/gitea

Trin 6: Opret en servicefil for at starte Gitea automatisk

Opret en linux servicefil.

sudo touch /etc/systemd/system/gitea.service

Brug en teksteditor efter eget valg, åbn denne nyoprettede fil og udfyld hvis med følgende.

[Unit]
Description=Gitea (Git with a cup of tea)
After=syslog.target
After=network.target
After=mariadb.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
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
# 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

Aktiver og start Gitea ved opstart.

sudo systemctl daemon-reload
sudo systemctl enable gitea
sudo systemctl start gitea

Sørg for, at Gitea kører.

sudo systemctl status gitea

Trin 7: Konfigurer Nginx som en omvendt proxy

Slet standard nginx-konfigurationsfilen.

sudo rm /etc/nginx/sites-enabled/default

Opret en omvendt proxy-konfiguration for Gitea.

sudo touch /etc/nginx/sites-available/git

Udfyld filen med følgende konfiguration, sørg for at erstatte example.commed dit domænenavn eller IP-adresse.

upstream gitea {
    server 127.0.0.1:3000;
}

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name example.com;
    root /var/lib/gitea/public;
    access_log off;
    error_log off;

    location / {
      try_files maintain.html $uri $uri/index.html @node;
    }

    location @node {
      client_max_body_size 0;
      proxy_pass http://localhost:3000;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header Host $http_host;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_max_temp_file_size 0;
      proxy_redirect off;
      proxy_read_timeout 120;
    }
}

Aktiver Gitea Nginx omvendt proxy-konfiguration.

sudo ln -s /etc/nginx/sites-available/git /etc/nginx/sites-enabled/git

Genindlæs derefter Nginx-tjenesten.

sudo systemctl reload nginx.service

Åbn derefter din browser og gå til serverens værtsnavn eller IP-adresse.

http://YOUR_SERVER_IP/install

Følg instruktionerne på skærmen for at fuldføre Gitea-opsætningen.