Hvernig á að setja upp Gitea á Ubuntu 20.04 með SQLite 3

Gíteu er opinn uppspretta smiðjuhugbúnaðarpakki til að hýsa útgáfustýringu hugbúnaðarþróunar með því að nota Git og aðra samvinnueiginleika eins og villurakningu, wikis og endurskoðun kóða. Það styður sjálfshýsingu en býður einnig upp á ókeypis opinbert fyrsta aðila tilvik sem hýst er í Kína á skýi DiDi. Gitea er einnig með mun minna minnisfótspor en Gitlab og er mjög mælt með hugbúnaði fyrir fyrirtæki og þróunaraðila á kerfum með litlum krafti.

Í eftirfarandi handbók muntu læra hvernig á að setja upp og stilla Gitea á Ubuntu 20.04 með því að nota SQLite 3 gagnagrunninn. Segjum að þú hafir ekki sett upp SQLite 3 áður. Ekki hika við að skoða leiðbeiningar okkar um Uppsetning SQLite 3 og SQLite 3 vafra í Ubuntu 20.04.

Forsendur

  • SQLite 3 gagnagrunnur settur upp.
  • Ubuntu 20.04.2.0 LTS (Focal Fossa) Server eða Desktop
  • Rótaraðgangur eða Sudo notendaréttindi.
  • Git sett upp á netþjóninum þínum.
  • wget eða curl uppsett

Athugaðu og uppfærðu Ubuntu kerfið þitt.

sudo apt update && sudo apt upgrade -y

Settu upp SQLite 3, eftir okkar leiðbeina fyrir betri upplýsingar.

sudo apt install sqlite3

Settu upp Git. Fylgdu leiðbeiningunum okkar um hvernig á að setja upp nýjustu útgáfuna af Git á Ubuntu 20.04.

sudo apt install git

Gakktu úr skugga um að annað hvort curl eða wget sé uppsett.

sudo apt install wget curl

Fáðu


Búðu til Git notanda til að keyra Gitea

Áður en þú hoppar of langt á undan er fyrsta skrefið að búa til Git notanda sem mun keyra Gitea forritið. Til að búa til nýjan Git notandareikning skaltu slá inn eftirfarandi skipun.

sudo adduser \
    --system \
    --shell /bin/bash \
    --gecos 'Git Version Control' \
    --group \
    --disabled-password \
    --home /home/git \
    git

Þú ættir að fá eftirfarandi framleiðsla:

~$ sudo adduser \
   --system \
      --shell /bin/bash \
      --gecos 'Git Version Control' \
      --group \
      --disabled-password \
      --home /home/git \
      git
   [sudo] password for bytesboss: 
   Adding system user git' (UID 129) ... Adding new groupgit' (GID 136) …
   Adding new user git' (UID 129) with groupgit' …
   Creating home directory `/home/git' … 

Sækja Gitea

Næst skaltu heimsækja Gitea síðu niðurhals og finndu útgáfuna sem hentar Ubuntu arkitektúr. Eins og er er útgáfa 1.14.3 nýjasta útgáfan af Gitea. Þetta mun þó breytast með tímanum. Þegar þú hefur fundið uppfærða hlekkinn skaltu hlaða niður pakkanum með því að nota wget skipunina sem hér segir.

wget https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64

Niðurhalið er um það bil rúmlega 100MB. Þegar því er lokið skaltu færa tvöfalda skrána á endanlegan stað og gefa henni leyfi til að framkvæma svo þú getir haldið áfram í uppsetningarstigið.

sudo mv gitea-1.14.3-linux-amd64 /usr/local/bin \
 sudo mv gitea-1.14.3-linux-amd64 gitea \
 sudo chmod +x gitea

Fáðu


Búðu til Gitea möppur

Þú verður að búa til möppurnar sjálfur fyrir Gitea. Hér að neðan er möppuuppbygging sem mælt er með sem er "mælt“ eftir Gitea. Sláðu inn eftirfarandi til að búa til möppur.

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 \

Athugið, "/etc/gitea" skráin er nú með chmod 777 leyfi. Þetta er gert til að uppsetningin geti gengið snurðulaust fyrir sig án þess að hiksta. Þegar þessu er lokið þarftu að breyta þessu í öruggari chmod heimild.

Búðu til Gitea Systemd þjónustu

Næst, til að setja upp og keyra Gitea, þarftu að búa til Systemd skrá. Sæktu þann sem Gitea býður upp á þarf ekki að breyta með því að slá inn eftirfarandi skipun.

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

Nú skaltu endurhlaða púkann þinn og virkja Gitea systemd þjónustuna.

sudo systemctl daemon-reload && sudo systemctl enable --now gitea

Næst skaltu ganga úr skugga um að Gitea sé í gangi og að engar villur hafi átt sér stað. Algengasta vandamálið er að fólk gleymir að setja upp möppur. Ef þú sérð þetta, farðu síðan nokkur skref til baka og endurtaktu endurhleðsluferlið púkans.

Úttakið ætti að vera svipað og hér að neðan ef það er rétt sett upp.

$ sudo systemctl status gitea
 ● gitea.service - Gitea (Git with a cup of tea)
      Loaded: loaded (/etc/systemd/system/gitea.service; enabled; vendor preset: enabled)
      Active: active (running) since Sat 2021-06-26 22:47:23 PDT; 7s ago
    Main PID: 3214 (gitea)
       Tasks: 8 (limit: 4617)
      Memory: 184.9M
      CGroup: /system.slice/gitea.service
              └─3214 /usr/local/bin/gitea web --config /etc/gitea/app.ini

Fáðu


Settu upp Gitea í gegnum vefviðmótið

Þegar Gitea þjónustan gengur vel, ræsir eftirfarandi ferli vefviðmótið til að klára uppsetninguna. Sjálfgefið hlustar Gitea á port 3000 á öllum netviðmótum.

UFW

Ef þú ert með UFW þarftu að leyfa höfnina eins og hér að neðan.

sudo ufw allow 3000/tcp

Vefur HÍ

Opnaðu netvafrann þinn og sláðu inn IP tölu netþjónsins sem hýst er með:3000 sem tengi.

Dæmi:

http://192.168.53.101:3000

Ef þú hefur sett upp gáttarleyfisregluna rétt kemurðu á eftirfarandi skjá fyrir neðan.

ubuntu 20.04 gitea web ui fyrstu stillingarsíða

Þú þarft að breyta stillingunum eins og lýst er hér að neðan. Athugaðu að hægt er að breyta þessum auðveldlega síðar.

Gagnagrunnsstillingar:

  •     Tegund gagnagrunns: SQLite3
  •     Leið: Notaðu algjöra slóð, /var/lib/gitea/data/gitea.db

Almennar stillingar forrita:

  •     Titill síðu: Sláðu inn nafn fyrirtækis þíns.
  •     Rótarstígur geymslu: Skildu eftir sjálfgefna var/lib/gitea/data/gitea-repositories.
  •     Git LFS Root Path: Skildu eftir sjálfgefið /var/lib/gitea/data/lfs. 
  •     Keyra sem notandanafn: git
  •     SSH netþjónslén: Sláðu inn IP-tölu lénsins eða netþjónsins.
  •     SSH höfn: 22, breyttu því ef SSH er að hlusta á annarri port
  •     Gitea HTTP hlustunarhöfn: 3000
  •     Gitea Base URL: Notaðu http og IP tölu lénsins eða netþjónsins þíns.
  •     Log stíg: Skildu eftir sjálfgefið /var/lib/gitea/log

Þegar því er lokið geturðu ýtt á „Settu upp Gitea” hnappur staðsettur neðst á stillingasíðunni.

gita settu upp núna ubuntu 20.04

Þegar uppsetningunni er lokið verður þér vísað aftur á innskráningarsíðu. Þú þarft að skrá reikning sem verður sjálfkrafa gerður að fyrsta reikningsskrá kerfisstjórans.

ubuntu 20.04 lts gitea admin reikningur

Þú hefur búið til admin reikning á Gitea þjónustunni og þú hefur allt sett upp. Það myndi hjálpa ef þú tryggir nú möppurnar þínar. Eins og útskýrt var í upphafi handbókarinnar voru þeir gerðir 777 fyrir hnökralausa uppsetningu. Næst skaltu slá inn eftirfarandi skipun til að breyta heimildunum öruggum.

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

Til hamingju, þú hefur sett upp Gitea á Ubuntu 20.04 LTS stýrikerfinu þínu.

Settu upp Gitea tölvupósttilkynningar

Gitea getur sent tilkynningar með tölvupósti. Þú getur sett upp Postfix eða annan pakka sem notar venjulegar póstskipanir. Til að gera tilkynningum kleift að opna eftirfarandi skrá með nano ritstjóra:

sudo nano /etc/gitea/app.ini

Næst skaltu breyta eftirfarandi sniðmáti hér að neðan með notandanafni þínu, lykilorði og SMTP miðlaraupplýsingum.

[mailer]
 ENABLED = true
 HOST    = SMTP_SERVER:SMTP_PORT
 FROM    = SENDER_EMAIL
 USER    = SMTP_USER
 PASSWD  = YOUR_SMTP_PASSWORD

Þegar því er lokið skaltu endurræsa Gitea þjónustuna.

sudo systemctl restart gitea

Mælt er með því að fara í vefviðmótið, skrá þig inn á admin reikninginn þinn og senda prufupóst til að staðfesta að allt virki rétt. Leiðin til að gera þetta er Stjórnun > Stillingar > Stillingar SMTP-pósts.


Fáðu


Settu upp Nginx sem öfugt SSL umboð fyrir Gitea

Mælt er með næsta skrefi ef þú þjónar Gitea utan innra nets. Allt með utanaðkomandi tengingum sem koma inn ætti að vera sett upp með SSL og tryggt þegar þú átt samskipti við bakendann þinn.

Fyrst skaltu búa til nýja stillingarskrá fyrir Gitea síðuna þína eða breyta núverandi:

sudo nano /etc/nginx/sites-enabled/gitea.conf

Sláðu síðan inn eftirfarandi. Þetta er aðeins leiðarvísir. SSL er hægt að gera með þjónustu eins og Cloudflare or Skulum dulrita.

server {
   listen 80;
   server_name git.example.com;
   include snippets/letsencrypt.conf;
server {
   listen 80;
   server_name git.example.com;
   include snippets/letsencrypt.conf;
   return 301 https://git.example.com$request_uri;
 }
 server {
   listen 443 ssl http2;
   server_name git.example.com;
   proxy_read_timeout 720s;
   proxy_connect_timeout 720s;
   proxy_send_timeout 720s;
   client_max_body_size 50m;
 # Proxy headers
   proxy_set_header X-Forwarded-Host $host;
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   proxy_set_header X-Forwarded-Proto $scheme;
   proxy_set_header X-Real-IP $remote_addr;

# SSL parameters
   ssl_certificate /etc/letsencrypt/live/git.example.com/fullchain.pem;
   ssl_certificate_key /etc/letsencrypt/live/git.example.com/privkey.pem;
   ssl_trusted_certificate /etc/letsencrypt/live/git.example.com/chain.pem;
   include snippets/letsencrypt.conf;
   include snippets/ssl.conf;

# log files
   access_log /var/log/nginx/git.example.com.access.log;
   error_log /var/log/nginx/git.example.com.error.log;

# Handle / requests
   location / {
   proxy_redirect off;
   proxy_pass http://127.0.0.1:3000;
  }
 }

Hvernig á að uppfæra Gitea

Til að uppfæra Gitea uppsetninguna þína, allt sem þarf að gera er að hlaða niður nýjustu tvöfalda skránni af Gitea aftur, endurtaka fyrstu skrefin í upphafi handbókarinnar. Dæmi um samantektina eins og hér að neðan:

Stöðvaðu Gitea þjónustuna:

sudo systemctl stop gitea

Sæktu nýjustu Gitea útgáfuna og færðu hana í „/ usr / local / bin" Skrá:

VERSION=
 wget -O /tmp/gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64
 sudo mv /tmp/gitea /usr/local/bin

Gerðu Gitea tvöfalda skrá keyranlega samkvæmt upphafi leiðbeininganna í þessari handbók.

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

Endurræstu Gitea þjónustuna:

sudo systemctl restart gitea

Fáðu


Athugasemdir og niðurstaða

Handbókin hefur sýnt þér hvernig á að setja upp Gitea á Ubuntu 20.04 LTS og grunnkröfur við uppsetningu. Á heildina litið er Gitea traustur hugbúnaður sem er virkur þróaður með mjög virku samfélagi. Sumir af aukaeiginleikum eru:

  • Auðvelt að stjórna geymslum.
  • Notar HTTP / HTTPS, Git og SSH samskiptareglur.
  • Uppfært reglulega.
  • Málefnastjórnun.
  • Tímaskrá fyrir kóða.
  • Sjónræn, einfalt í notkun.
  • Hvetur til samvinnu með því að samþætta dráttarbeiðnir og útibú.

Ef þú hefur spurningar skaltu ekki hika við að skilja eftir athugasemd hér að neðan.

Leyfi a Athugasemd