HTTP Git Server s Nginx na Debian 8

Git je systém správy verzií (VCS), ktorý umožňuje sledovanie zmien v kóde. V tomto návode si prejdeme inštaláciou servera HTTP(S) Git a pridaním overenia používateľského mena/hesla.

Predpoklady

• Debian 8 (Jessie).
• Sudo .
• Textový editor podľa vášho výberu ( nano, vim).

Inštalácia potrebného softvéru

Budeme potrebovať nginx, git, fcgiwrapa apache httpd utils. Pokračujte a zadajte do terminálu.

sudo apt-get install nginx git fcgiwrap apache2-utils

dpkg will fail to install Nginx if another process (such as Apache) is already bound to port 80.

Vytvorenie adresára Git

Za predpokladu, že by ste chceli vytvoriť adresár git na adrese /var/www/git, budete musieť spustiť nasledujúce príkazy:

mkdir /var/www/git
chown www-data:www-data /var/www/git # Make sure www-data (the user fastcgi runs) from has permissions.

Konfigurácia Nginx

Teraz musíme nakonfigurovať Nginx tak, aby prenášal návštevnosť Git do Gitu. Toto je možné pridať do predvolenej konfigurácie, vlastnej server {}na /etc/nginx/conf.dalebo /etc/nginx/sites-enabled.

The configuration file's parameters and directive must be added in the order in which they are listed below.

location ~ (/.*) {
    client_max_body_size 0; # Git pushes can be massive, just to make sure nginx doesn't suddenly cut the connection add this.
    auth_basic "Git Login"; # Whatever text will do.
    auth_basic_user_file "/var/www/git/htpasswd";
    include /etc/nginx/fastcgi_params; # Include the default fastcgi configs
    fastcgi_param SCRIPT_FILENAME /usr/lib/git-core/git-http-backend; # Tells fastcgi to pass the request to the git http backend executable
    fastcgi_param GIT_HTTP_EXPORT_ALL "";
    fastcgi_param GIT_PROJECT_ROOT /var/www/git; # /var/www/git is the location of all of your git repositories.
    fastcgi_param REMOTE_USER $remote_user;
    fastcgi_param PATH_INFO $1; # Takes the capture group from our location directive and gives git that.
    fastcgi_pass  unix:/var/run/fcgiwrap.socket; # Pass the request to fastcgi
}

Ak by ste chceli mať svoje git repozitáre v podadresári, napr. http://your-domain.com/reposurobte prvý riadok location ~ /repos(/.*) {, je to regulárny výraz.

Make sure the server_name directive in your server {} doesn't clash with anything else or else Nginx wont pass the request on.

Pridanie overenia heslom

Nginx prijíma htpasswdsúbory Apache , na ich vytvorenie budeme musieť vykonať nasledujúci príkaz:

htpasswd -c /var/www/git/htpasswd <your username>

Zobrazí sa výzva na zadanie hesla. Ak chcete pridať ďalších používateľov, postupujte takto:

htpasswd /var/www/git/htpasswd <another username>

Posledný krok

Nezabudnite znova načítať Nginx, aby ste použili všetky zmeny spustením:

sudo service nginx reload

Teraz máte súkromný server Git! Užite si to.

(Voliteľné) Vytvorte skript, ktorý inicializuje úložiská Git

Upozorňujeme, že www-data(používateľský účet, pod ktorým FastCGI beží) musí mať prístup na čítanie a zápis do úložiska Git. Vytvorenie skriptu teraz šetrí bolesti hlavy neskôr.

Otvorte súbor skriptu, napr. /var/www/git/gitinit.sha vložte nasledovné:

#!/bin/sh
sudo -u www-data mkdir $1
cd $1
sudo -u www-data git init --bare

Skript môžete spustiť takto:

cd /var/www/git
./gitinit.sh repo-name

Nezabudnite povoliť spustenie spustením:

chmod +x /var/www/git/gitinit.sh