Kako instalirati Giteu na Ubuntu 20.04

Gitea je brz i jednostavan za upotrebu, samo hostirani git poslužitelj napisan u programu Go. Uključuje uređivač datoteka spremišta, praćenje problema s projektima, upravljanje korisnicima, obavijesti, ugrađeni wiki i još mnogo toga.

Gitea je lagana aplikacija i može se instalirati na sustave s malim napajanjem. Ako tražite alternativu Gitlabu s mnogo manjim memorijskim otiskom i ne trebaju vam sva zvona i zvižduci koje Gitlab nudi, tada biste trebali pokušati Gitea.

Ovaj članak objašnjava kako instalirati i konfigurirati Giteu na Ubuntu 20.04.

Preduvjeti #

Gitea podržava SQLite, PostgreSQL i MySQL / MariaDB kao pozadinske baze podataka.

SQLite se preporučuje samo za male instalacije. Veće instalacije trebaju koristiti MySQL ili PostgreSQL.

Koristit ćemo SQLite kao bazu podataka za Gitea. Ako SQLite nije instaliran na vašem Ubuntu sustavu, instalirajte ga unošenjem sljedećih naredbi kao sudo korisnik:

sudo apt ažuriranjesudo apt instalirati sqlite3

Instaliranje Gitee #

Gitea pruža Docker slike i može se instalirati iz izvora, binarno i kao paket. Giteu ćemo instalirati iz binarne datoteke.

Instalirajte Git #

Prvi korak je instaliranje Gita na vaš poslužitelj:

sudo apt ažuriranjesudo apt instalirati git

Potvrdite instalaciju prikazivanjem verzije Git:

git --verzija

git verzija 2.25.1 

Stvorite Git korisnika #

Stvorite novog korisnika sustava koji će pokretati aplikaciju Gitea upisivanjem:

sudo adduser \ --sustav \ --školjka / kanta / bash \ --gecos 'Git kontrola verzije' \ --grupa \ --invalid-lozinka \ --home / home / git \ git

Gornja naredba stvara novog korisnika i grupu s imenom git, i postavite početni direktorij na / home / git. Izlaz će izgledati otprilike u nastavku:

Dodavanje korisnika sustava 'git' (UID 112) ... Dodavanje nove grupe 'git' (GID 118) ... Dodavanje novog korisnika 'git' (UID 112) s grupom 'git' ... Izrada matičnog direktorija '/ home / git' .. 

Preuzmi Gitea binarni #

Idite na stranicu za preuzimanje Gitea i preuzmite najnoviji binarni format za svoju arhitekturu. U vrijeme pisanja ovog članka, najnovija verzija je 1.10.2. Ako je dostupna nova verzija, promijenite VERZIJA varijabla u naredbi ispod.

Koristiti wget za preuzimanje Gitea binarnog softvera u / tmp imenik:

VERZIJA = 1.14.1sudo wget -O / tmp / gitea https: // dl.gitea.io / gitea / $ VERSION / gitea - $ VERSION -linux-amd64

Možete pokrenuti gitea binarni s bilo kojeg mjesta. Slijedit ćemo konvenciju i premjestiti binarni na / usr / local / bin imenik:

sudo mv / tmp / gitea / usr / local / bin

Napravite binarnu izvršnu datoteku:

sudo chmod + x / usr / local / bin / gitea

Pokrenite naredbe u nastavku za stvaranje direktorija i postavljanje potrebnih dozvola i vlasništva:

sudo mkdir -p / var / lib / gitea / custom, data, logsudo chown -R git: git / var / lib / gitea /sudo chmod -R 750 / var / lib / gitea /sudo mkdir / etc / giteasudo chown root: git / etc / giteasudo chmod 770 / etc / gitea

Gornju strukturu direktorija preporučuje službena dokumentacija Gitee.

Dopuštenja / etc / gitea direktorij je postavljen na 770 tako da čarobnjak za instalaciju može stvoriti konfiguracijsku datoteku. Nakon dovršetka instalacije postavit ćemo restriktivnija dopuštenja.

Stvorite datoteku Systemd jedinice #

Vodit ćemo Giteu kao sistemsku uslugu.

Preuzmite uzorak datoteke sistemske jedinice na / etc / systemd / system direktorij upisivanjem:

sudo wget https: // raw.githubusercontent.com / go-gitea / gitea / main / contrib / systemd / gitea.usluga -P / etc / systemd / system /

Ne morate uređivati ​​datoteku, ona je konfigurirana tako da odgovara našoj postavci.

Omogućite i pokrenite uslugu Gitea:

sudo systemctl daemon-reloadsudo systemctl omogućiti --now gitea

Provjerite radi li Gitea:

sudo systemctl status gitea

● gitea.usluga - Gitea (Git sa šalicom čaja) Učitana: učitana (/ etc / systemd / system / gitea.servis; omogućeno; unaprijed postavljeno: dobavljač aktivan: aktivan (aktivan) od čet 2021-05-06 05:32:04 UTC; Prije 7s Glavni PID: 77781 (gitea) Zadaci: 6 (ograničenje: 470) Memorija: 130.6M CGroup: / sustav.kriška / gitea.usluga └─77781 / usr / local / bin / gitea web --config / etc / gitea / app.ini .. 

Konfigurirajte Gitea #

Sada kada je Gitea preuzeta i pokrenuta, instalaciju možemo dovršiti putem web sučelja.

Prema zadanim postavkama, Gitea preslušava veze na priključku 3000 na svim mrežnim sučeljima.

Ako na vašem poslužitelju radi UFW vatrozid, morat ćete otvoriti Gitea priključak. Da bi se omogućio promet na luci 3000, unesite sljedeću naredbu:

sudo ufw dopustiti 3000 / tcp

Otvorite preglednik, upišite http: // VAŠ_DOMEN_IR_IP: 3000, i pojavit će se zaslon sličan sljedećem:

Postavke baze podataka:

• Tip baze podataka: SQLite3
• Put: Koristite apsolutni put, / var / lib / gitea / data / gitea.db

Opće postavke aplikacije:

• Naslov web mjesta: Unesite naziv svoje organizacije.
• Korijenski put spremišta: Ostavite zadani spremišta var / lib / gitea / data / gitea.
• Git LFS korijenski put: Ostavite zadani / var / lib / gitea / data / lfs.
• Pokreni kao korisničko ime: git
• Domena SSH poslužitelja: Unesite svoju domenu ili IP adresu poslužitelja.
• SSH priključak: 22, promijenite ga ako SSH sluša na drugom priključku
• Gitea HTTP port za slušanje: 3000
• Gitea osnovni URL: Upotrijebite http i IP adresu svoje domene ili poslužitelja.
• Put dnevnika: Ostavite zadano / var / lib / gitea / log

Postavke možete promijeniti u bilo kojem trenutku uređivanjem konfiguracijske datoteke Gitea.

Da biste započeli instalaciju, pritisnite gumb "Install Gitea".

Instalacija je trenutna. Kada završite, bit ćete preusmjereni na stranicu za prijavu.

Kliknite na „Trebate račun? Registriraj se." veza. Prvi registrirani korisnik automatski se dodaje u Admin grupu.

Promijenite dozvole konfiguracijske datoteke Gitea na samo za čitanje pomoću:

sudo chmod 750 / etc / giteasudo chmod 640 / etc / gitea / app.ini

To je to. Gitea je instalirana na vaš Ubuntu stroj.

Konfiguriranje Nginxa kao SSL raskidnog proxyja #

Ovaj korak nije obavezan, ali je toplo preporučljiv. Prekid SSL-a znači da će Nginx djelovati kao posrednička točka između Gitea aplikacije i web klijenata, tako da Gitei možete pristupiti putem HTTPS-a.

Da biste koristili Nginx kao obrnuti proxy, morate imati domenu ili poddomenu koja upućuje na javnu IP adresu vašeg poslužitelja. U ovom ćemo primjeru koristiti git.primjer.com.

Prvo instalirajte Nginx i generirajte besplatni Let's Encrypt SSL certifikat pomoću vodiča u nastavku:

• Kako instalirati Nginx na Ubuntu 20.04
• Osigurajte Nginx pomoću Let's Encrypt na Ubuntu 20.04

Kada završite, otvorite svoj uređivač teksta i uredite datoteku bloka poslužitelja domene:

sudo nano / etc / nginx / sites-enabled / git.primjer.com

/ etc / nginx / sites-enabled / git.primjer.com

poslužitelj preslušaj 80; ime_poslužitelja git.primjer.com; uključuju isječke / letsencrypt.conf; povratak 301 https: // git.primjer.com $ request_uri;  poslužitelj slušati 443 ssl http2; ime_poslužitelja git.primjer.com; proxy_read_timeout 720s; proxy_connect_timeout 720s; proxy_send_timeout 720s; client_max_body_size 50m; # Proxy zaglavlja proxy_set_header X-Forwarded-Host $ host; proxy_set_header X-Forwarded-Za $ proxy_add_x_forwarded_for; proxy_set_header X-Proslijeđena-Proto $ shema; proxy_set_header X-Real-IP $ remote_addr; # SSL parametri ssl_certificate / etc / letsencrypt / live / git.primjer.com / puni lanac.pem; ssl_certificate_key / etc / letsencrypt / live / git.primjer.com / privkey.pem; ssl_trusted_certificate / etc / letsencrypt / live / git.primjer.com / lanac.pem; uključuju isječke / letsencrypt.conf; uključuju isječke / ssl.conf; # datoteke dnevnika access_log / var / log / nginx / git.primjer.com.pristup.trupac; dnevnik pogrešaka / var / log / nginx / git.primjer.com.pogreška.trupac; # Obraditi / zatražiti lokaciju / proxy_redirect isključeno; proxy_pass http: // 127.0.0.1: 3000;  

Ne zaboravite zamijeniti git.primjer.com s vašom Gitea domenom i postavite ispravan put do datoteka SSL certifikata. HTTP promet preusmjerava se na HTTPS

Ponovo pokrenite uslugu Nginx da bi promjene stupile na snagu:

sudo systemctl ponovno pokrenite nginx

Zatim promijenite Gitea domenu i korijenski url. Da biste to učinili, otvorite konfiguracijsku datoteku i uredite sljedeće retke:

sudo nano / etc / gitea / app.ini

/ etc / gitea / app.ini

[poslužitelj] DOMEN = git.primjer.com ROOT_URL = https: // git.primjer.com / 

Ponovo pokrenite uslugu Gitea upisivanjem:

sudo systemctl ponovno pokrenite gitea

U ovom je trenutku Gitea proxy konfiguriran i možete mu pristupiti na: https: // git.primjer.com

Konfiguriranje obavijesti putem e-pošte #

Ako želite da vam instanca Gitea šalje e-poštu s obavijestima, možete instalirati Postfix ili upotrijebiti neku transakcijsku uslugu pošte kao što su SendGrid, MailChimp, MailGun ili SES.

Da biste omogućili obavijesti e-poštom, otvorite konfiguracijsku datoteku i uredite sljedeće retke:

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 

Obavezno unesite ispravne podatke o SMTP poslužitelju.

Ponovno pokrenite uslugu Gitea da bi promjene stupile na snagu:

sudo systemctl ponovno pokrenite gitea

Da biste provjerili postavke i poslali testnu e-poštu, prijavite se na Gitea i idite na: Administracija web mjesta> Konfiguracija> Konfiguracija SMTP Mailer-a.

Gitea vam također omogućuje povezivanje sa Slackom stvaranjem web web kuke i slanjem obavijesti na vaše Slack kanale .

Nadogradnja Gitee #

Da biste nadogradili na najnoviju verziju Gitee, jednostavno preuzmite i zamijenite binarni.

1. Zaustavite uslugu Gitea:

   sudo systemctl zaustavi gitea

2. Preuzmite najnoviju verziju Gitee i premjestite je na / usr / local / bin imenik:

   VERZIJA =wget -O / tmp / gitea https: // dl.gitea.io / gitea / $ VERSION / gitea - $ VERSION -linux-amd64sudo mv / tmp / gitea / usr / local / bin

3. Napravite binarnu izvršnu datoteku:

   sudo chmod + x / usr / local / bin / gitea

4. Ponovo pokrenite uslugu Gitea:

   sudo systemctl ponovno pokrenite gitea

To je to.

Zaključak #

Ovaj vas je vodič vodio kroz instalaciju Gitee na Ubuntu 20.04. Za više informacija o tome kako konfigurirati svoju Gitea instancu i stvoriti svoj prvi projekt, posjetite stranicu dokumentacije Gitea .

Ako imate pitanja, slobodno ostavite komentar ispod.