Kako instalirati i konfigurirati gogove na ubuntu 18.04

Gogs je domaćin s otvorenim izvorom git poslužitelja napisan u Go. Sadrži uređivač datoteka spremišta, praćenje problema projekta i ugrađeni wiki.

Gogs je lagana aplikacija i može se instalirati na sustave s malim pogonom. Ako tražite alternativu Gitlabu s mnogo manjim otiskom memorije i ne trebaju vam sva zvona i zviždaljke koje Gitlab nudi, onda svakako biste trebali isprobati Gogs.

Ovaj je vodič opisao korake za instaliranje i konfiguriranje programa Gogs na Ubuntu 18.04. Iste upute vrijede i za Ubuntu 16.04 i bilo koju drugu distribuciju temeljenu na Ubuntuu.

Prije nego što počneš

Gogovi mogu koristiti SQLite, PostgreSQL ili MySQL / MariaDB bazu podataka za pohranu svih svojih podataka.

U ovom ćemo vodiču koristiti SQLite kao bazu podataka po izboru. Ako SQLite nije instaliran na vašem sustavu, možete ga instalirati upisivanjem:

sudo apt install sqlite3

Za dodatni sloj sigurnosti preporučuje se postavljanje osnovnog vatrozida. Slijedite korake u našem Postavi vatrozida pomoću UFW-a na Ubuntu 18.04 vodiču.

Instaliranje Gogs-a

Instalirat ćemo Gogs iz binarnih podataka. Instalacija je prilično izravan postupak.

Instalirajte Git

Prvi korak je instaliranje Gita na vaš poslužitelj. Da biste to učinili, osvježite indeks lokalnog paketa i instalirajte git paket izvodeći sljedeće naredbe kao sudo korisnik:

sudo apt update sudo apt install git

Provjerite instalaciju prikazom Git verzije:

git --version

git version 2.17.1

Izradite Git korisnika

Stvorite novog korisnika sustava za pokretanje usluge Gogs tako da upišete:

sudo adduser --system --group --disabled-password --shell /bin/bash --home /home/git --gecos 'Git Version Control' git

Naredba će stvoriti korisnika i postaviti kućni direktorij na /home/git . Rezultat će izgledati ovako:

Adding system user `git' (UID 111)… Adding new group `git' (GID 116)… Adding new user `git' (UID 111) with group `git'… Creating home directory `/home/git'…

Preuzmite Gogs binarni

Posjetite stranicu za preuzimanje Gogs i preuzmite najnovije binarne datoteke za svoju arhitekturu. U trenutku pisanja teksta najnovija verzija je 0.11.86, a ako je dostupna nova verzija, promijenite varijablu VERSION u naredbi dolje.

Preuzmite Arhivu Gogs u /tmp direktorij pomoću sljedeće naredbe wget:

VERSION=0.11.86 wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp

Nakon dovršetka preuzimanja, izvadite datoteku Gogs tar.gz i premjestite je u /home/git direktorij:

sudo tar xf /tmp/gogs_*_linux_amd64.tar.gz -C /home/git

Pokrenite sljedeću naredbu da promijenite vlasništvo nad instalacijskim direktorijom Gogs na korisničko i grupno git:

sudo chown -R git: /home/git/gogs

Stvorite sistemsku datoteku jedinica

Gogs dolazi s datotekom Systemd jedinice koja je već konfigurirana da odgovara našem postavljanju.

Kopirajte datoteku u /etc/systemd/system/ direktorijum tako da upišete:

sudo cp /home/git/gogs/scripts/systemd/gogs.service /etc/systemd/system/

Kada završite, pokrenite i omogućite uslugu Gogs:

sudo systemctl start gogs sudo systemctl enable gogs

Provjerite je li usluga uspješno pokrenuta:

* gogs.service - Gogs Loaded: loaded (/etc/systemd/system/gogs.service; enabled; vendor preset: enabled) Active: active (running) since Thu 2019-04-25 04:13:44 PDT; 9s ago Main PID: 14376 (gogs) Tasks: 8 (limit: 2319) CGroup: /system.slice/gogs.service `-14376 /home/git/gogs/gogs web

Instalirajte Gogs putem web alata za instalaciju

Sada kada se Gogs preuzima i pokreće, vrijeme je da instalaciju dovršite putem web sučelja.

Otvorite preglednik, utipkajte http://YOUR_DOMAIN_IR_IP:3000 i prikazat će se zaslon sličan sljedećem:

Prvi registrirani korisnik automatski se dodaje grupi administratora.

To je to. Gogs je instaliran na vaš Ubuntu stroj.

Konfiguriranje Nginxa kao proxy SSL raskida

Ovaj je korak neobavezan, no vrlo se preporučuje. Za korištenje Nginx-a kao obrnutog proxyja trebate imati domenu ili poddomena koja upućuje na javni IP vašeg poslužitelja. U ovom ćemo vodiču koristiti gogs.example.com .

Prvo instalirajte Nginx i generirajte besplatni šifriraj SSL certifikat slijedeći vodiče u nastavku:

Nakon završetka otvorite uređivač teksta i uredite datoteku bloka poslužitelja domene:

sudo nano /etc/nginx/sites-enabled/gogs.example.com /etc/nginx/sites-enabled/gogs.example.com

server { listen 80; server_name gogs.example.com; include snippets/letsencrypt.conf; return 301 https://gogs.example.com$request_uri; } server { listen 443 ssl http2; server_name gogs.example.com; proxy_read_timeout 720s; proxy_connect_timeout 720s; proxy_send_timeout 720s; client_max_body_size 50m; # Proxy headers proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Real-IP $remote_addr; # SSL parameters ssl_certificate /etc/letsencrypt/live/gogs.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/gogs.example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/gogs.example.com/chain.pem; include snippets/letsencrypt.conf; include snippets/ssl.conf; # log files access_log /var/log/nginx/gogs.example.com.access.log; error_log /var/log/nginx/gogs.example.com.error.log; # Handle / requests location / { proxy_redirect off; proxy_pass http://127.0.0.1:3000; } }

Ne zaboravite da gogs.example.com zamijenite domenom Gogs i postavite ispravan put do datoteka s SSL certifikatima. Svi HTTP zahtjevi bit će preusmjereni na Ponovno pokrenite Nginx uslugu da bi promjene stupile na snagu:

sudo systemctl restart nginx

Zatim moramo promijeniti Gogs domenu i URL korijena. Da biste to učinili, otvorite konfiguracijsku datoteku i uredite sljedeće retke:

sudo nano /home/git/gogs/custom/conf/app.ini /home/git/gogs/custom/conf/app.ini

DOMAIN = gogs.example.com ROOT_URL =

Ponovo pokrenite uslugu Gogs upisivanjem:

sudo systemctl restart gogs

U ovom trenutku Gogs je konfiguriran i možete mu pristupiti na: https://gogs.example.com

Konfiguriranje obavijesti putem e-pošte

Kako bi Gogs mogao slati e-poruke s obavijestima, možete instalirati Postfix ili koristiti neku transakcijsku poštu kao što su SendGrid, MailChimp, MailGun ili SES.

Da biste omogućili obavijesti e-poštom, otvorite konfiguracijsku datoteku i uredite sljedeće retke:

sudo nano /home/git/gogs/custom/conf/app.ini /home/git/gogs/custom/conf/app.ini

ENABLED = true HOST = SMTP_SERVER:SMTP_PORT FROM = SENDER_EMAIL USER = SMTP_USER PASSWD = YOUR_SMTP_PASSWORD

Obavezno stavite ispravne podatke SMTP poslužitelja.

Ponovo pokrenite uslugu Gogs da bi promjene stupile na snagu:

sudo systemctl restart gogs

Gogs vam omogućuje i povezivanje s Slackom tako što stvarate web web kuku i šaljete obavijesti na svoje Slack kanale.

Nadogradnja Gogs-a

Za nadogradnju Gogs-a potrebno je nekoliko ručnih koraka.

1. Prvo zaustavite uslugu Gogs:

   sudo systemctl stop gogs

   Preimenujte instalacijski imenik Gogs.

   sudo mv /home/git/gogs{, _old}

   Preuzmite najnoviju verziju Gogs i premjestite je u /home/git direktorij:

   VERSION= wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp

   Obavezno promijenite VERSION stvarnom verzijom izdanja Gogs.

   Kopirajte custom , data i mape log u izvađeni direktorij pomoću sljedeće naredbe rsync:

   sudo rsync -a /home/git/gogs_old/{custom, data, log} /home/git/gogs/

   Na kraju, pokrenite uslugu Gogs:

   sudo systemctl restart gogs

To je to.

Zaključak

Ovaj je vodič vodio kroz instalaciju i konfiguraciju Gogs-a na Ubuntu 18.04. Sada možete stvoriti svoj prvi projekt i započeti koristiti svoj novi Gogs poslužitelj.

ubuntu gogs