- Gitea je lehká alternativa ke GitLabu a GitHubu, která spotřebovává velmi málo systémových prostředků.
- Instalace je založena na spustitelném binárním souboru spravovaném jako služba prostřednictvím SystemD.
- Použití reverzní proxy s Nginxem je nezbytné pro zajištění zabezpečeného přístupu přes HTTPS.
- Umožňuje migraci stávajících repozitářů z jiných platforem při zachování úloh a tagů.
Pokud vás unavuje spoléhat se na pravidla, náklady nebo dostupnost gigantů jako GitHub nebo GitLab, budování vlastní infrastruktury je cesta vpřed. Mít Git server doma nebo ve vlastní kanceláři vám dává klíče k celému království: absolutní kontrolu nad kódem , úplnou správu přístupů a klid, že nemáte žádná omezení třetích stran na vaše soukromé repozitáře.
Mezi všemi dostupnými možnostmi vyniká Gitea jako klenot. Je to nástroj napsaný v Go, díky čemuž je neuvěřitelně lehký a rychlý , ideální pro ty, kteří nechtějí vyhradit 16 GB RAM pro Git server. Na rozdíl od GitLabu, což je na funkce bohatý, ale na zdroje náročný zaoceánský parník, je Gitea jako motorový člun: jde rovnou k věci, spotřebovává jen velmi málo zdrojů a nabízí velmi známé rozhraní pro každého, kdo používal GitHub.
Rychlé srovnání: Gitea, GitLab a Forgejo
Než se pustíte do instalace, je dobré vědět, do čeho jdete. GitLab je typickou podnikovou volbou, ideální pro velké týmy, které potřebují integrovanou CI/CD, ale vyžaduje výkonný hardware. Gitea je naopak nejlepší volbou pro skromné servery nebo osobní projekty díky své velmi malé paměťové náročnosti. A konečně je tu Forgejo, komunitní fork Gitea; pokud jste purista svobodného softwaru a preferujete otevřenou správu bez korporátních podtextů, je to pro vás ta pravá alternativa.
Co potřebujete, než začnete
Aby vše běželo hladce, ujistěte se, že máte linuxový server (buď Ubuntu, Debian nebo Rocky Linux) s root přístupem. Je také nezbytné mít na počítači nainstalovaný Git a ačkoli Gitea umožňuje použití SQLite, pro produkční prostředí se pro zajištění stability dat důrazně doporučuje PostgreSQL nebo MariaDB.
Příprava půdy v systému
Spouštění Gitea jako root není z bezpečnostních důvodů dobrý nápad. Nejlepší je vytvořit vyhrazeného uživatele. Toho lze dosáhnout spuštěním příkazu adduser --system --shell /bin/bash --group --home /home/gitea giteaJe nezbytné používat /bin/bash jako shell protože Gitea potřebuje komunikovat s git-shell přes SSH. Pokud ještě nemáte Git nainstalovaný, jednoduchý apt install git problém rychle vyřeší.
Instalace binárních souborů a struktura složek
Gitea se dá nainstalovat několika způsoby, ale binární verze je nejjednodušší. Nejnovější stabilní verzi byste měli najít na oficiálních webových stránkách a stáhnout si ji pomocí [metoda/metoda]. wget en /usr/local/bin/giteadám to později spustit oprávnění pomocí chmod +xAby program fungoval správně, je nutné vytvořit řadu specifických adresářů: /etc/gitea pro konfiguraci a /var/lib/gitea pro vlastní data, protokoly a soubory. Nezapomeňte upravit oprávnění k vlastnictví (chown) aby jim uživatel gitea mohl psát.
Konfigurace databáze
Pokud zvolíte PostgreSQL, budete muset kromě databáze nainstalovat balíček a vytvořit specifickou roli se silným heslem. giteadb s kódováním UTF8. Pokud dáváte přednost MariaDB, postup je podobný: vytvoříte databázi a uživatele a ujistíte se, že úložný engine je InnoDB a že server naslouchá na portu 3306.
Automatizace se SystemD
Abyste se vyhnuli ručnímu spouštění Gitey pokaždé, když restartujete server, je nejlepší vytvořit soubor na disku v /etc/systemd/system/gitea.serviceTento soubor informuje systém o tom, že Gitea musí být spuštěna jako službadefinování uživatele, skupiny a binární cesty. Po vytvoření jednoduše spusťte systemctl enable --now gitea a server začne ve výchozím nastavení naslouchat na portu 3000.
První kontakt s webovým rozhraním
Při vstupu http://tu-ip:3000Poté se zobrazí průvodce nastavením. Zde se připojíte k databázi (zadáním hostitele, uživatelského jména a hesla) a definujete obecné nastavení webu, například název instance a základní URL. Je také čas nakonfigurovat SSH server a rozhodnout se, zda chcete, aby se mohl registrovat kdokoli, nebo zda dáváte přednost... zakázat veřejné protokolování aby server zůstal soukromý.
Zabezpečení a profesionální přístup s Nginx
Přístup k Gitea přes port 3000 je neefektivní a nejistý. Ideálním řešením je nastavit reverzní proxy s Nginx . To umožňuje uživatelům přístup k webu přes doménu (např. git.vasedomena.com) a zajišťuje, že veškerá komunikace je šifrována pomocí SSL certifikátů Let's Encrypt . V konfiguraci Nginx jednoduše přesměrujte provoz z portu 443 na port 3000 Gitea a přidejte hlavičky X-Forwarded-For, abyste zabránili ztrátě skutečné IP adresy klienta.
Správa uživatelů a migrace kódu
Pokud jste zakázali otevřené protokolování, můžete prvního správce vytvořit pomocí příkazového řádku s příkazem gitea admin user createJakmile budete uvnitř, můžete přidat své veřejné SSH klíče v uživatelském profilu pro klonování repozitářů bez nutnosti zadávat heslo pokaždé. Pokud již máte kód na GitHubu, Gitea má integrovaný migrační nástroj Automaticky importuje nejen kód, ale také úlohy a tagy.
Údržba a ladění
Údržba Gitea je neuvěřitelně snadná. Pro aktualizaci jednoduše stáhněte nový binární soubor, nahraďte starý a restartujte službu. Pro zálohy použijte příkaz gitea dump je váš nejlepší přítel, protože generuje komprimovaný soubor se všímDatabáze, konfigurace a repozitáře. Pro e-mail můžete nakonfigurovat externí SMTP server (například Gmail) nebo na server nainstalovat Postfix, abyste dostávali oznámení o pull requestech a upozorněních.
Implementace Gitea vám umožňuje mít robustní, lehkou a plně soukromou platformu pro správu verzí, která eliminuje závislost na externích službách prostřednictvím binární instalace, optimalizované databáze a reverzní proxy, která zaručuje bezpečnost provozu přes HTTPS.