Kuidas installida GitBucket Ubuntu 16.04

See juhend hõlmab GitBucketi põhiinstallimist ja seadistamist Vultri eksemplari jaoks, milles töötab Ubuntu 16.04, ning eeldab, et täidate käske non-rootkasutajana.

Eeltingimused

• Vultri serveri eksemplar, millel on vähemalt 1 GB muutmälu (väiksemad eksemplarid võivad töötada, kuigi aeglaselt).
• openjdk-8-jre Nõutav, vanemad versioonid ei tööta.
• wget Kasutatakse GitBucketi paketi allalaadimiseks.
• nginx Valikuline, annab GitBucketile pöördpuhverserveri
• systemd Haldab GitBucketi protsessi käivitamist ja peatamist

Eeltingimuste paigaldamine

GitBucket nõuab Java 8 või uuema versiooni installimist teie serverisse. Kui te pole Java 8 veel installinud, värskendage esmalt kohalikke pakettide loendeid.

sudo apt update

Seejärel installige Java 8 käitusaegne pakett.

sudo apt install openjdk-8-jre

GitBucketi installimine

Privilegeeritud kasutaja loomine

Peame GitBucketi käitamiseks looma privilegeerimata kasutaja, enne kui jätkame. GitBucketi käitamine privilegeerimata kasutaja all piirab meie installi kirjutamist väljaspool oma andmekataloogi, tugevdades teie serveri turvalisust. Käivitage järgmine käsk, et luua süsteemikasutaja nimega gitbucket.

sudo adduser --system gitbucket

Kuna lõime süsteemikasutaja , on vaikekestaks /bin/false, ja meid suunatakse tagasi praeguse kesta juurde, välja arvatud juhul, kui pakume käivitamisel täiendavat kestargumenti su. Logige sisse vastloodud kasutajasse.

sudo su - gitbucket -s /bin/bash

Teie shelli viip peaks muutuma ja teid logitakse sisse uude süsteemi kasutajasse.

GitBucketi allalaadimine/värskendamine

Liikuge GitBucketi väljaannete lehele ja leidke uusim saadaolev versioon. Kopeerige gitbucket.warpaketi URL , veenduge, et olete uue kasutaja kodukataloogis, ja laadige see alla rakendusega wget.

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

Peate seda sammu kordama iga kord, kui soovite GitBucketi paketti värskendada.

GitBucketi esialgne konfiguratsioon

Kui pakett on alla laaditud, peame algse konfiguratsiooni tegemiseks GitBucketi käsitsi käivitama.

java -jar gitbucket.war --port 8080

Kui port 8080on juba mõne teise protsessi poolt hõivatud, saate muuta porti, mida GitBucket praegu kuulab. See juhend eeldab läbivalt, et GitBucket kuulab pordis8080 .

See käivitab GitBucketi teie serveri avalikus võrguliideses, kuulates määratud pordi kaudu. Mõne hetke pärast peaksite nägema järgmist teadet.

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

Kui kasutate Vultri tulemüüri , peate avama pordi, mida GitBucket kuulab, kuna Vultri tulemüür töötab valge nimekirjana, lükates ära liikluse, et lubada porte, kui pole teisiti määratud.

Teie GitBucketi installimine peaks nüüd olema võrgus ja juurdepääsetav Internetist. Looge veebibrauseri abil ühendus oma serveri avaliku aadressiga (määrake kindlasti port, millel GitBucket töötab, (st http://203.0.113.0:8080või http://example.com:8080), ja jõuate GitBucketi kodulehele.

Vaikimisi administraatorikonto parool tuleb aga muuta. Selleks logige Sign inveebiliidese paremas ülanurgas oleva nupu kaudu sisse administraatori kontole . Administraatorikonto vaikimisi sisselogimine roottoimub kasutajanime ja seejärel rootparooli jaoks. Pärast sisselogimist asendatakse nupp profiiliikooni ja rippmenüüga. Laiendage rippmenüüd ja valige Account Settings, seejärel määrake konto seadete viisardis uus turvalisem parool.

Kui olete administraatori vaikekonto mandaate värskendanud ja veendunud, et GitBucket käivitub selles minimaalses konfiguratsioonis, CTRL+Csulgege Java protsess käsuga " " ja sulgege praegune kest nupuga exit.

Süsteemi teenuse loomine

Praegu saame GitBucketit käitada ainult siis, kui pääseme oma serverisse SSH kaudu ja alustame protsessi kestast käsitsi. Õnneks on Ubuntu eelpakendatud Systemd, mis võimaldab meil luua teenuse, millega GitBucket käivitub automaatselt ja mida süsteem hooldab.

Kasutades nano, looge /etc/systemd/systemkataloogis uus ühikfail .

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

Seejärel kopeerige faili järgmine sisu.

[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

See üksusfail määratleb GitBucketi põhikäivitus- ja väljalülituskäitumise ning käitab teenust meie privilegeerimata süsteemikasutaja all ainult kohaliku võrgu liideses.

Kui olete muutnud pordi numbrit, mida GitBucket kuulab, muutke käsu --portargumenti ExecStart.

Salvestage (" CTRL+O") uus üksuse fail ja seejärel väljuge redaktorist (" CTRL+X"). Uue üksusefaili leidmiseks peate Systemd uuesti laadima.

sudo systemctl daemon-reload

Pärast Systemdi uuesti laadimist veenduge, et uus seade leiti ja laaditi.

sudo systemctl status gitbucket

Peaksite nägema järgmist väljundit.

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

Lõpuks lubage uuel seadmel automaatselt käivituda, kui teie server käivitub, ja seejärel käivitage teenus esimest korda.

sudo systemctl enable gitbucket
sudo systemctl start gitbucket

Kui teenus on käivitunud, pääsete oma brauserist uuesti GitBucketile juurde, kasutades IP-aadressi ja pordi numbrit.

Nginxi pöördpuhverserveri konfigureerimine

Kuigi GitBucketi saab avalikustada otse pordi kaudu 8080, saate parandada jõudlust ja konfigureerida selliseid funktsioone nagu HTTP/2, TLS-krüptimine ja vahemällu salvestamise reeglid, paljastades GitBucketi Nginxi kaudu.

Nginxi esialgne seadistamine

Kui te pole veel Nginxi installinud, värskendage oma pakettide loendeid.

sudo apt update

Seejärel installige Nginxi pakett.

sudo apt install nginx

Kui Nginx on installitud, veenduge, et pääsete veebiserverile juurde oma serveri IP-aadressi kaudu ilma pordi numbrita (st http://203.0.113.0või http://example.com). Kui see õnnestub, näete Ubuntu jaoks Nginxi vaikesihtlehte.

Pöördpuhverserveri loomine

Kopeerime pöördpuhverserveri /etc/nginx/sites-availablelähtepunktiks saidi vaikekonfiguratsiooni .

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

Avage vastloodud konfiguratsioonifail nupuga nano.

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

Leidke location /real 43 olemasolev plokk.

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

Praegu proovib Nginx tagastada faile, /var/www/htmlmis vastavad sissetulevatele HTTPpäringutele. Peame seda käitumist muutma, konfigureerides selles plokis pöördpuhverserveri, mis saadab kõik meie Nginxi serverisse tehtud HTTP-päringud selle asemel GitBucketi eksemplari. Värskendage location /plokki, et see vastaks järgmisele.

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

Kui muutsite pordi numbrit, mida GitBucket kuulab, värskendage seda proxy_passvalikut.

Meie uue konfiguratsiooni lubamiseks peate keelama olemasoleva vaikekonfiguratsiooni /etc/nginx/sites-enabledja seejärel linkima meie uue konfiguratsiooni järgmise /etc/nginx/sites-enabledkaudu.

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

Kui konfiguratsioonifail on lubatud, kontrollige süntaksivigu.

sudo nginx -t

Seejärel taaskäivitage Nginxi server, et lubada meie uus saidi konfiguratsioon.

sudo systemctl restart nginx

Nüüd peaks teil olema juurdepääs oma GitBucketi installile oma serveri avalikul aadressil ilma pordi numbrita.

GitBucketi protsessi kaitsmine avalikust Internetist

Praegu kuulab meie GitBucketi eksemplar meie serveri avalikus võrguliideses. See võimaldab kasutajatel Nginxi puhverserverist mööda minna, luues ühenduse aadressiga, mida GitBucket praegu kuulab, mis on tõenäoliselt soovimatu. Selle lahendamiseks peame muutma varem loodud üksuse faili. Avage üksuse fail nupuga nano.

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

Liida --host 127.0.0.1, et ExecStartkäsk, nii nagu.

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

See paneb GitBucket aktsepteerima ainult meie serveri kohaliku võrgu liidese ühendusi. Veel kord salvestage (" CTRL+O") fail, sulgege (" CTRL+X") redaktor, laadige Systemd uuesti ja taaskäivitage meie GitBucketi üksus.

sudo systemctl daemon-reload
sudo systemctl restart gitbucket

Kui kasutate Vultri tulemüüri, peaksite eemaldama ka kõik pordireeglid, mille lisasite GitBucketi serverile juurdepääsuks esialgse seadistamise ajal.