A Gitea egy gyors és könnyen használható, Go-ban írt, önállóan üzemeltetett git szerver. Tartalmazza a lerakatfájl-szerkesztőt, a projektkérdések nyomon követését, a felhasználók kezelését, az értesítéseket, a beépített wikit és még sok minden mást.
A Gitea egy könnyű alkalmazás, és alacsony fogyasztású rendszerekre is telepíthető. Ha a Gitlab helyett egy sokkal kisebb memóriaterületet keres, és nincs szüksége az összes harangra és sípra, amelyet a Gitlab kínál, akkor próbálja meg a Gitea-t.
Ez a cikk elmagyarázza a Gitea telepítését és konfigurálását az Ubuntu 20-ra.04.
Előfeltételek #
A Gitea támogatja az SQLite, a PostgreSQL és a MySQL / MariaDB adatbázis háttereként.
Az SQLite csak kicsi telepítésekhez ajánlott. Nagyobb telepítéseknél a MySQL vagy a PostgreSQL kell legyen.
Az SQLite-t fogjuk használni a Gitea adatbázisaként. Ha az SQLite nincs telepítve az Ubuntu rendszerére, telepítse a következő parancsok megadásával sudo felhasználóként:
sudo apt frissítés
sudo apt install sqlite3
A Gitea # telepítése
A Gitea Docker képeket biztosít, és forrásból, binárisan és csomagként is telepíthető. Telepítjük a Giteát binárisból.
Git # telepítése
Az első lépés a Git telepítése a szerverre:
sudo apt frissítés
sudo apt install git
Ellenőrizze a telepítést a Git verzió megjelenítésével:
git --verzió
git 2. verzió.25.1
Hozzon létre egy Git-felhasználót #
Hozzon létre egy új rendszerhasználót, amely a Gitea alkalmazást futtatja:
sudo adduser \
--rendszer \
--shell / bin / bash \
--gecos 'Git Version Control' \
--csoport \
--tiltott jelszó \
--home / home / git \
git
A fenti parancs új felhasználót és csoportot hoz létre git
, és állítsa a saját könyvtárat / home / git
. A kimenet az alábbiak szerint fog kinézni:
A „git” rendszerfelhasználó hozzáadása (UID 112)… Új „git” csoport hozzáadása (GID 118)… Új „git” (112 UID) felhasználó hozzáadása a „git” csoporthoz ... Saját könyvtár létrehozása / home / git '…
Gitea bináris # letöltése
Lépjen a Gitea letöltés oldalára, és töltse le az architektúra legújabb bináris változatát. A cikk írásakor a legújabb verzió 1.10.2. Ha elérhető egy új verzió, módosítsa a VÁLTOZAT
változó az alábbi parancsban.
Használat wget
letölteni a Gitea bináris fájlt a / tmp
Könyvtár:
VÁLTOZAT = 1.14.1
sudo wget -O / tmp / gitea https: // dl.gitea.io / gitea / $ VERSION / gitea - $ VERSION -linux-amd64
Futtathatja a gitea
bináris bármilyen helyről. Kövessük az egyezményt, és a bináris fájlt a / usr / local / bin
Könyvtár:
sudo mv / tmp / gitea / usr / local / bin
Legyen a bináris futtatható:
sudo chmod + x / usr / local / bin / gitea
Futtassa az alábbi parancsokat a könyvtárak létrehozásához, valamint a szükséges engedélyek és tulajdonjog beállításához:
sudo mkdir -p / var / lib / gitea / egyéni, adatok, napló
sudo chown -R git: git / var / lib / gitea /
sudo chmod -R 750 / var / lib / gitea /
sudo mkdir / etc / gitea
sudo chown gyökér: git / etc / gitea
sudo chmod 770 / etc / gitea
A fenti könyvtárstruktúrát a hivatalos Gitea dokumentáció ajánlja.
A. Engedélyei / etc / gitea
könyvtár beállítása 770
hogy a telepítővarázsló létrehozhassa a konfigurációs fájlt. Miután a telepítés befejeződött, korlátozóbb engedélyeket állítunk be.
Hozzon létre egy Systemd egységfájlt #
Futtatjuk a Gitea-t mint systemd szolgáltatást.
Töltse le a minta systemd unit fájlt a / etc / systemd / system
könyvtár beírásával:
sudo wget https: // nyers.githubusercontent.com / go-gitea / gitea / main / contrib / systemd / gitea.szolgáltatás -P / etc / systemd / system /
Nem kell szerkesztenie a fájlt, az úgy van konfigurálva, hogy megfeleljen a mi beállításunknak.
Engedélyezze és indítsa el a Gitea szolgáltatást:
sudo systemctl daemon-reload
sudo systemctl enable - most gitea
Ellenőrizze, hogy a Gitea fut-e:
sudo systemctl status gitea
● gitea.szolgáltatás - Gitea (Git egy csésze teával) Betöltve: betöltve (/ etc / systemd / system / gitea.szolgáltatás; engedélyezve; gyártói előre beállított: engedélyezve) Aktív: aktív (fut) csütörtök 2021-05-06 05:32:04 UTC óta; 7s ago Main PID: 77781 (gitea) Feladatok: 6 (korlát: 470) Memória: 130.6M CGroup: / rendszer.szelet / gitea.szolgáltatás └─77781 / usr / local / bin / gitea web --config / etc / gitea / app.ini…
Gitea # beállítása
A Gitea letöltése és futtatása után a webes felületen keresztül befejezhetjük a telepítést.
Alapértelmezés szerint a Gitea a porton figyeli a kapcsolatokat 3000
minden hálózati interfészen.
Ha UFW tűzfal fut a szerveren, akkor meg kell nyitnia a Gitea portot. A forgalom engedélyezése a kikötőben 3000
, írja be a következő parancsot:
sudo ufw 3000 / tcp engedélyezése
Nyissa meg a böngészőt, írja be http: // YOUR_DOMAIN_IR_IP: 3000
, és megjelenik a következőhöz hasonló képernyő:
Adatbázis beállítások:
- Adatbázis típusa: SQLite3
- Útvonal: Használjon abszolút utat,
/ var / lib / gitea / data / gitea.db
Alkalmazás általános beállításai:
- Webhely címe: Írja be a szervezet nevét.
- Repository Root Path: Hagyja az alapértelmezett értéket
var / lib / gitea / data / gitea-repositories
. - Git LFS gyökérútvonal: Hagyja az alapértelmezett értéket
/ var / lib / gitea / data / lfs
. - Futtatás felhasználónévként: git
- SSH Server Domain: Írja be domainjét vagy szerverének IP-címét.
- SSH port: 22, változtassa meg, ha az SSH más porton hallgat
- Gitea HTTP figyelő port: 3000
- Gitea Base URL: Használja a http-t és a domainje vagy a szerver IP-címét.
- Napló elérési útja: Hagyja az alapértelmezett értéket
/ var / lib / gitea / log
A telepítés megkezdéséhez nyomja meg az „Install Gitea” gombot.
A telepítés azonnali. Miután elkészült, átirányít a bejelentkezési oldalra.
Kattintson a „Fiókra van szükség? Regisztrálj most.”Link. Az első regisztrált felhasználó automatikusan hozzáadódik az Adminisztrátor csoporthoz.
Módosítsa a Gitea konfigurációs fájl engedélyeit csak olvashatóra:
sudo chmod 750 / etc / gitea
sudo chmod 640 / etc / gitea / app.ini
Ez az. A Gitea telepítve volt az Ubuntu gépre.
Az Nginx beállítása SSL-terminálproxyként #
Ez a lépés nem kötelező, de nagyon ajánlott. Az SSL felmondás azt jelenti, hogy az Nginx közvetítő pontként fog működni a Gitea alkalmazás és a webes ügyfelek között, így HTTPS-en keresztül is hozzáférhet a Giteához.
Az Nginx fordított proxyként való használatához rendelkeznie kell egy domainnel vagy aldomainnel, amely a szerver nyilvános IP-jére mutat. Ebben a példában a következőket fogjuk használni git.példa.com
.
Először telepítse az Nginx-et, és hozzon létre egy ingyenes Let Encrypt SSL tanúsítványt az alábbi útmutatók segítségével:
- Az Nginx telepítése az Ubuntu 20-ra.04
- Biztonságos Nginx a Titkosítás az Ubuntu 20-on.04
Ha elkészült, nyissa meg a szövegszerkesztőt, és szerkessze a tartománykiszolgáló blokkfájlját:
sudo nano / etc / nginx / sites-enabled / git.példa.com
/ etc / nginx / sites-enabled / git.példa.comszerver hallgat 80; szerver_név git.példa.com; tartalmazzon kivonatokat / letrecripteket.konf; return 301 https: // git.példa.com $ request_uri; szerver hallgassa 443 ssl http2; szerver_neve git.példa.com; proxy_read_timeout 720s; proxy_connect_timeout 720s; proxy_send_timeout 720s; ügyfél_max_test_méret 50m; # Proxy fejlécek proxy_set_header X-Forwarded-Host $ host; proxy_set_header X-Forwarded-For $ proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $ séma; proxy_set_header X-Real-IP $ remote_addr; # SSL paraméterek ssl_certificate / etc / letsencrypt / live / git.példa.com / fullchain.pem; ssl_certificate_key / etc / letsencrypt / live / git.példa.com / privkey.pem; ssl_trusted_certificate / etc / letsencrypt / live / git.példa.com / chain.pem; kódrészleteket / letrecripteket tartalmaz.konf; tartalmazza a részleteket / ssl.konf; # naplófájlok access_log / var / log / nginx / git.példa.com.hozzáférés.napló; error_log / var / log / nginx / git.példa.com.hiba.napló; # Kezelés / helykérés / proxy_redirect ki; proxy_pass http: // 127.0.0.1: 3000;
Ne felejtsd el kicserélni a git-et.példa.com a Gitea domainnel, és állítsa be az SSL tanúsítványfájlok helyes elérési útját. A HTTP-forgalmat átirányítják a HTTPS-re
Indítsa újra az Nginx szolgáltatást, hogy a módosítások életbe lépjenek:
sudo systemctl indítsa újra az nginx fájlt
Ezután módosítsa a Gitea tartományt és a root URL-t. Ehhez nyissa meg a konfigurációs fájlt, és szerkessze a következő sorokat:
sudo nano / etc / gitea / app.ini
/ etc / gitea / app.ini[szerver] DOMAIN = git.példa.com ROOT_URL = https: // git.példa.com /
Indítsa újra a Gitea szolgáltatást a következő gépeléssel:
sudo systemctl indítsa újra a gitea-t
Ezen a ponton a Gitea proxy konfigurálva van, és a következő címen érheti el: https: // git.példa.com
E-mail értesítések konfigurálása #
Ha azt szeretné, hogy a Gitea példány értesítési e-maileket küldjön, telepítheti a Postfix szoftvert, vagy használhat valamilyen tranzakciós levelezési szolgáltatást, például SendGrid, MailChimp, MailGun vagy SES.
Az e-mailes értesítések engedélyezéséhez nyissa meg a konfigurációs fájlt, és szerkessze a következő sorokat:
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
Győződjön meg arról, hogy a megfelelő SMTP-kiszolgáló adatait adta meg.
Indítsa újra a Gitea szolgáltatást a módosítások életbe lépéséhez:
sudo systemctl indítsa újra a gitea-t
A beállítások ellenőrzéséhez és egy tesztüzenet küldéséhez jelentkezzen be a Gitea webhelyre, és lépjen a következő helyre: Webhelyfelügyelet> Konfiguráció> SMTP Mailer konfiguráció.
A Gitea emellett lehetővé teszi, hogy csatlakozzon a Slack-hez webhook létrehozásával, és értesítéseket küldjön a Slack-csatornáira .
A Gitea frissítése #
A legújabb Gitea verzióra való frissítéshez egyszerűen töltse le és cserélje le a bináris fájlt.
Állítsa le a Gitea szolgáltatást:
sudo systemctl stop gitea
Töltse le a legújabb Gitea verziót, és helyezze át a
/ usr / local / bin
Könyvtár:VÁLTOZAT =
wget -O / tmp / gitea https: // dl.gitea.io / gitea / $ VERSION / gitea - $ VERSION -linux-amd64
sudo mv / tmp / gitea / usr / local / bin
Legyen a bináris futtatható:
sudo chmod + x / usr / local / bin / gitea
Indítsa újra a Gitea szolgáltatást:
sudo systemctl indítsa újra a gitea-t
Ez az.
Következtetés
Ez a bemutató végigvezette Önt a Gitea telepítésén az Ubuntu 20-on.04. A Gitea-példány konfigurálásáról és az első projekt létrehozásáról további információt a Gitea dokumentációs oldalán talál .
Ha kérdése van, nyugodtan hagyjon megjegyzést alább.