Gitea je rychlý a snadno použitelný samoobslužný server git napsaný v Go. Zahrnuje editor souborů úložiště, sledování problémů s projekty, správu uživatelů, upozornění, vestavěnou wiki a mnoho dalšího.
Gitea je odlehčená aplikace, kterou lze nainstalovat na systémy s nízkým výkonem. Pokud hledáte alternativu k Gitlabu s mnohem menší pamětí a nepotřebujete všechny zvonky a píšťalky, které Gitlab nabízí, měli byste zkusit Gitea.
Tento článek vysvětluje, jak nainstalovat a nakonfigurovat Gitea na Ubuntu 20.04.
Předpoklady #
Gitea podporuje jako backend databáze SQLite, PostgreSQL a MySQL / MariaDB.
SQLite se doporučuje pouze pro malé instalace. Větší instalace by měly používat MySQL nebo PostgreSQL.
Jako databázi pro Gitea použijeme SQLite. Pokud ve vašem systému Ubuntu není nainstalován SQLite, nainstalujte jej zadáním následujících příkazů jako uživatel sudo:
sudo apt aktualizace
sudo apt nainstalovat sqlite3
Instalace Gitea #
Gitea poskytuje obrázky Dockeru a lze jej nainstalovat ze zdroje, binárního souboru a jako balíček. Nainstalujeme Gitea z binárního souboru.
Nainstalujte Git #
Prvním krokem je instalace Git na váš server:
sudo apt aktualizace
sudo apt nainstalovat git
Ověřte instalaci zobrazením verze Git:
git --verze
git verze 2.25.1
Vytvořte uživatele Git #
Vytvořte nového uživatele systému, který spustí aplikaci Gitea, zadáním:
sudo adduser \
--Systém \
--shell / bin / bash \
--gecos 'Git Version Control' \
--skupina \
--deaktivované heslo \
--home / home / git \
sakra
Výše uvedený příkaz vytvoří nového uživatele a skupinu s názvem sakra
, a nastavit domovský adresář na / home / git
. Výstup bude vypadat nějak takto:
Přidání uživatele systému 'git' (UID 112) ... Přidání nové skupiny 'git' (GID 118) ... Přidání nového uživatele 'git' (UID 112) se skupinou 'git' ... Vytvoření domovského adresáře '/ home / git' ..
Stáhnout binární soubor Gitea #
Přejděte na stránku Gitea Download a stáhněte si nejnovější binární soubor pro svou architekturu. V době psaní tohoto článku je nejnovější verze 1.10.2. Pokud je k dispozici nová verze, změňte VERZE
proměnná v níže uvedeném příkazu.
Použití wget
stáhnout binární soubor Gitea do / tmp
adresář:
VERZE = 1.14.1
sudo wget -O / tmp / gitea https: // dl.gitea.io / gitea / $ VERSION / gitea - $ VERSION -linux-amd64
Můžete spustit gitea
binární z libovolného místa. Budeme se řídit konvencí a přesuneme binární soubor na / usr / local / bin
adresář:
sudo mv / tmp / gitea / usr / local / bin
Vytvořte binární spustitelný soubor:
sudo chmod + x / usr / local / bin / gitea
Spuštěním následujících příkazů vytvořte adresáře a nastavte požadovaná oprávnění a vlastnictví:
sudo mkdir -p / var / lib / gitea / custom, data, log
sudo chown -R git: git / var / lib / gitea /
sudo chmod -R 750 / var / lib / gitea /
sudo mkdir / etc / gitea
kořen sudo chown: git / etc / gitea
sudo chmod 770 / etc / gitea
Výše uvedená adresářová struktura je doporučena oficiální dokumentací Gitea.
Oprávnění / etc / gitea
adresář jsou nastaveny na 770
aby průvodce instalací mohl vytvořit konfigurační soubor. Po dokončení instalace nastavíme přísnější oprávnění.
Vytvořte soubor Systemd Unit #
Spustíme Gitea jako systémovou službu.
Stáhněte si ukázkový soubor systemd jednotky do / etc / systemd / system
adresář zadáním:
sudo wget https: // raw.githubusercontent.com / go-gitea / gitea / main / contrib / systemd / gitea.služba -P / etc / systemd / system /
Soubor nemusíte upravovat, je nakonfigurován tak, aby odpovídal našemu nastavení.
Povolte a spusťte službu Gitea:
sudo systemctl daemon-reload
sudo systemctl enable - now gitea
Ověřte, že Gitea běží:
sudo systemctl status gitea
● gitea.služba - Gitea (Git s šálkem čaje) Načteno: načteno (/ etc / systemd / system / gitea.servis; povoleno; přednastavení dodavatele: povoleno) Aktivní: aktivní (běží) od čt 2021-05-06 05:32:04 UTC; Před 7 s Hlavní PID: 77781 (gitea) Úkoly: 6 (limit: 470) Paměť: 130.6M CGroup: / system.plátek / gitea.služba └─77781 / usr / local / bin / gitea web --config / etc / gitea / app.v…
Nakonfigurujte Gitea #
Nyní, když je Gitea stažena a spuštěna, můžeme finalizovat instalaci prostřednictvím webového rozhraní.
Ve výchozím nastavení Gitea naslouchá připojení na portu 3000
na všech síťových rozhraních.
Pokud máte na serveru spuštěnou bránu firewall UFW, budete muset otevřít port Gitea. Povolit provoz na portu 3000
, zadejte následující příkaz:
sudo ufw povolit 3000 / tcp
Otevřete prohlížeč, zadejte http: // YOUR_DOMAIN_IR_IP: 3000
, a zobrazí se obrazovka podobná následující:
Nastavení databáze:
- Typ databáze: SQLite3
- Cesta: Použijte absolutní cestu,
/ var / lib / gitea / data / gitea.db
Obecná nastavení aplikace:
- Název webu: Zadejte název vaší organizace.
- Kořenová cesta úložiště: Ponechte výchozí
var / lib / gitea / data / gitea-repozitáře
. - Kořenová cesta Git LFS: Ponechte výchozí
/ var / lib / gitea / data / lfs
. - Spustit jako uživatelské jméno: git
- SSH Server Domain: Zadejte IP adresu vaší domény nebo serveru.
- Port SSH: 22, změňte jej, pokud SSH poslouchá na jiném portu
- Gitea HTTP Listen Port: 3000
- Gitea Base URL: Použijte http a IP adresu vaší domény nebo serveru.
- Cesta protokolu: Ponechte výchozí
/ var / lib / gitea / log
Instalaci spustíte kliknutím na tlačítko „Install Gitea“.
Instalace je okamžitá. Po dokončení budete přesměrováni na přihlašovací stránku.
Klikněte na „Potřebujete účet? Zaregistrujte se nyní." odkaz. První registrovaný uživatel je automaticky přidán do skupiny Správce.
Změňte oprávnění konfiguračního souboru Gitea na jen pro čtení pomocí:
sudo chmod 750 / etc / gitea
sudo chmod 640 / etc / gitea / aplikace.ini
A je to. Gitea byla nainstalována na váš počítač se systémem Ubuntu.
Konfigurace Nginx jako proxy ukončení SSL #
Tento krok je volitelný, ale velmi se doporučuje. Ukončení SSL znamená, že Nginx bude fungovat jako zprostředkující bod mezi aplikací Gitea a webovými klienty, takže budete mít přístup ke Gitea přes HTTPS.
Chcete-li použít Nginx jako reverzní proxy, musíte mít doménu nebo subdoménu ukazující na veřejnou IP adresu vašeho serveru. V tomto příkladu použijeme sakra.příklad.com
.
Nejprve nainstalujte Nginx a vygenerujte bezplatný certifikát Let's Encrypt SSL pomocí následujících pokynů:
- Jak nainstalovat Nginx na Ubuntu 20.04
- Zabezpečte Nginx pomocí Let's Encrypt na Ubuntu 20.04
Po dokončení otevřete textový editor a upravte soubor bloku doménového serveru:
sudo nano / etc / nginx / sites-enabled / git.příklad.com
/ etc / nginx / sites-enabled / git.příklad.comserver poslouchat 80; název_serveru git.příklad.com; zahrnout úryvky / letsencrypt.conf; vrátit 301 https: // git.příklad.com $ request_uri; server naslouchat 443 ssl http2; název_serveru git.příklad.com; proxy_read_timeout 720s; proxy_connect_timeout 720s; proxy_send_timeout 720s; client_max_body_size 50m; # Záhlaví serveru proxy proxy_set_header X-Forwarded-Host $ host; proxy_set_header X-Forwarded-For $ proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $ schéma; proxy_set_header X-Real-IP $ remote_addr; # Parametry SSL ssl_certificate / etc / letsencrypt / live / git.příklad.com / fullchain.pem; ssl_certificate_key / etc / letsencrypt / live / git.příklad.com / privkey.pem; ssl_trusted_certificate / etc / letsencrypt / live / git.příklad.com / chain.pem; zahrnout úryvky / letsencrypt.conf; zahrnout úryvky / SSL.conf; # soubory protokolu access_log / var / log / nginx / git.příklad.com.přístup.protokol; error_log / var / log / nginx / git.příklad.com.chyba.protokol; # Zpracovat / žádat o umístění / proxy_redirect off; proxy_pass http: // 127.0.0.1: 3000;
Nezapomeňte nahradit git.příklad.com s vaší doménou Gitea a nastavte správnou cestu k souborům certifikátů SSL. Provoz HTTP je přesměrován na HTTPS
Změny se projeví až po restartování služby Nginx:
sudo systemctl restart nginx
Dále změňte doménu Gitea a kořenovou adresu URL. Chcete-li tak učinit, otevřete konfigurační soubor a upravte následující řádky:
sudo nano / etc / gitea / app.ini
/ etc / gitea / aplikace.ini[server] DOMAIN = git.příklad.com ROOT_URL = https: // git.příklad.com /
Restartujte službu Gitea zadáním:
sudo systemctl restart gitea
V tomto okamžiku je nakonfigurován proxy Gitea a máte k němu přístup na: https: // git.příklad.com
Konfigurace e-mailových oznámení #
Pokud chcete, aby vaše instance Gitea posílala e-maily s oznámeními, můžete si nainstalovat Postfix nebo použít nějakou transakční poštovní službu, jako jsou 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 / etc / gitea / app.ini
/ etc / gitea / aplikace.ini[mailer] 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.
Aby se změny projevily, restartujte službu Gitea:
sudo systemctl restart gitea
Chcete-li ověřit nastavení a odeslat testovací e-mail, přihlaste se ke Gitea a přejděte na: Správa webu> Konfigurace> Konfigurace SMTP Maileru.
Gitea vám také umožňuje připojit se k Slacku vytvořením webového webhooku a odesíláním oznámení na vaše kanály Slack .
Aktualizace Gitea #
Chcete-li upgradovat na nejnovější verzi Gitea, jednoduše stáhněte a vyměňte binární soubor.
Zastavte službu Gitea:
sudo systemctl stop gitea
Stáhněte si nejnovější verzi Gitea a přesuňte ji do
/ usr / local / bin
adresář:VERZE =
wget -O / tmp / gitea https: // dl.gitea.io / gitea / $ VERSION / gitea - $ VERSION -linux-amd64
sudo mv / tmp / gitea / usr / local / bin
Vytvořte binární spustitelný soubor:
sudo chmod + x / usr / local / bin / gitea
Restartujte službu Gitea:
sudo systemctl restart gitea
A je to.
Závěr #
Tento výukový program vás provedl instalací Gitea na Ubuntu 20.04. Další informace o tom, jak nakonfigurovat instanci Gitea a vytvořit svůj první projekt, najdete na stránce dokumentace Gitea .
Pokud máte dotazy, můžete zanechat komentář níže.