Kā instalēt Gitea Ubuntu 20.04

Gitea ir ātrs un ērti lietojams pašreģistrēts git serveris, kas rakstīts Go. Tas ietver krātuves failu redaktoru, projekta problēmu izsekošanu, lietotāju pārvaldību, paziņojumus, iebūvēto wiki un daudz ko citu.

Gitea ir viegla lietojumprogramma, un to var uzstādīt mazjaudas sistēmās. Ja jūs meklējat alternatīvu Gitlab ar daudz mazāku atmiņas nospiedumu un jums nav vajadzīgi visi zvani un svilpes, ko Gitlab piedāvā, jums vajadzētu pamēģināt Gitea.

Šajā rakstā ir paskaidrots, kā instalēt un konfigurēt Gitea operētājsistēmā Ubuntu 20.04.

Priekšnosacījumi #

Gitea atbalsta SQLite, PostgreSQL un MySQL / MariaDB kā datu bāzes aizmuguri.

SQLite ir ieteicams tikai nelielām instalācijām. Lielākām instalācijām jāizmanto MySQL vai PostgreSQL.

Mēs izmantosim SQLite kā Gitea datu bāzi. Ja SQLite nav instalēta jūsu Ubuntu sistēmā, instalējiet to, kā sudo lietotājam ievadot šādas komandas:

sudo apt atjauninājumssudo apt instalēt sqlite3

Gitea instalēšana #

Gitea nodrošina Docker attēlus, un to var instalēt no avota, binārā un kā pakotne. Mēs instalēsim Gitea no binārā.

Instalēt Git #

Pirmais solis ir Git instalēšana jūsu serverī:

sudo apt atjauninājumssudo apt instalēt git

Pārbaudiet instalāciju, parādot Git versiju:

git --versija

git 2. versija.25.1 

Izveidojiet Git lietotāju #

Izveidojiet jaunu sistēmas lietotāju, kurš darbinās Gitea lietojumprogrammu, ierakstot:

sudo adduser \ --sistēma \ --shell / bin / bash \ --gecos 'Git versijas vadība' \ --grupa \ --invalīds-parole \ --mājas / mājas / git \ git

Iepriekš minētā komanda izveido jaunu lietotāju un grupu ar nosaukumu git, un iestatiet mājas direktoriju uz / home / git. Rezultāts izskatīsies apmēram šādi:

Pievieno sistēmas lietotāju 'git' (UID 112) ... Pievieno jaunu grupu 'git' (GID 118) ... Pievieno jaunu lietotāju 'git' (UID 112) ar grupu 'git' ... Izveido mājas direktoriju '/ home / git' .. 

Lejupielādēt Gitea bināro #

Dodieties uz Gitea lejupielādes lapu un lejupielādējiet jaunāko bināro failu savai arhitektūrai. Rakstīšanas laikā jaunākā versija ir 1.10.2. Ja ir pieejama jauna versija, nomainiet VERSIJA mainīgais zemāk esošajā komandā.

Izmantot wget lai lejupielādētu bināro Gitea / tmp direktorijs:

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

Jūs varat palaist gitea binārs no jebkuras vietas. Mēs sekosim konvencijai un pārvietosim bināro failu uz / usr / local / bin direktorijs:

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

Padarīt bināro izpildāmo:

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

Palaidiet zemāk esošās komandas, lai izveidotu direktorijus un iestatītu nepieciešamās atļaujas un īpašumtiesības:

sudo mkdir -p / var / lib / gitea / pielāgots, dati, žurnālssudo chown -R git: git / var / lib / gitea /sudo chmod -R 750 / var / lib / gitea /sudo mkdir / etc / giteasudo chown sakne: git / etc / giteasudo chmod 770 / etc / gitea

Iepriekš norādīto direktoriju struktūru iesaka oficiālā Gitea dokumentācija.

Programmas atļaujas / etc / gitea direktorijā ir iestatīts uz 770 lai instalēšanas vednis varētu izveidot konfigurācijas failu. Kad instalēšana būs pabeigta, mēs iestatīsim ierobežojošākas atļaujas.

Izveidot Systemd vienības failu #

Mēs palaidīsim Gitea kā sistēmas pakalpojumu.

Lejupielādējiet sistēmasd vienības faila paraugu / etc / systemd / system direktoriju, ierakstot:

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

Jums nav nepieciešams rediģēt failu, tas ir konfigurēts tā, lai tas atbilstu mūsu iestatījumiem.

Iespējojiet un palaidiet pakalpojumu Gitea:

sudo systemctl daemon-reloadsudo systemctl iespējot - tagad gitea

Pārbaudiet, vai darbojas Gitea:

sudo systemctl status gitea

● gitea.pakalpojums - Gitea (Git ar tasi tējas) Ielādēts: ielādēts (/ etc / systemd / system / gitea.apkalpošana; iespējots; pārdevēja sākotnējais iestatījums: iespējots) Aktīvs: aktīvs (darbojas) kopš otrdienas 2021-05-06 05:32:04 UTC; Pirms 7 sekundēm Galvenais PID: 77781 (gitea) Uzdevumi: 6 (ierobežojums: 470) Atmiņa: 130.6M CGroup: / sistēma.šķēle / gitea.pakalpojums └─77781 / usr / local / bin / gitea web --config / etc / gitea / app.ini… 

Konfigurēt Gitea #

Tagad, kad Gitea ir lejupielādēta un darbojas, mēs varam pabeigt instalēšanu, izmantojot tīmekļa saskarni.

Pēc noklusējuma Gitea klausās savienojumus ostā 3000 visās tīkla saskarnēs.

Ja jūsu serverī darbojas UFW ugunsmūris, jums būs jāatver Gitea ports. Lai atļautu satiksmi ostā 3000, ievadiet šādu komandu:

sudo ufw atļaut 3000 / tcp

Atveriet pārlūkprogrammu, ierakstiet http: // YOUR_DOMAIN_IR_IP: 3000, un parādīsies šāds ekrāns:

Datu bāzes iestatījumi:

• Datu bāzes tips: SQLite3
• Ceļš: izmantojiet absolūtu ceļu, / var / lib / gitea / data / gitea.db

Lietojumprogrammas vispārīgie iestatījumi:

• Vietnes nosaukums: ievadiet savas organizācijas nosaukumu.
• Repozitorija saknes ceļš: atstājiet noklusējumu var / lib / gitea / data / gitea-repositories.
• Git LFS saknes ceļš: atstājiet noklusējuma iestatījumu / var / lib / gitea / data / lfs.
• Palaist kā lietotājvārds: git
• SSH servera domēns: ievadiet savu domēnu vai servera IP adresi.
• SSH ports: 22, mainiet to, ja SSH klausās citā portā
• Gitea HTTP klausīšanās ports: 3000
• Gitea bāzes URL: izmantojiet http un savu domēna vai servera IP adresi.
• Žurnāla ceļš: atstājiet noklusējuma iestatījumu / var / lib / gitea / log

Iestatījumus var mainīt jebkurā laikā, rediģējot Gitea konfigurācijas failu.

Lai sāktu instalēšanu, nospiediet pogu “Install Gitea”.

Instalācija ir tūlītēja. Pēc pabeigšanas jūs tiksiet novirzīts uz pieteikšanās lapu.

Noklikšķiniet uz “Nepieciešams konts? Reģistrējies tagad.”Saite. Pirmais reģistrētais lietotājs tiek automātiski pievienots administratoru grupai.

Mainiet Gitea konfigurācijas faila atļaujas uz tikai lasāmu, izmantojot:

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

Tieši tā. Gitea ir instalēta jūsu Ubuntu mašīnā.

Nginx konfigurēšana kā SSL izbeigšanas starpniekserveris #

Šis solis nav obligāts, taču tas ir ļoti ieteicams. SSL izbeigšana nozīmē, ka Nginx darbosies kā starpnieks starp Gitea lietojumprogrammu un tīmekļa klientiem, lai jūs varētu piekļūt Gitea, izmantojot HTTPS.

Lai izmantotu Nginx kā apgriezto starpniekserveri, jums ir jābūt domēnam vai apakšdomēnam, kas norāda uz jūsu servera publisko IP. Šajā piemērā mēs izmantosim git.piemērs.com.

Vispirms instalējiet Nginx un izveidojiet bezmaksas Let's Encrypt SSL sertifikātu, izmantojot tālāk sniegtos ceļvežus:

• Kā instalēt Nginx Ubuntu 20.04
• Nodrošiniet Nginx ar programmu Encrypt vietnē Ubuntu 20.04

Kad tas ir izdarīts, atveriet teksta redaktoru un rediģējiet domēna servera bloķēšanas failu:

sudo nano / etc / nginx / sites-enabled / git.piemērs.com

/ etc / nginx / iespējotas vietnes / git.piemērs.com

serveris klausīties 80; servera_nosaukums git.piemērs.com; ietver fragmentus / letšifrēšanu.konf; atgriešanās 301 https: // git.piemērs.com $ request_uri;  serveris klausīties 443 ssl http2; servera_nosaukums git.piemērs.com; proxy_read_timeout 720s; proxy_connect_timeout 720s; proxy_send_timeout 720s; klienta_maks. ķermeņa izmērs 50m; # Starpniekservera galvenes proxy_set_header X-Forwarded-Host $ resursdators; proxy_set_header X-Forwarded-For $ proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $ shēma; proxy_set_header X-Real-IP $ remote_addr; # SSL parametri ssl_certificate / etc / letsencrypt / live / git.piemērs.com / fullchain.pem; ssl_certificate_key / etc / letsencrypt / live / git.piemērs.com / privkey.pem; ssl_trusted_certificate / etc / letsencrypt / live / git.piemērs.com / chain.pem; ietver fragmentus / letšifrēšanu.konf; ietver fragmentus / ssl.konf; # žurnāla faili access_log / var / log / nginx / git.piemērs.com.piekļuvi.žurnāls; error_log / var / log / nginx / git.piemērs.com.kļūda.žurnāls; # Handle / pieprasa atrašanās vietu / proxy_redirect off; proxy_pass http: // 127.0.0.1: 3000;  

Neaizmirstiet nomainīt git.piemērs.com ar savu Gitea domēnu un iestatiet pareizo ceļu uz SSL sertifikātu failiem. HTTP trafiks tiek novirzīts uz HTTPS

Restartējiet Nginx pakalpojumu, lai izmaiņas stātos spēkā:

sudo systemctl restartējiet nginx

Pēc tam mainiet Gitea domēnu un saknes URL. Lai to izdarītu, atveriet konfigurācijas failu un rediģējiet šādas rindas:

sudo nano / etc / gitea / app.ini

/ etc / gitea / app.ini

[serveris] DOMAIN = git.piemērs.com ROOT_URL = https: // git.piemērs.com / 

Restartējiet Gitea pakalpojumu, ierakstot:

sudo systemctl restartējiet gitea

Šajā brīdī ir konfigurēts Gitea starpniekserveris, un tam varat piekļūt: https: // git.piemērs.com

E-pasta paziņojumu konfigurēšana #

Ja vēlaties, lai jūsu Gitea instance sūta paziņojumu e-pastus, varat instalēt Postfix vai izmantot kādu darījumu pasta pakalpojumu, piemēram, SendGrid, MailChimp, MailGun vai SES.

Lai iespējotu e-pasta paziņojumus, atveriet konfigurācijas failu un rediģējiet šādas rindas:

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 

Pārliecinieties, vai esat ievietojis pareizo SMTP servera informāciju.

Restartējiet pakalpojumu Gitea, lai izmaiņas stātos spēkā:

sudo systemctl restartējiet gitea

Lai pārbaudītu iestatījumus un nosūtītu testa e-pastu, piesakieties vietnē Gitea un dodieties uz: Vietnes administrēšana> Konfigurācija> SMTP Mailer konfigurācija.

Gitea ļauj arī izveidot savienojumu ar Slack, izveidojot tīmekļa tīmekļa āķi un nosūtīt paziņojumus uz saviem Slack kanāliem .

Gitea jaunināšana #

Lai jauninātu uz jaunāko Gitea versiju, vienkārši lejupielādējiet un nomainiet bināro failu.

1. Pārtrauciet pakalpojumu Gitea:

   sudo systemctl stop gitea

2. Lejupielādējiet jaunāko Gitea versiju un pārvietojiet to uz / usr / local / bin direktorijs:

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

3. Padarīt bināro izpildāmo:

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

4. Restartējiet pakalpojumu Gitea:

   sudo systemctl restartējiet gitea

Tieši tā.

Secinājums Nr

Šī apmācība iepazīstināja jūs ar Gitea instalēšanu Ubuntu 20.04. Lai iegūtu papildinformāciju par Gitea instances konfigurēšanu un pirmā projekta izveidi, apmeklējiet Gitea dokumentācijas lapu .

Ja jums ir jautājumi, nekautrējieties atstāt komentāru zemāk.