Gitea je rýchly a ľahko použiteľný samoobslužný server git napísaný v aplikácii Go. Zahŕňa editor súborov úložiska, sledovanie problémov s projektmi, správu používateľov, oznámenia, zabudovanú wiki a oveľa viac.
Gitea je ľahká aplikácia, ktorú je možné nainštalovať do systémov s nízkym výkonom. Ak hľadáte alternatívu k Gitlabu s oveľa menšou pamäťovou stopou a nepotrebujete všetky zvončeky a píšťalky, ktoré Gitlab ponúka, mali by ste vyskúšať Gitea.
Tento článok vysvetľuje, ako nainštalovať a nakonfigurovať Gitea na Ubuntu 20.04.
Predpoklady #
Gitea podporuje ako databázové backendy SQLite, PostgreSQL a MySQL / MariaDB.
SQLite sa odporúča iba pre malé inštalácie. Väčšie inštalácie by mali používať MySQL alebo PostgreSQL.
Ako databázu pre Gitea použijeme SQLite. Ak vo vašom systéme Ubuntu nie je nainštalovaný SQLite, nainštalujte ho zadaním nasledujúcich príkazov ako užívateľ sudo:
sudo apt aktualizácia
sudo apt nainštalovať sqlite3
Inštaluje sa Gitea #
Gitea poskytuje obrázky Dockeru a je možné ich nainštalovať zo zdroja, binárne súbory a ako balík. Nainštalujeme Gitea z binárnych súborov.
Nainštalujte Git #
Prvým krokom je inštalácia Gitu na váš server:
sudo apt aktualizácia
sudo apt nainštalovať git
Inštaláciu overte zobrazením verzie Git:
git --verzia
git verzia 2.25.1
Vytvorte používateľa Git #
Vytvorte nového používateľa systému, ktorý spustí aplikáciu Gitea, zadaním:
sudo adduser \
--systém \
--shell / bin / bash \
--gecos 'Git Version Control' \
--skupina \
--deaktivované heslo \
--domov / domov / git \
git
Vyššie uvedený príkaz vytvorí nového používateľa a skupinu s názvom git
, a nastavte domovský adresár na / home / git
. Výstup bude vyzerať asi takto:
Pridanie systémového používateľa 'git' (UID 112) ... Pridanie novej skupiny 'git' (GID 118) ... Pridanie nového používateľa 'git' (UID 112) do skupiny 'git' ... Vytvorenie domovského adresára '/ home / git' ..
Stiahnite si Gitea binary #
Prejdite na stránku Gitea Download a stiahnite si najnovšiu binárnu verziu pre svoju architektúru. V čase písania tohto článku je najnovšia verzia 1.10.2. Ak je k dispozícii nová verzia, zmeňte VERZIA
premenná v príkaze nižšie.
Použite wget
na stiahnutie binárneho súboru Gitea v / tmp
adresár:
VERZIA = 1.14.1
sudo wget -O / tmp / gitea https: // dl.gitea.io / gitea / $ VERSION / gitea - $ VERSION -linux-amd64
Môžete spustiť gitea
binárne z ľubovoľného miesta. Budeme postupovať podľa dohovoru a presunieme binárny súbor na / usr / local / bin
adresár:
sudo mv / tmp / gitea / usr / local / bin
Vykonajte spustenie binárneho súboru:
sudo chmod + x / usr / local / bin / gitea
Spustením nasledujúcich príkazov vytvorte adresáre a nastavte požadované povolenia a vlastníctvo:
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
sudo chown root: git / etc / gitea
sudo chmod 770 / etc / gitea
Vyššie uvedenú adresárovú štruktúru odporúča oficiálna dokumentácia Gitea.
Povolenia / etc / gitea
adresár sú nastavené na 770
aby sprievodca inštaláciou mohol vytvoriť konfiguračný súbor. Po dokončení inštalácie nastavíme prísnejšie povolenia.
Vytvorte súbor systémovej jednotky #
Spustíme Gitea ako systémovú službu.
Stiahnite si vzorový súbor systémovej jednotky do / etc / systemd / system
adresár zadaním:
sudo wget https: // raw.githubusercontent.com / go-gitea / gitea / main / contrib / systemd / gitea.služba -P / etc / systemd / system /
Súbor nemusíte upravovať, je nakonfigurovaný tak, aby zodpovedal nášmu nastaveniu.
Povoliť a spustiť službu Gitea:
sudo systemctl daemon-reload
sudo systemctl povoliť - teraz gitea
Overte, či je Gitea spustená:
sudo systemctl status gitea
● gitea.služba - Gitea (Git so šálkou čaju) Načítané: načítané (/ etc / systemd / system / gitea.služba; povolené; prednastavenie dodávateľa: povolené) Aktívne: aktívne (v prevádzke) od št. 2021-05-06 05:32:04 UTC; Pred 7 s Hlavné PID: 77781 (gitea) Úlohy: 6 (limit: 470) Pamäť: 130.6M CGroup: / systém.plátok / gitea.služba └─77781 / usr / local / bin / gitea web --config / etc / gitea / app.v…
Nakonfigurujte Gitea #
Teraz, keď je Gitea stiahnutá a spustená, môžeme dokončiť inštaláciu prostredníctvom webového rozhrania.
Gitea predvolene počúva pripojenia na porte 3 000
na všetkých sieťových rozhraniach.
Ak máte na serveri spustenú bránu firewall UFW, budete musieť otvoriť port Gitea. Povoliť prenos na porte 3 000
, zadajte nasledujúci príkaz:
sudo ufw povoliť 3000 / tcp
Otvorte prehliadač a zadajte http: // YOUR_DOMAIN_IR_IP: 3000
, a zobrazí sa obrazovka podobná nasledujúcej:
Nastavenia databázy:
- Typ databázy: SQLite3
- Cesta: Použite absolútnu cestu,
/ var / lib / gitea / data / gitea.db
Všeobecné nastavenia aplikácie:
- Názov stránky: Zadajte názov svojej organizácie.
- Cesta koreňového úložiska: Ponechajte predvolené
var / lib / gitea / data / gitea-repositories
. - Rootová cesta Git LFS: Ponechajte predvolené nastavenie
/ var / lib / gitea / data / lfs
. - Spustiť ako používateľské meno: git
- SSH Server Domain: Zadajte svoju doménu alebo IP adresu servera.
- Port SSH: 22, zmeňte ho, ak SSH počúva na inom porte
- Port počúvania Gitea HTTP: 3000
- Gitea Base URL: Použite http a IP adresu vašej domény alebo servera.
- Cesta protokolu: Ponechajte predvolenú hodnotu
/ var / lib / gitea / log
Inštaláciu spustíte kliknutím na tlačidlo „Install Gitea“.
Inštalácia je okamžitá. Po dokončení budete presmerovaní na prihlasovaciu stránku.
Kliknite na „Potrebujete účet? Zaregistrujte sa teraz.”Odkaz. Prvý registrovaný užívateľ je automaticky pridaný do skupiny Admin.
Zmeňte povolenia konfiguračného súboru Gitea na iba na čítanie pomocou:
sudo chmod 750 / etc / gitea
sudo chmod 640 / etc / gitea / app.ini
To je všetko. Gitea bola nainštalovaná na vašom počítači Ubuntu.
Konfigurácia Nginx ako Proxy ukončenia SSL #
Tento krok je voliteľný, ale veľmi sa odporúča. Ukončenie protokolu SSL znamená, že Nginx bude fungovať ako sprostredkovateľský bod medzi aplikáciou Gitea a webovými klientmi, takže k nej budete mať prístup cez HTTPS.
Ak chcete použiť Nginx ako reverzný proxy server, musíte mať doménu alebo subdoménu ukazujúcu na verejnú IP adresu vášho servera. V tomto príklade použijeme git.príklad.com
.
Najskôr si nainštalujte Nginx a vygenerujte bezplatný certifikát Let's Encrypt SSL podľa pokynov nižšie:
- Ako nainštalovať Nginx na Ubuntu 20.04
- Zabezpečte Nginx pomocou Let's Encrypt na Ubuntu 20.04
Po dokončení otvorte textový editor a upravte súbor blokovania doménového servera:
sudo nano / etc / nginx / sites-enabled / git.príklad.com
/ etc / nginx / sites-enabled / git.príklad.comserver počúvať 80; server_name git.príklad.com; zahrnúť úryvky / letsencrypt.conf; návrat 301 https: // git.príklad.com $ request_uri; server posluch 444 ssl http2; server_name git.príklad.com; proxy_read_timeout 720s; proxy_connect_timeout 720s; proxy_send_timeout 720s; client_max_body_size 50m; # Hlavičky servera 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; # Parametre SSL ssl_certificate / etc / letsencrypt / live / git.príklad.com / fullchain.pem; ssl_certificate_key / etc / letsencrypt / live / git.príklad.com / privkey.pem; ssl_trusted_certificate / etc / letsencrypt / live / git.príklad.com / retazec.pem; zahrnúť úryvky / letsencrypt.conf; zahrnúť úryvky / SSL.conf; # súbory protokolu access_log / var / log / nginx / git.príklad.com.prístup.guľatina; error_log / var / log / nginx / git.príklad.com.chyba.guľatina; # Spracovať / vyžiadať umiestnenie / proxy_redirect vypnuté; proxy_pass http: // 127.0.0.1: 3000;
Nezabudnite vymeniť git.príklad.sk s vašou doménou Gitea a nastavte správnu cestu k súborom certifikátov SSL. Prevádzka HTTP je presmerovaná na HTTPS
Aby sa zmeny prejavili, reštartujte službu Nginx:
sudo systemctl restart nginx
Ďalej zmeňte doménu Gitea a koreňovú adresu URL. Ak to chcete urobiť, otvorte konfiguračný súbor a upravte nasledujúce riadky:
sudo nano / etc / gitea / app.ini
/ etc / gitea / app.ini[server] DOMAIN = git.príklad.com ROOT_URL = https: // git.príklad.com /
Reštartujte službu Gitea zadaním:
sudo systemctl restart gitea
V tomto okamihu je nakonfigurovaný proxy server Gitea a máte k nemu prístup na adrese: https: // git.príklad.com
Konfigurácia e-mailových upozornení #
Ak chcete, aby vaša inštancia Gitea posielala e-maily s upozorneniami, môžete si nainštalovať Postfix alebo použiť niektorú transakčnú poštovú službu, napríklad SendGrid, MailChimp, MailGun alebo SES.
Ak chcete povoliť e-mailové upozornenia, otvorte konfiguračný súbor a upravte nasledujúce riadky:
sudo nano / etc / gitea / app.ini
/ etc / gitea / app.ini[mailer] ENABLED = true HOST = SMTP_SERVER: SMTP_PORT FROM = SENDER_EMAIL USER = SMTP_USER PASSWD = YOUR_SMTP_PASSWORD
Nezabudnite uviesť správne informácie o serveri SMTP.
Aby sa zmeny prejavili, reštartujte službu Gitea:
sudo systemctl restart gitea
Ak chcete overiť nastavenia a odoslať testovací e-mail, prihláste sa do služby Gitea a prejdite na: Správa stránok> Konfigurácia> Konfigurácia poštového servera SMTP.
Gitea vám tiež umožňuje pripojiť sa k Slacku vytvorením webového webhooku a odosielať upozornenia na vaše kanály Slack .
Aktualizuje sa Gitea #
Ak chcete upgradovať na najnovšiu verziu Gitea, jednoducho si stiahnite a vymeňte binárny súbor.
Zastavte službu Gitea:
sudo systemctl stop gitea
Stiahnite si najnovšiu verziu Gitea a presuňte ju do
/ usr / local / bin
adresár:VERZIA =
wget -O / tmp / gitea https: // dl.gitea.io / gitea / $ VERSION / gitea - $ VERSION -linux-amd64
sudo mv / tmp / gitea / usr / local / bin
Vykonajte spustenie binárneho súboru:
sudo chmod + x / usr / local / bin / gitea
Reštartujte službu Gitea:
sudo systemctl restart gitea
To je všetko.
Záver #
Tento tutoriál vás prevedie inštaláciou Gitea na Ubuntu 20.04. Viac informácií o tom, ako nakonfigurovať inštanciu Gitea a vytvoriť prvý projekt, nájdete na stránke dokumentácie Gitea .
Ak máte otázky, neváhajte zanechať komentár nižšie.