Ako nainštalovať GitBucket na Ubuntu 16.04

Táto príručka pokrýva základnú inštaláciu a nastavenie GitBucket pre inštanciu Vultr so systémom Ubuntu 16.04 a predpokladá, že príkazy vykonávate ako non-rootpoužívateľ.

Predpoklady

• Inštancia servera Vultr s aspoň 1 GB pamäte RAM (menšie inštancie môžu fungovať, aj keď pomaly).
• openjdk-8-jre Povinné, staršie verzie nebudú fungovať.
• wget Používa sa na stiahnutie balíka GitBucket.
• nginx Voliteľné poskytuje reverzný proxy server GitBucket
• systemd Spravuje spustenie a zastavenie procesu GitBucket

Predpoklady inštalácie

GitBucket vyžaduje, aby bola na vašom serveri nainštalovaná Java 8 alebo novšia. Ak ste ešte nenainštalovali Java 8, najprv aktualizujte zoznam lokálnych balíkov.

sudo apt update

Potom nainštalujte balík Java 8 runtime.

sudo apt install openjdk-8-jre

Inštalácia GitBucket

Vytvorenie neprivilegovaného používateľa

Skôr ako budeme pokračovať, budeme musieť vytvoriť neprivilegovaného používateľa, ktorý bude spúšťať GitBucket. Spustenie GitBucket pod neprivilegovaným používateľom obmedzuje našu inštaláciu v zapisovaní mimo jej vlastného adresára údajov, čím sa posilňuje bezpečnosť vášho servera. Spustite nasledujúci príkaz na vytvorenie systémového užívateľa s názvom gitbucket.

sudo adduser --system gitbucket

Pretože sme vytvorili systémového užívateľa, predvolený shell je /bin/false, a ak pri spustení nezadáme ďalší argument shellu , vrátime sa späť do nášho aktuálneho shellu su. Prihláste sa k novovytvorenému používateľovi.

sudo su - gitbucket -s /bin/bash

Výzva vášho shellu by sa mala zmeniť a budete prihlásený do nového systémového používateľa.

Sťahovanie/aktualizácia GitBucket

Prejdite na stránku vydaní GitBucket a nájdite najnovšiu dostupnú verziu. Skopírujte adresu URL gitbucket.warbalíka, skontrolujte, či ste v domovskom adresári nového používateľa, a stiahnite si ho pomocou wget.

cd ~/
wget https://github.com/gitbucket/gitbucket/releases/download/4.18.0/gitbucket.war

Tento krok budete musieť zopakovať zakaždým, keď budete chcieť aktualizovať balík GitBucket.

Počiatočná konfigurácia GitBucket

Po stiahnutí balíka budeme musieť manuálne spustiť GitBucket, aby sme vykonali počiatočnú konfiguráciu.

java -jar gitbucket.war --port 8080

Ak je port 8080už obsadený iným procesom, môžete zmeniť port, na ktorom bude GitBucket počúvať. Táto príručka predpokladá, že GitBucket počúva na porte8080 .

Toto spustí GitBucket na verejnom sieťovom rozhraní vášho servera a bude počúvať na zadanom porte. Po chvíli by ste mali vidieť nasledujúcu správu.

INFO:oejs.Server:main: Started @15891ms

Ak používate bránu firewall spoločnosti Vultr , budete musieť otvoriť port, na ktorom GitBucket počúva, pretože brána firewall Vultr funguje ako biely zoznam a odmieta prenos, aby povolil porty, pokiaľ nie je uvedené inak.

Vaša inštalácia GitBucket by teraz mala byť online a prístupná z internetu. Pomocou webového prehliadača sa pripojte k verejnej adrese vášho servera (uistite sa, že zadáte port, na ktorom GitBucket beží, (tj http://203.0.113.0:8080alebo http://example.com:8080), a dostanete sa na domovskú stránku GitBucket.

Je však potrebné zmeniť heslo predvoleného účtu správcu. Ak to chcete urobiť, prihláste sa do účtu správcu pomocou Sign intlačidla v pravej hornej časti webového rozhrania. Predvolené prihlásenie pre účet správcu je rootpre meno používateľa a potom rootznova pre heslo. Po prihlásení sa tlačidlo nahradí ikonou profilu a rozbaľovacím zoznamom. Rozbaľte rozbaľovaciu ponuku a vyberte položku Account Settingsa potom nastavte nové, bezpečnejšie heslo v sprievodcovi nastavením účtu.

Po aktualizácii prihlasovacích údajov predvoleného administrátorského účtu a overení, že GitBucket sa spúšťa v tejto minimálnej konfigurácii, ukončite proces Java pomocou " CTRL+C" a zatvorte aktuálny shell pomocou exit.

Vytvorenie služby Systemd

V súčasnosti môžeme GitBucket spustiť iba tak, že pristúpime na náš server cez SSH a spustíme proces manuálne z prostredia shell. Našťastie je Ubuntu predbalené s Systemd, čo nám umožňuje vytvoriť službu, pomocou ktorej bude GitBucket automaticky spustený a spravovaný systémom.

Pomocou nano, vytvorte nový súbor jednotky v /etc/systemd/systemadresári.

sudo nano /etc/systemd/system/gitbucket.service

Potom skopírujte nasledujúci obsah do súboru.

[Unit]
Description=GitBucket
After=network.target
[Service]
ExecStart=/usr/bin/java -jar /home/gitbucket/gitbucket.war --port 8080
ExecStop=/bin/kill -SIGINT $MAINPID
Type=simple
User=gitbucket
[Install]
WantedBy=multi-user.target

Tento súbor jednotky definuje základné správanie pri spúšťaní a vypínaní pre GitBucket a spúšťa službu pod naším neprivilegovaným používateľom systému na lokálnom sieťovom rozhraní.

Ak ste zmenili číslo portu, na ktorom bude GitBucket počúvať, zmeňte --portargument ExecStartpríkazu.

Uložte (" CTRL+O") nový súbor jednotky a potom ukončite editor (" CTRL+X"). Na objavenie nového súboru jednotky budete musieť znova načítať Systemd.

sudo systemctl daemon-reload

Po opätovnom načítaní systému Systemd skontrolujte, či bola nová jednotka objavená a načítaná.

sudo systemctl status gitbucket

Mali by ste vidieť nasledujúci výstup.

gitbucket.service - GitBucket
   Loaded: loaded (/etc/systemd/system/gitbucket.service; disabled; vendor preset: enabled)
   Active: inactive (dead)

Nakoniec povoľte automatické spustenie novej jednotky pri spustení servera a potom prvýkrát spustite službu.

sudo systemctl enable gitbucket
sudo systemctl start gitbucket

Po spustení služby budete môcť znova pristupovať k GitBucket z vášho prehliadača pomocou adresy IP a čísla portu.

Konfigurácia reverzného proxy servera Nginx

Aj keď je možné sprístupniť GitBucket priamo cez port 8080, môžete zlepšiť výkon a nakonfigurovať funkcie, ako sú HTTP/2, šifrovanie TLS a pravidlá ukladania do vyrovnávacej pamäte, a to odhalením GitBucket cez Nginx.

Počiatočné nastavenie Nginx

Ak ste ešte nenainštalovali Nginx, aktualizujte zoznamy balíkov.

sudo apt update

Potom nainštalujte balík Nginx.

sudo apt install nginx

Po nainštalovaní Nginx skontrolujte, či máte prístup k webovému serveru cez IP adresu vášho servera bez čísla portu (napr. http://203.0.113.0alebo http://example.com). Ak bude úspešný, uvidíte predvolenú vstupnú stránku Nginx pre Ubuntu.

Vytvorenie reverzného proxy

Skopírujeme predvolenú konfiguráciu lokality /etc/nginx/sites-availableako východiskový bod pre reverzný proxy server.

sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/gitbucket

Otvorte novovytvorený konfiguračný súbor pomocou nano.

sudo nano /etc/nginx/sites-available/gitbucket

Nájdite existujúci location /blok na linke 43.

location / {
  # First attempt to serve request as file, then
  # as directory, then fall back to displaying a 404.
  try_files $uri $uri/ =404;
}

V súčasnosti sa Nginx pokúsi vrátiť súbory, /var/www/htmlktoré sa zhodujú s prichádzajúcimi HTTPpožiadavkami. Toto správanie budeme musieť zmeniť konfiguráciou reverzného proxy v tomto bloku, ktorý bude namiesto toho posielať všetky HTTP požiadavky na náš server Nginx do inštancie GitBucket. Aktualizujte location /blok, aby sa zhodoval s nasledujúcim.

location / {
    proxy_pass              http://localhost:8080; # The address GitBucket is listening on
    proxy_set_header        Host $host;
    proxy_set_header        X-Real-IP $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_connect_timeout   150;
    proxy_send_timeout      100;
    proxy_read_timeout      100;
    proxy_buffers           4 32k;

    client_max_body_size    512m; # Needed for large Git operations over HTTP
    client_body_buffer_size 128k;
}

Ak ste zmenili číslo portu, na ktorom bude GitBucket počúvať, aktualizujte proxy_passmožnosť tak, aby to odrážala.

Ak chcete povoliť našu novú konfiguráciu, budete musieť deaktivovať existujúcu predvolenú konfiguráciu v /etc/nginx/sites-enabled, potom symbolicky prepojiť našu novú konfiguráciu s /etc/nginx/sites-enablednasledujúcim.

sudo rm /etc/nginx/sites-enabled/default
sudo ln -s /etc/nginx/sites-available/gitbucket /etc/nginx/sites-enabled/gitbucket

Po povolení konfiguračného súboru skontrolujte prípadné chyby syntaxe.

sudo nginx -t

Potom reštartujte server Nginx, aby ste povolili našu novú konfiguráciu stránok.

sudo systemctl restart nginx

Teraz by ste mali mať prístup k inštalácii GitBucket na verejnej adrese vášho servera bez čísla portu.

Zabezpečenie procesu GitBucket z verejného internetu

V súčasnosti naša inštancia GitBucket počúva na verejnom sieťovom rozhraní nášho servera . To umožní používateľom obísť server proxy Nginx pripojením k adrese, na ktorej GitBucket momentálne počúva, čo je pravdepodobne nechcené. Aby sme to vyriešili, budeme musieť upraviť súbor jednotky, ktorý sme vytvorili predtým. Otvorte súbor jednotky pomocou nano.

sudo nano /etc/systemd/system/gitbucket.service

Pripojte --host 127.0.0.1k ExecStartpríkazu, podobne.

...
ExecStart=/usr/bin/java -jar /home/gitbucket/gitbucket.war --port 8080 --host 127.0.0.1
...

To spôsobí, že GitBucket bude akceptovať iba pripojenia na lokálnom sieťovom rozhraní nášho servera. Ešte raz uložte (" CTRL+O") súbor, zatvorte (" CTRL+X") editor, znova načítajte Systemd a reštartujte našu jednotku GitBucket.

sudo systemctl daemon-reload
sudo systemctl restart gitbucket

Ak používate bránu Vultr's Firewall, mali by ste tiež odstrániť všetky pravidlá portu, ktoré ste pridali na prístup k serveru GitBucket počas počiatočného nastavenia.