Jak nainstalovat a konfigurovat gogy na Ubuntu 18.04

Gogs je samo hostovaný open source git server napsaný v Go. Zahrnuje editor souborů úložiště, sledování problémů s projektem a vestavěnou wiki.

Gogs je odlehčená aplikace a lze ji nainstalovat do systémů s nízkým výkonem. Pokud hledáte alternativu k Gitlab s mnohem menší pamětí a nepotřebujete všechny zvonky a píšťalky, které Gitlab nabízí, pak byste určitě měli vyzkoušet Gogs.

Tento tutoriál popisuje kroky k instalaci a konfiguraci Gogů na Ubuntu 18.04. Stejné pokyny platí pro Ubuntu 16.04 a jakékoli jiné distribuce založené na Ubuntu.

Než začnete

Gogs mohou používat SQLite, PostgreSQL nebo MySQL / MariaDB databázi pro ukládání všech svých dat.

V tomto tutoriálu použijeme SQLite jako vybranou databázi. Pokud SQLite není nainstalován ve vašem systému, můžete jej nainstalovat zadáním:

sudo apt install sqlite3

Pro další úroveň zabezpečení se doporučuje nastavit základní bránu firewall. Postupujte podle pokynů uvedených v příručce Jak nastavit bránu Firewall pomocí nástroje UFW v příručce Ubuntu 18.04.

Instalace Gogs

Nainstalujeme Gogs z binárních. Instalace je docela přímý proces.

Nainstalujte Git

Prvním krokem je instalace Git na váš server. Chcete-li to provést, aktualizujte index místního balíčku a nainstalujte balíček git spuštěním následujících příkazů jako uživatel sudo:

sudo apt update sudo apt install git

Ověřte instalaci zobrazením verze Git:

git --version

git version 2.17.1

Vytvořte uživatele Git

Vytvořte nového uživatele systému ke spuštění služby Gogs zadáním:

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

Příkaz vytvoří uživatele a nastaví domovský adresář na /home/git . Výstup bude vypadat takto:

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'…

Stáhněte si fotografii Gogs binární

Navštivte stránku Stáhnout Gogs a stáhněte si nejnovější binární soubory pro svou architekturu. V době psaní je nejnovější verze 0, 11, 86, pokud je k dispozici nová verze, změňte proměnnou VERSION v níže uvedeném příkazu.

Stáhněte si archiv Gogs v adresáři /tmp pomocí následujícího příkazu wget:

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

Po dokončení stahování rozbalte soubor tar.gz Gogs a přesuňte jej do adresáře /home/git :

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

Spusťte následující příkaz a změňte vlastnictví instalačního adresáře Gogs na git uživatele a skupiny:

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

Vytvořte soubor systémové jednotky

Gogs je dodáván se souborem Systemd, který je již nakonfigurován tak, aby odpovídal našemu nastavení.

Zkopírujte soubor do adresáře /etc/systemd/system/ zadáním:

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

Po dokončení spusťte a aktivujte službu Gogs:

sudo systemctl start gogs sudo systemctl enable gogs

Ověřte, zda je služba úspěšně spuštěna:

* 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

Nainstalujte Gogs pomocí webového instalátoru

Nyní, když je aplikace Gogs stažena a spuštěna, je čas dokončit instalaci prostřednictvím webového rozhraní.

Spusťte prohlížeč, zadejte http://YOUR_DOMAIN_IR_IP:3000 a objeví se obrazovka podobná následující:

První registrovaný uživatel je automaticky přidán do skupiny Správce.

A je to. Gogs byl nainstalován na vašem Ubuntu stroji.

Konfigurace Nginxu jako proxy pro ukončení SSL

Tento krok je volitelný, ale důrazně se doporučuje. Chcete-li použít Nginx jako reverzní proxy, musíte mít doménu nebo subdoménu směřující na veřejnou IP adresu vašeho serveru. V tomto tutoriálu použijeme gogs.example.com .

Nejprve nainstalujte Nginx a vygenerujte bezplatný certifikát Pojďme šifrovat SSL podle následujících pokynů:

Po dokončení otevřete textový editor a upravte soubor bloku serveru domény:

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

Nezapomeňte nahradit gogs.example.com vaší doménou Gogs a nastavit správnou cestu k souborům certifikátů SSL. Všechny požadavky HTTP budou přesměrovány na Restartujte službu Nginx, aby se změny projevily:

sudo systemctl restart nginx

Dále musíme změnit doménu Gogs a kořenovou adresu URL. Otevřete konfigurační soubor a upravte následující řádky:

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

DOMAIN = gogs.example.com ROOT_URL =

Restartujte službu Gogs zadáním:

sudo systemctl restart gogs

Nyní je služba Gogs nakonfigurována a můžete k ní přistupovat na https://gogs.example.com : https://gogs.example.com

Konfigurace e-mailových oznámení

Aby mohli Gogs zasílat notifikační e-maily, můžete nainstalovat Postfix nebo použít nějakou transakční poštovní službu, jako je SendGrid, MailChimp, MailGun nebo SES.

Chcete-li povolit e-mailová oznámení, otevřete konfigurační soubor a upravte následující řádky:

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

Ujistěte se, že jste zadali správné informace o serveru SMTP.

Restartujte službu Gogs, aby se změny projevily:

sudo systemctl restart gogs

Gogs vám také umožňuje připojit se k Slacku vytvořením webového webhook a zasílání upozornění na vaše Slack kanály.

Aktualizace Gogs

K upgradu Gogů je třeba provést několik ručních kroků.

1. První zastávka služby Gogs:

   sudo systemctl stop gogs

   Přejmenujte instalační adresář Gogs.

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

   Stáhněte si nejnovější verzi Gogs a přesuňte ji do adresáře /home/git :

   VERSION= wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp sudo tar xf /tmp/gogs_*_linux_amd64.tar.gz -C /home/git

   Ujistěte se, že změníte VERSION s aktuální verzí vydání Gogs.

   Zkopírujte custom adresáře, data a log do extrahovaného adresáře pomocí následujícího příkazu rsync:

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

   Nakonec spusťte službu Gogs:

   sudo systemctl restart gogs

A je to.

Závěr

Tento tutoriál vás provedl instalací a konfigurací Gogů na Ubuntu 18.04. Nyní můžete vytvořit svůj první projekt a začít používat nový server Gogs.

ubuntu gogy