Kā instalēt GitBucket Ubuntu 16.04

Šajā rokasgrāmatā ir aprakstīta GitBucket pamata instalēšana un iestatīšana Vultr instancei, kurā darbojas Ubuntu 16.04, un tiek pieņemts, ka izpildāt komandas kā non-rootlietotājs.

Priekšnoteikumi

• Vultr servera gadījums ar vismaz 1 GB RAM (mazāki gadījumi var darboties, lai gan lēni).
• openjdk-8-jre Obligāti, vecākas versijas nedarbosies.
• wget Izmanto, lai lejupielādētu GitBucket pakotni.
• nginx Pēc izvēles nodrošina GitBucket apgriezto starpniekserveri
• systemd Pārvalda GitBucket procesa sākšanu un apturēšanu

Priekšnoteikumu uzstādīšana

GitBucket serverī ir jāinstalē Java 8 vai jaunāka versija. Ja vēl neesat instalējis Java 8, vispirms atjauniniet vietējos pakotņu sarakstus.

sudo apt update

Pēc tam instalējiet Java 8 izpildlaika pakotni.

sudo apt install openjdk-8-jre

GitBucket instalēšana

Nepriviliģēta lietotāja izveide

Pirms turpināt darbu, mums būs jāizveido nepievilcīgs lietotājs, lai palaistu GitBucket. GitBucket palaišana nepievilināta lietotāja vadībā ierobežo mūsu instalācijas ierakstīšanu ārpus sava datu direktorija, tādējādi stiprinot jūsu servera drošību. Palaidiet šo komandu, lai izveidotu sistēmas lietotāju ar nosaukumu gitbucket.

sudo adduser --system gitbucket

Tā kā mēs izveidojām sistēmas lietotāju, noklusējuma čaula ir /bin/false, un mēs tiksim novirzīti atpakaļ uz pašreizējo čaulu, ja vien, palaižot , nenorādīsim papildu čaulas argumentu su. Piesakieties jaunizveidotajam lietotājam.

sudo su - gitbucket -s /bin/bash

Jūsu čaulas uzvednei vajadzētu mainīties, un jūs tiksit pieteicies jaunajā sistēmas lietotāja kontā.

GitBucket lejupielāde/atjaunināšana

Dodieties uz GitBucket laidienu lapu un atrodiet jaunāko pieejamo versiju. Nokopējiet gitbucket.warpakotnes URL , pārbaudiet, vai atrodaties jaunā lietotāja mājas direktorijā, un lejupielādējiet to, izmantojot wget.

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

Šī darbība būs jāatkārto katru reizi, kad vēlaties atjaunināt GitBucket pakotni.

Sākotnējā GitBucket konfigurācija

Kad pakotne ir lejupielādēta, mums būs manuāli jāstartē GitBucket, lai veiktu sākotnējo konfigurāciju.

java -jar gitbucket.war --port 8080

Ja portu 8080jau izmanto cits process, varat mainīt portu, kuru GitBucket klausīsies tagad. Šajā rokasgrāmatā tiek pieņemts, ka GitBucket klausās portā8080 .

Tas sāks GitBucket jūsu servera publiskā tīkla saskarnē, klausoties norādītajā portā. Pēc dažiem mirkļiem jums vajadzētu redzēt šādu ziņojumu.

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

Ja izmantojat Vultr ugunsmūri , jums būs jāatver ports, kuru GitBucket klausās, jo Vultr ugunsmūris darbojas kā baltais saraksts, noraidot trafiku, lai atļautu portus, ja vien nav norādīts citādi.

Jūsu GitBucket instalācijai tagad vajadzētu būt tiešsaistē un pieejamai no interneta. Izmantojot tīmekļa pārlūkprogrammu, izveidojiet savienojumu ar sava servera publisko adresi (noteikti norādiet portu, kurā darbojas GitBucket, (ti, http://203.0.113.0:8080vai http://example.com:8080), un jūs nonāksit GitBucket mājaslapā.

Tomēr ir jāmaina noklusējuma administratora konta parole. Lai to izdarītu, piesakieties administratora kontā, izmantojot Sign inpogu tīmekļa saskarnes augšējā labajā stūrī. Noklusējuma pieteikšanās administratora kontam ir rootlietotājvārdam un pēc tam rootatkal parolei. Pēc pieteikšanās poga tiks aizstāta ar profila ikonu un nolaižamo izvēlni. Izvērsiet nolaižamo izvēlni un atlasiet Account Settings, pēc tam konta iestatījumu vednī iestatiet jaunu, drošāku paroli.

Kad esat atjauninājis noklusējuma administratora konta akreditācijas datus un pārliecinājies, ka GitBucket tiek startēts šajā minimālajā konfigurācijā, iznīciniet Java procesu ar " CTRL+C" un aizveriet pašreizējo apvalku ar exit.

Systemd pakalpojuma izveide

Pašlaik mēs varam palaist GitBucket, tikai piekļūstot savam serverim, izmantojot SSH, un manuāli sākot procesu no čaulas. Par laimi, Ubuntu ir Systemdiesaiņots ar , ļaujot mums izveidot pakalpojumu, ar kuru sistēma GitBucket tiks automātiski startēta un uzturēta.

Izmantojot nano, /etc/systemd/systemdirektorijā izveidojiet jaunu vienības failu .

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

Pēc tam kopējiet tālāk norādīto saturu failā.

[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

Šis vienības fails definē GitBucket pamata palaišanas un izslēgšanas darbības, un tas palaiž pakalpojumu mūsu nepieredzētajam sistēmas lietotājam tikai vietējā tīkla saskarnē.

Ja esat mainījis porta numuru, kuru GitBucket klausīsies, mainiet komandas --portargumentu ExecStart.

Saglabājiet (" CTRL+O") jauno vienības failu un pēc tam izejiet no redaktora (" CTRL+X"). Jums būs atkārtoti jāielādē Systemd, lai tiktu atklāts jaunais vienības fails.

sudo systemctl daemon-reload

Kad Systemd ir atkārtoti ielādēts, pārbaudiet, vai jaunā vienība ir atklāta un ielādēta.

sudo systemctl status gitbucket

Jums vajadzētu redzēt šādu izvadi.

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

Visbeidzot, iespējojiet jaunās vienības automātisku startēšanu, kad serveris sāk startēt, un pēc tam palaidiet pakalpojumu pirmo reizi.

sudo systemctl enable gitbucket
sudo systemctl start gitbucket

Kad pakalpojums būs palaists, jūs atkal varēsit piekļūt GitBucket no savas pārlūkprogrammas, izmantojot IP adresi un porta numuru.

Nginx reversā starpniekservera konfigurēšana

Lai gan GitBucket var atklāt tieši caur portu 8080, varat uzlabot veiktspēju un konfigurēt tādas funkcijas kā HTTP/2, TLS šifrēšana un kešatmiņas kārtulas, atklājot GitBucket, izmantojot Nginx.

Sākotnējā Nginx iestatīšana

Ja vēl neesat instalējis Nginx, atjauniniet pakotņu sarakstus.

sudo apt update

Pēc tam instalējiet Nginx pakotni.

sudo apt install nginx

Kad Nginx ir instalēts, pārbaudiet, vai varat piekļūt tīmekļa serverim, izmantojot sava servera IP adresi bez porta numura (ti, http://203.0.113.0vai http://example.com). Ja tas izdosies, jūs redzēsit Ubuntu noklusējuma Nginx galveno lapu.

Reversā starpniekservera izveide

Mēs kopēsim noklusējuma vietnes konfigurāciju /etc/nginx/sites-availablekā sākumpunktu apgrieztajam starpniekserveram.

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

Atveriet jaunizveidoto konfigurācijas failu ar nano.

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

Atrodiet esošo location /bloku 43. rindā.

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

Pašlaik Nginx mēģinās atgriezt failus, /var/www/htmlkas atbilst ienākošajiem HTTPpieprasījumiem. Mums būs jāmaina šī darbība, šajā blokā konfigurējot apgriezto starpniekserveri, kas tā vietā nosūtīs visus HTTP pieprasījumus, kas nosūtīti uz mūsu Nginx serveri, uz GitBucket instanci. Atjauniniet location /bloku, lai tas atbilstu tālāk norādītajam.

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

Ja mainījāt porta numuru, kurā GitBucket klausīsies, atjauniniet proxy_passopciju, lai to atspoguļotu.

Lai iespējotu mūsu jauno konfigurāciju, jums būs jāatspējo esošā noklusējuma konfigurācija un /etc/nginx/sites-enabledpēc tam jāsaista mūsu jaunā konfigurācija /etc/nginx/sites-enabledar tālāk norādīto.

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

Kad konfigurācijas fails ir iespējots, pārbaudiet, vai nav sintakses kļūdu.

sudo nginx -t

Pēc tam restartējiet Nginx serveri, lai iespējotu mūsu jauno vietnes konfigurāciju.

sudo systemctl restart nginx

Tagad jums vajadzētu būt iespējai piekļūt savai GitBucket instalācijai sava servera publiskajā adresē bez porta numura.

GitBucket procesa nodrošināšana no publiskā interneta

Pašlaik mūsu GitBucket instance klausās mūsu servera publiskā tīkla saskarnē. Tas ļaus lietotājiem apiet Nginx starpniekserveri, izveidojot savienojumu ar adresi, kuru pašlaik klausās GitBucket, kas, iespējams, ir nevēlama. Lai to atrisinātu, mums būs jāmaina vienības fails, ko izveidojām iepriekš. Atveriet vienības failu ar nano.

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

Append --host 127.0.0.1ar ExecStartkomandu, piemēram, tā.

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

Tādējādi GitBucket pieņems savienojumus tikai mūsu servera lokālā tīkla saskarnē. Vēlreiz saglabājiet (" CTRL+O") failu, aizveriet (" CTRL+X") redaktoru, atkārtoti ielādējiet Systemd un restartējiet mūsu GitBucket vienību.

sudo systemctl daemon-reload
sudo systemctl restart gitbucket

Ja izmantojat Vultr ugunsmūri, jums vajadzētu arī noņemt visus porta noteikumus, ko pievienojāt, lai piekļūtu GitBucket serverim sākotnējās iestatīšanas laikā.