Come installare GitBucket su Ubuntu 16.04

• Prerequisiti
• Installazione dei prerequisiti
• Installazione di GitBucket
• Configurazione del proxy inverso Nginx

Questa guida copre l'installazione e la configurazione di base di GitBucket per un'istanza Vultr che esegue Ubuntu 16.04 e presuppone che tu stia eseguendo i comandi come non-rootutente.

Prerequisiti

• Un'istanza del server Vultr con almeno 1 GB di RAM (istanze più piccole possono funzionare, anche se lentamente).
• openjdk-8-jre Richiesto, le versioni precedenti non funzioneranno.
• wget Utilizzato per scaricare il pacchetto GitBucket.
• nginx Facoltativo, fornisce un proxy inverso a GitBucket
• systemd Gestisce l'avvio e l'arresto del processo GitBucket

Installazione dei prerequisiti

GitBucket richiede l'installazione di Java 8 o versioni successive sul server. Se non hai già installato Java 8, aggiorna prima gli elenchi dei pacchetti locali.

sudo apt update

Quindi installare il pacchetto di runtime Java 8.

sudo apt install openjdk-8-jre

Installazione di GitBucket

Creazione di un utente senza privilegi

Prima di procedere, dovremo creare un utente senza privilegi per eseguire GitBucket. L'esecuzione di GitBucket con un utente non privilegiato impedisce alla nostra installazione di scrivere al di fuori della propria directory di dati, rafforzando la sicurezza del server. Eseguire il comando seguente per creare un utente di sistema chiamato gitbucket.

sudo adduser --system gitbucket

Poiché abbiamo creato un utente di sistema , la shell predefinita è /bin/falsee verremo reindirizzati alla nostra shell corrente a meno che non forniamo un ulteriore argomento shell durante l'esecuzione su. Accedi all'utente appena creato.

sudo su - gitbucket -s /bin/bash

Il prompt della shell dovrebbe cambiare e si accederà al nuovo utente di sistema.

Download / aggiornamento di GitBucket

Passare alla pagina delle versioni di GitBucket e individuare l'ultima versione disponibile. Copia l'URL del gitbucket.warpacchetto, verifica di trovarti nella home directory del nuovo utente e scaricalo con wget.

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

Dovrai ripetere questo passaggio ogni volta che desideri aggiornare il pacchetto GitBucket.

Configurazione iniziale di GitBucket

Una volta scaricato il pacchetto, avremo bisogno di avviare GitBucket manualmente per eseguire una configurazione iniziale.

java -jar gitbucket.war --port 8080

Se la porta 8080è già presa da un altro processo, puoi cambiare la porta su cui GitBucket ascolterà ora. Questa guida presuppone che GitBucket stia ascoltando sulla porta8080 .

Questo avvierà GitBucket sull'interfaccia di rete pubblica del tuo server, ascoltando sulla porta specificata. Dovresti vedere, dopo qualche istante, il seguente messaggio.

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

Se stai usando il firewall di Vultr , dovrai aprire la porta su cui GitBucket è in ascolto, poiché il firewall di Vultr funziona come una lista bianca, rifiutando il traffico per consentire le porte se non diversamente specificato.

L'installazione di GitBucket ora dovrebbe essere online e accessibile da Internet. Usando un browser web, connettiti all'indirizzo pubblico del tuo server (assicurandoti di specificare la porta su cui GitBucket è in esecuzione, (ovvero http://203.0.113.0:8080o http://example.com:8080), e atterrerai sulla homepage di GitBucket.

Tuttavia, è necessario modificare la password dell'account amministratore predefinito. Per fare ciò, accedi all'account amministratore tramite il Sign inpulsante in alto a destra dell'interfaccia web. L'accesso predefinito per l'account amministratore è rootper il nome utente e quindi di rootnuovo per la password. Una volta effettuato l'accesso, il pulsante verrà sostituito con un'icona del profilo e un menu a discesa. Espandi il menu a discesa e seleziona Account Settings, quindi imposta una nuova password più sicura nella procedura guidata per le impostazioni dell'account.

Dopo aver aggiornato le credenziali dell'account amministratore predefinito e verificato che GitBucket si avvii con questa configurazione minima, uccidi il processo Java con " CTRL+C" e chiudi la shell corrente con exit.

Creazione del servizio Systemd

Attualmente, possiamo eseguire GitBucket solo accedendo al nostro server tramite SSH e avviando il processo manualmente da una shell. Fortunatamente, Ubuntu viene preimballato Systemd, permettendoci di creare un servizio con il quale GitBucket verrà avviato automaticamente e gestito dal sistema.

Utilizzando nano, creare un nuovo file di unità nella /etc/systemd/systemdirectory.

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

Quindi, copia i seguenti contenuti nel file.

[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

Questo file di unità definisce il comportamento di avvio e arresto di base per GitBucket ed esegue il servizio con il nostro utente di sistema senza privilegi sull'interfaccia di rete solo locale.

Se hai modificato il numero di porta su cui GitBucket ascolterà, modifica l' --portargomento per il ExecStartcomando.

Salvare (" CTRL+O") il nuovo file di unità e quindi chiudere l'editor (" CTRL+X"). Sarà necessario ricaricare Systemd per scoprire il nuovo file di unità.

sudo systemctl daemon-reload

Dopo aver ricaricato Systemd, verificare che la nuova unità sia stata rilevata e caricata.

sudo systemctl status gitbucket

Dovresti vedere il seguente output.

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

Infine, abilitare la nuova unità per l'avvio automatico all'avvio del server, quindi avviare il servizio per la prima volta.

sudo systemctl enable gitbucket
sudo systemctl start gitbucket

Una volta avviato il servizio, sarai in grado di accedere a GitBucket dal tuo browser utilizzando nuovamente l'indirizzo IP e il numero di porta.

Configurazione del proxy inverso Nginx

Mentre si può esporre GitBucket direttamente attraverso la porta 8080, è possibile migliorare le prestazioni e configurare funzionalità come HTTP / 2, crittografia TLS e regole di memorizzazione nella cache esponendo GitBucket tramite Nginx.

Configurazione iniziale di Nginx

Se non hai già installato Nginx, aggiorna i tuoi elenchi di pacchetti.

sudo apt update

Quindi installare il pacchetto Nginx.

sudo apt install nginx

Una volta installato Nginx, verificare di essere in grado di accedere al server Web tramite l'indirizzo IP del server senza il numero di porta (ovvero http://203.0.113.0o http://example.com). In caso di successo, verrà visualizzata la pagina di destinazione Nginx predefinita per Ubuntu.

Creazione del proxy inverso

Copieremo la configurazione del sito predefinita /etc/nginx/sites-availablecome punto di partenza per il proxy inverso.

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

Apri il file di configurazione appena creato con nano.

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

Individua il location /blocco esistente sulla linea 43.

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

Attualmente, Nginx tenterà di restituire i file /var/www/htmlche corrispondono alle HTTPrichieste in arrivo . Dovremo cambiare questo comportamento configurando un proxy inverso in questo blocco, che invierà invece tutte le richieste HTTP fatte al nostro server Nginx all'istanza di GitBucket. Aggiorna il location /blocco in modo che corrisponda a quanto segue.

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

Se hai cambiato il numero di porta su cui GitBucket ascolterà, aggiorna l' proxy_passopzione per riflettere questo.

Per abilitare la nostra nuova configurazione, dovrai disabilitare la configurazione predefinita esistente in /etc/nginx/sites-enabled, quindi collegare simbolicamente la nostra nuova configurazione a /etc/nginx/sites-enabledquanto segue.

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

Una volta abilitato il file di configurazione, verificare la presenza di errori di sintassi.

sudo nginx -t

Quindi, riavvia il server Nginx per abilitare la nostra nuova configurazione del sito.

sudo systemctl restart nginx

Ora dovresti essere in grado di accedere all'installazione di GitBucket sull'indirizzo pubblico del tuo server senza un numero di porta.

Proteggere il processo GitBucket da Internet pubblico

Attualmente, la nostra istanza di GitBucket è in ascolto sull'interfaccia di rete pubblica del nostro server . Ciò consentirà agli utenti di bypassare il proxy Nginx connettendosi all'indirizzo su cui GitBucket è attualmente in ascolto, il che è probabilmente indesiderato. Dovremo modificare il file di unità creato in precedenza per risolvere il problema. Aprire il file dell'unità con nano.

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

Aggiungi --host 127.0.0.1al ExecStartcomando, in questo modo.

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

Ciò farà sì che GitBucket accetti solo connessioni sull'interfaccia di rete locale del nostro server. Ancora una volta, salva (" CTRL+O") il file, chiudi (" CTRL+X") l'editor, ricarica Systemd e riavvia la nostra unità GitBucket.

sudo systemctl daemon-reload
sudo systemctl restart gitbucket

Se si utilizza Vultr's Firewall, è necessario rimuovere anche tutte le regole di porta aggiunte per accedere al server GitBucket durante l'installazione iniziale.