Jak nainstalovat GitBucket na Ubuntu 16.04

Tato příručka pokrývá základní instalaci a nastavení GitBucket pro instanci Vultr se systémem Ubuntu 16.04 a předpokládá, že příkazy spouštíte jako non-rootuživatel.

Předpoklady

• Instance serveru Vultr s alespoň 1 GB RAM (menší instance mohou fungovat, i když pomalu).
• openjdk-8-jre Povinné, starší verze nebudou fungovat.
• wget Používá se ke stažení balíčku GitBucket.
• nginx Volitelné poskytuje reverzní proxy pro GitBucket
• systemd Spravuje spouštění a zastavování procesu GitBucket

Předpoklady pro instalaci

GitBucket vyžaduje, aby byla na vašem serveru nainstalována Java 8 nebo novější. Pokud jste ještě nenainstalovali Java 8, nejprve aktualizujte místní seznamy balíčků.

sudo apt update

Poté nainstalujte balíček Java 8 runtime.

sudo apt install openjdk-8-jre

Instalace GitBucket

Vytvoření neprivilegovaného uživatele

Než budeme pokračovat, budeme muset vytvořit neprivilegovaného uživatele, který bude spouštět GitBucket. Spuštění GitBucketu pod neprivilegovaným uživatelem omezuje naši instalaci v zápisu mimo její vlastní datový adresář, což posiluje zabezpečení vašeho serveru. Spuštěním následujícího příkazu vytvořte systémového uživatele s názvem gitbucket.

sudo adduser --system gitbucket

Protože jsme vytvořili systémového uživatele, výchozí shell je /bin/false, a pokud při spuštění nezadáme další argument shellu , budeme kopnuti zpět do našeho aktuálního shellu su. Přihlaste se k nově vytvořenému uživateli.

sudo su - gitbucket -s /bin/bash

Výzva vašeho shellu by se měla změnit a budete přihlášeni k novému systémovému uživateli.

Stahování/aktualizace GitBucket

Přejděte na stránku vydání GitBucket a vyhledejte nejnovější dostupnou verzi. Zkopírujte adresu URL gitbucket.warbalíčku, ověřte, že jste v domovském adresáři nového uživatele, a stáhněte jej pomocí wget.

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

Tento krok budete muset opakovat pokaždé, když budete chtít aktualizovat balíček GitBucket.

Počáteční konfigurace GitBucket

Jakmile bude balíček stažen, budeme muset GitBucket spustit ručně, abychom provedli počáteční konfiguraci.

java -jar gitbucket.war --port 8080

Pokud je port 8080již obsazen jiným procesem, můžete nyní změnit port, na kterém bude GitBucket naslouchat. Tato příručka předpokládá, že GitBucket naslouchá na portu8080 .

Tím se spustí GitBucket na veřejném síťovém rozhraní vašeho serveru a naslouchá na zadaném portu. Po chvíli byste měli vidět následující zprávu.

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

Pokud používáte Vultr's firewall , budete muset otevřít port, na kterém GitBucket naslouchá, protože Vultr's firewall funguje jako white-list a odmítne provoz a povolí porty, pokud není uvedeno jinak.

Vaše instalace GitBucket by nyní měla být online a přístupná z internetu. Pomocí webového prohlížeče se připojte k veřejné adrese svého serveru (nezapomeňte zadat port, na kterém GitBucket běží, (tj. http://203.0.113.0:8080nebo http://example.com:8080), a dostanete se na domovskou stránku GitBucket.

Je však třeba změnit heslo výchozího účtu správce. Chcete-li tak učinit, přihlaste se k účtu správce pomocí Sign intlačítka v pravé horní části webového rozhraní. Výchozí přihlášení pro účet správce je rootpro uživatelské jméno a poté rootznovu pro heslo. Po přihlášení bude tlačítko nahrazeno ikonou profilu a rozevíracím seznamem. Rozbalte rozevírací seznam a vyberte možnost Account Settingsa poté v průvodci nastavením účtu nastavte nové, bezpečnější heslo.

Poté, co aktualizujete přihlašovací údaje výchozího účtu správce a ověříte, že GitBucket se spouští v této minimální konfiguraci, CTRL+Cukončete proces Java pomocí " " a zavřete aktuální shell pomocí exit.

Vytvoření služby Systemd

V současné době můžeme GitBucket spustit pouze tak, že přistoupíme k našemu serveru přes SSH a spustíme proces ručně z prostředí shell. Naštěstí je Ubuntu předbaleno s Systemd, což nám umožňuje vytvořit službu, se kterou bude GitBucket automaticky spuštěn a udržován systémem.

Pomocí nano, vytvořte nový soubor jednotky v /etc/systemd/systemadresáři.

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

Poté zkopírujte následující obsah do souboru.

[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 soubor jednotky definuje základní chování při spouštění a vypínání pro GitBucket a spouští službu pod naším neprivilegovaným uživatelem systému pouze na místním síťovém rozhraní.

Pokud jste změnili číslo portu, na kterém bude GitBucket naslouchat, změňte --portargument ExecStartpříkazu.

Uložte (" CTRL+O") nový soubor jednotky a poté ukončete editor (" CTRL+X"). Pro objevení nového souboru jednotky budete muset znovu načíst Systemd.

sudo systemctl daemon-reload

Po opětovném načtení systému Systemd ověřte, že byla objevena a zavedena nová jednotka.

sudo systemctl status gitbucket

Měli byste vidět následující výstup.

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

Nakonec povolte automatické spuštění nové jednotky při spuštění serveru a poté poprvé spusťte službu.

sudo systemctl enable gitbucket
sudo systemctl start gitbucket

Po spuštění služby budete mít opět přístup ke GitBucket z vašeho prohlížeče pomocí IP adresy a čísla portu.

Konfigurace reverzního proxy serveru Nginx

I když lze GitBucket zpřístupnit přímo prostřednictvím portu 8080, můžete zlepšit výkon a nakonfigurovat funkce, jako je HTTP/2, šifrování TLS a pravidla ukládání do mezipaměti, tím, že zpřístupníte GitBucket prostřednictvím Nginx.

Počáteční nastavení Nginx

Pokud jste ještě nenainstalovali Nginx, aktualizujte seznamy balíčků.

sudo apt update

Poté nainstalujte balíček Nginx.

sudo apt install nginx

Jakmile je Nginx nainstalován, ověřte, že máte přístup k webovému serveru prostřednictvím IP adresy vašeho serveru bez čísla portu (tj. http://203.0.113.0nebo http://example.com). Pokud bude úspěšný, uvidíte výchozí vstupní stránku Nginx pro Ubuntu.

Vytvoření reverzního proxy

Zkopírujeme výchozí konfiguraci webu /etc/nginx/sites-availablejako výchozí bod pro reverzní proxy.

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

Otevřete nově vytvořený konfigurační soubor pomocí nano.

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

Najděte stávající location /blok na lince 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 současné době se Nginx pokusí vrátit soubory, /var/www/htmlkteré odpovídají příchozím HTTPpožadavkům. Toto chování budeme muset změnit tak, že v tomto bloku nakonfigurujeme reverzní proxy, která bude místo toho odesílat všechny požadavky HTTP na náš server Nginx do instance GitBucket. Aktualizujte location /blok, aby odpovídal následujícímu.

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;
}

Pokud jste změnili číslo portu, na kterém bude GitBucket naslouchat, aktualizujte proxy_passmožnost, aby to odráželo.

Chcete-li povolit naši novou konfiguraci, budete muset deaktivovat stávající výchozí konfiguraci v aplikaci /etc/nginx/sites-enableda poté naši novou konfiguraci symbolicky propojit /etc/nginx/sites-enableds následujícím.

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

Jakmile je konfigurační soubor povolen, zkontrolujte případné syntaktické chyby.

sudo nginx -t

Poté restartujte server Nginx, abyste povolili naši novou konfiguraci webu.

sudo systemctl restart nginx

Nyní byste měli mít přístup k instalaci GitBucket na veřejné adrese vašeho serveru bez čísla portu.

Zabezpečení procesu GitBucket z veřejného internetu

V současné době naše instance GitBucket naslouchá na veřejném síťovém rozhraní našeho serveru . To uživatelům umožní obejít Nginx proxy připojením k adrese, na které GitBucket aktuálně naslouchá, což je pravděpodobně nežádoucí. Abychom to vyřešili, budeme muset upravit soubor jednotky, který jsme vytvořili dříve. Otevřete soubor jednotky pomocí nano.

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

Připojit --host 127.0.0.1k ExecStartpříkazu, podobně.

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

To způsobí, že GitBucket bude přijímat pouze připojení na místním síťovém rozhraní našeho serveru. Znovu uložte (" CTRL+O") soubor, zavřete (" CTRL+X") editor, znovu načtěte Systemd a restartujte naši jednotku GitBucket.

sudo systemctl daemon-reload
sudo systemctl restart gitbucket

Pokud používáte Vultr's Firewall, měli byste také odstranit všechna pravidla portu, která jste přidali pro přístup k serveru GitBucket během počátečního nastavení.