Kako namestiti GitBucket na Ubuntu 16.04

Ta priročnik pokriva osnovno namestitev in nastavitev GitBucket za primerek Vultr, ki izvaja Ubuntu 16.04, in predvideva, da izvajate ukaze kot non-rootuporabnik.

Predpogoji

• Primerek strežnika Vultr z vsaj 1 GB RAM-a (manjši primerki lahko delujejo, čeprav počasi).
• openjdk-8-jre Obvezno, starejše različice ne bodo delovale.
• wget Uporablja se za prenos paketa GitBucket.
• nginx Izbirno zagotavlja povratni proxy za GitBucket
• systemd Upravlja zagon in ustavitev postopka GitBucket

Namestitev predpogojev

GitBucket zahteva, da je na vašem strežniku nameščena Java 8 ali novejša. Če še niste namestili Jave 8, najprej posodobite lokalne sezname paketov.

sudo apt update

Nato namestite paket izvajanja Java 8.

sudo apt install openjdk-8-jre

Namestitev GitBucket

Ustvarjanje neprivilegiranega uporabnika

Preden nadaljujemo, bomo morali ustvariti neprivilegiranega uporabnika za zagon GitBucket. Zagon GitBucket pod neprivilegiranim uporabnikom omejuje našo namestitev pri zapisovanju izven lastnega podatkovnega imenika, kar krepi varnost vašega strežnika. Zaženite naslednji ukaz, da ustvarite sistemskega uporabnika z imenom gitbucket.

sudo adduser --system gitbucket

Ker smo ustvarili sistemskega uporabnika, je privzeta lupina /bin/false, in vrnjeni bomo nazaj v našo trenutno lupino, razen če med izvajanjem zagotovimo dodaten argument lupine su. Prijavite se v novoustvarjenega uporabnika.

sudo su - gitbucket -s /bin/bash

Poziv vaše lupine bi se moral spremeniti in prijavljeni boste v novega uporabnika sistema.

Prenos/posodabljanje GitBucket

Pomaknite se na stran z izdajami GitBucket in poiščite najnovejšo razpoložljivo različico. Kopirajte URL za gitbucket.warpaket, preverite, ali ste v domačem imeniku novega uporabnika, in ga prenesite z wget.

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

Ta korak boste morali ponoviti vsakič, ko boste želeli posodobiti paket GitBucket.

Začetna konfiguracija GitBucket

Ko je paket prenesen, bomo morali GitBucket zagnati ročno, da izvedemo začetno konfiguracijo.

java -jar gitbucket.war --port 8080

Če je vrata 8080že zasedla drug proces, lahko spremenite vrata, ki jih bo GitBucket poslušal zdaj. Ta priročnik vseskozi predpostavlja, da GitBucket posluša vrata8080 .

To bo zagnalo GitBucket na javnem omrežnem vmesniku vašega strežnika, ki bo poslušal na določenih vratih. Po nekaj trenutkih bi morali videti naslednje sporočilo.

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

Če uporabljate Vultrov požarni zid , boste morali odpreti vrata, ki jih posluša GitBucket, saj Vultrov požarni zid deluje kot beli seznam in zavrača promet, da dovoli vrata, razen če ni določeno drugače.

Vaša namestitev GitBucket bi morala biti zdaj na spletu in dostopna iz interneta. S spletnim brskalnikom se povežite z javnim naslovom vašega strežnika (obvezno določite vrata, na katerih se izvaja GitBucket (tj. http://203.0.113.0:8080ali http://example.com:8080), in pristali boste na domači strani GitBucket.

Vendar je treba spremeniti geslo privzetega skrbniškega računa. To storite tako, da se prijavite v skrbniški račun prek Sign ingumba v zgornjem desnem kotu spletnega vmesnika. Privzeta prijava za skrbniški račun je rootza uporabniško ime in nato rootše enkrat za geslo. Ko ste prijavljeni, bo gumb zamenjan z ikono profila in spustnim menijem. Razširite spustni meni in izberite Account Settings, nato pa v čarovniku za nastavitve računa nastavite novo, varnejše geslo.

Ko posodobite poverilnice privzetega skrbniškega računa in preverite, da se GitBucket zažene v tej minimalni konfiguraciji, ukinite proces Java z " CTRL+C" in zaprite trenutno lupino z exit.

Ustvarjanje storitve Systemd

Trenutno lahko GitBucket zaženemo samo tako, da do našega strežnika dostopamo prek SSH in ročno zaženemo postopek iz lupine. Na srečo je Ubuntu predpakiran z Systemd, kar nam omogoča, da ustvarimo storitev, s katero bo GitBucket samodejno zagnal in vzdrževal sistem.

Z uporabo nanoustvarite novo datoteko enote v /etc/systemd/systemimeniku.

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

Nato v datoteko kopirajte naslednjo vsebino.

[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

Ta datoteka enote definira osnovno obnašanje pri zagonu in zaustavitvi za GitBucket in izvaja storitev pod našim neprivilegiranim uporabnikom sistema na lokalnem omrežnem vmesniku.

Če ste spremenili številko vrat, ki jih bo GitBucket poslušal, spremenite --portargument za ExecStartukaz.

Shranite (" CTRL+O") novo datoteko enote in nato zapustite urejevalnik (" CTRL+X"). Za odkritje nove datoteke enote boste morali znova naložiti Systemd.

sudo systemctl daemon-reload

Ko se Systemd znova naloži, preverite, ali je bila nova enota odkrita in naložena.

sudo systemctl status gitbucket

Videti bi morali naslednji izhod.

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

Nazadnje omogočite, da se nova enota samodejno zažene, ko se strežnik zažene, in nato prvič zaženite storitev.

sudo systemctl enable gitbucket
sudo systemctl start gitbucket

Ko se storitev zažene, boste lahko znova dostopali do GitBucket iz svojega brskalnika z uporabo naslova IP in številke vrat.

Konfiguriranje povratnega proxyja Nginx

Medtem ko lahko GitBucket razkrijemo neposredno prek vrat 8080, lahko izboljšate zmogljivost in konfigurirate funkcije, kot so HTTP/2, šifriranje TLS in pravila za predpomnjenje, tako da izpostavite GitBucket prek Nginxa.

Začetna nastavitev Nginxa

Če še niste namestili Nginxa, posodobite sezname paketov.

sudo apt update

Nato namestite paket Nginx.

sudo apt install nginx

Ko je Nginx nameščen, preverite, ali lahko dostopate do spletnega strežnika prek naslova IP vašega strežnika brez številke vrat (tj. http://203.0.113.0ali http://example.com). Če bo uspešno, boste videli privzeto ciljno stran Nginx za Ubuntu.

Ustvarjanje povratnega proxyja

Kot /etc/nginx/sites-availableizhodišče za obratni proxy bomo kopirali privzeto konfiguracijo spletnega mesta .

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

Odprite novo ustvarjeno konfiguracijsko datoteko z nano.

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

Poiščite obstoječi location /blok v vrstici 43.

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

Trenutno bo Nginx poskušal vrniti datoteke, v /var/www/htmlkaterih se ujemajo dohodne HTTPzahteve. To vedenje bomo morali spremeniti tako, da v tem bloku konfiguriramo povratni proxy, ki bo namesto tega poslal vse zahteve HTTP, poslane našemu strežniku Nginx, primerku GitBucket. Posodobite location /blok, da bo ustrezal naslednjim.

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

Če ste spremenili številko vrat, ki jih bo poslušal GitBucket, posodobite proxy_passmožnost, da to odraža.

Če želite omogočiti našo novo konfiguracijo, boste morali onemogočiti obstoječo privzeto konfiguracijo v /etc/nginx/sites-enabled, nato pa simbolično povezati našo novo konfiguracijo na /etc/nginx/sites-enablednaslednje.

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

Ko je konfiguracijska datoteka omogočena, preverite morebitne sintaksične napake.

sudo nginx -t

Nato znova zaženite strežnik Nginx, da omogočite našo novo konfiguracijo spletnega mesta.

sudo systemctl restart nginx

Zdaj bi morali imeti možnost dostopa do vaše namestitve GitBucket na javnem naslovu vašega strežnika brez številke vrat.

Zaščita postopka GitBucket iz javnega interneta

Trenutno naš primerek GitBucket posluša na vmesniku javnega omrežja našega strežnika . To bo uporabnikom omogočilo, da zaobidejo proxy Nginx tako, da se povežejo z naslovom, ki ga GitBucket trenutno posluša, kar je verjetno neželeno. Za rešitev tega problema bomo morali spremeniti datoteko enote, ki smo jo ustvarili prej. Odprite datoteko enote z nano.

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

Pripni --host 127.0.0.1na ExecStartukaz, kot tako.

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

To bo povzročilo, da bo GitBucket sprejel samo povezave na lokalnem omrežnem vmesniku našega strežnika. Še enkrat shranite (" CTRL+O") datoteko, zaprite (" CTRL+X") urejevalnik, znova naložite Systemd in znova zaženite našo enoto GitBucket.

sudo systemctl daemon-reload
sudo systemctl restart gitbucket

Če uporabljate požarni zid Vultr, morate odstraniti tudi vsa pravila vrat, ki ste jih dodali za dostop do strežnika GitBucket med prvo namestitvijo.