Paano i-install at i-configure ang mga gog sa ubuntu 18.04

Ang Gog ay isang naka-host na bukas na mapagkukunan ng git server na nakasulat sa Go. May kasamang isang reporter file editor, pagsubaybay sa isyu ng proyekto, at isang built-in na wiki.

Ang Gog ay isang magaan na aplikasyon at maaaring mai-install sa mga mababang-pinapatakbo na system. Kung naghahanap ka ng isang kahalili sa Gitlab na may mas maliit na yapak ng memorya at hindi mo na kailangan ang lahat ng mga kampanilya at mga whistles na inaalok ng Gitlab pagkatapos ay dapat mo talagang subukan ang Gogs.

Sakop ng tutorial na ito ang mga hakbang upang mai-install at i-configure ang Gogs sa Ubuntu 18.04. Ang parehong mga tagubilin ay nalalapat para sa Ubuntu 16.04 at anumang iba pang pamamahagi batay sa Ubuntu.

Bago ka magsimula

Maaaring gamitin ng Gog ang SQLite, PostgreSQL, o database ng MySQL / MariaDB upang maiimbak ang lahat ng data nito.

Sa tutorial na ito, gagamitin namin ang SQLite bilang database na pinili. Kung ang SQLite ay hindi naka-install sa iyong system maaari mo itong mai-install sa pamamagitan ng pag-type:

sudo apt install sqlite3

Para sa isang karagdagang layer ng seguridad, inirerekomenda na mag-set up ng isang pangunahing firewall. Maaari mong sundin ang mga hakbang sa aming Paano Mag-set up ng isang Firewall na may UFW sa Ubuntu 18.04 gabay.

Pag-install ng Gogs

I-install namin ang Gogs mula sa binary. Ang pag-install ay isang medyo tuwid na proseso ng pasulong.

I-install ang Git

Ang unang hakbang ay ang pag-install ng Git sa iyong server. Upang gawin ito, i-refresh ang lokal na index ng package at i-install ang git package sa pamamagitan ng pagpapatakbo ng mga sumusunod na utos bilang gumagamit ng sudo:

sudo apt update sudo apt install git

Patunayan ang pag-install sa pamamagitan ng pagpapakita ng bersyon ng Git:

git --version

git version 2.17.1

Lumikha ng isang gumagamit ng Git

Lumikha ng isang bagong gumagamit ng system upang patakbuhin ang serbisyo ng Gogs sa pamamagitan ng pag-type:

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

Ang utos ay lilikha ng gumagamit at itakda ang direktoryo ng bahay sa /home/git . Ang output ay magmukhang isang bagay sa ibaba:

Adding system user `git' (UID 111)… Adding new group `git' (GID 116)… Adding new user `git' (UID 111) with group `git'… Creating home directory `/home/git'…

I-download ang binary Gogs

Bisitahin ang pahina ng Pag-download ng Gogs at i-download ang pinakabagong binary para sa iyong arkitektura. Sa panahon ng pagsulat, ang pinakabagong bersyon ay 0.11.86, kung mayroong isang bagong bersyon na magagamit baguhin ang VERSION variable sa utos sa ibaba.

I-download ang arch ng Gogs sa direktoryo ng /tmp gamit ang sumusunod na utos ng wget:

VERSION=0.11.86 wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp

Kapag nakumpleto na ang pag-download, kunin ang file ng Gogs tar.gz at ilipat ito sa direktoryo /home/git :

sudo tar xf /tmp/gogs_*_linux_amd64.tar.gz -C /home/git

Patakbuhin ang sumusunod na utos upang mabago ang pagmamay-ari ng direktoryo ng pag-install ng Gogs sa gumagamit at pangkat git:

sudo chown -R git: /home/git/gogs

Lumikha ng isang systemd Unit File

Ang Gog ay may isang file na yunit ng Systemd na na-configure upang tumugma sa aming pag-setup.

Kopyahin ang file sa /etc/systemd/system/ direktoryo sa pamamagitan ng pag-type:

sudo cp /home/git/gogs/scripts/systemd/gogs.service /etc/systemd/system/

Kapag tapos na, simulan at paganahin ang serbisyo ng Gogs:

sudo systemctl start gogs sudo systemctl enable gogs

Patunayan na ang serbisyo ay matagumpay na sinimulan:

* gogs.service - Gogs Loaded: loaded (/etc/systemd/system/gogs.service; enabled; vendor preset: enabled) Active: active (running) since Thu 2019-04-25 04:13:44 PDT; 9s ago Main PID: 14376 (gogs) Tasks: 8 (limit: 2319) CGroup: /system.slice/gogs.service `-14376 /home/git/gogs/gogs web

I-install ang Gog gamit ang web installer

Ngayon na ang Gog ay nai-download at tumatakbo, oras na upang wakasan ang pag-install sa pamamagitan ng web interface.

Buksan ang iyong browser, i-type ang http://YOUR_DOMAIN_IR_IP:3000 at lilitaw ang isang screen na katulad ng sumusunod:

Ang unang rehistradong gumagamit ay awtomatikong idinagdag sa pangkat ng Admin.

Ayan yun. Ang mga Gog ay na-install sa iyong makina ng Ubuntu.

Pag-configure ng Nginx bilang SSL Pagwawakas ng Proxy

Ang hakbang na ito ay opsyonal ngunit ito ay lubos na inirerekomenda. Upang magamit ang Nginx bilang isang reverse proxy kailangan mong magkaroon ng isang domain o subdomain na tumuturo sa iyong pampublikong IP ng server. Sa tutorial na ito, gagamitin namin ang gogs.example.com .

Una, i-install ang Nginx at makabuo ng isang libreng Let’s Encrypt SSL certificate sa pamamagitan ng pagsunod sa mga gabay sa ibaba:

Kapag tapos na, buksan ang iyong text editor at i-edit ang file ng block ng domain server:

sudo nano /etc/nginx/sites-enabled/gogs.example.com /etc/nginx/site-enabled/gogs.example.com

server { listen 80; server_name gogs.example.com; include snippets/letsencrypt.conf; return 301 https://gogs.example.com$request_uri; } server { listen 443 ssl http2; server_name gogs.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/gogs.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/gogs.example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/gogs.example.com/chain.pem; include snippets/letsencrypt.conf; include snippets/ssl.conf; # log files access_log /var/log/nginx/gogs.example.com.access.log; error_log /var/log/nginx/gogs.example.com.error.log; # Handle / requests location / { proxy_redirect off; proxy_pass http://127.0.0.1:3000; } }

Huwag kalimutan na palitan ang gogs.example.com sa iyong domain ng Gogs at itakda ang tamang landas sa mga file ng sertipiko ng SSL. Ang lahat ng mga kahilingan sa HTTP ay mai-redirect sa I-restart ang serbisyo ng Nginx para sa mga pagbabago na magkakabisa:

sudo systemctl restart nginx

Susunod, kailangan nating baguhin ang domain ng Gogs at url ng ugat. Upang gawin ito, buksan ang file ng pagsasaayos at i-edit ang mga sumusunod na linya:

sudo nano /home/git/gogs/custom/conf/app.ini /home/git/gogs/custom/conf/app.ini

DOMAIN = gogs.example.com ROOT_URL =

I-restart ang serbisyo ng Gogs sa pamamagitan ng pag-type:

sudo systemctl restart gogs

Sa puntong ito, ang Gogs ay na-configure at maaari mong ma-access ito sa: https://gogs.example.com

Pag-configure ng Mga Abiso sa Email

Upang maipadala ni Gog ang mga email sa notification, maaari mong mai-install ang Postfix o gumamit ng ilang mga serbisyo sa mail na transactional tulad ng SendGrid, MailChimp, MailGun o SES.

Upang paganahin ang mga abiso sa email, buksan ang file ng pagsasaayos at i-edit ang mga sumusunod na linya:

sudo nano /home/git/gogs/custom/conf/app.ini /home/git/gogs/custom/conf/app.ini

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

Tiyaking inilagay mo ang tamang impormasyon ng server ng SMTP.

I-restart ang serbisyo ng Gogs para sa mga pagbabago na magkakabisa:

sudo systemctl restart gogs

Pinapayagan ka ng Gog na kumonekta sa Slack sa pamamagitan ng paglikha ng web webhook at magpadala ng mga abiso sa iyong mga Slack channel.

Pag-upgrade ng Gog

Upang i-upgrade ang Gogs, kinakailangan ang maraming mga manu-manong hakbang.

1. Una ihinto ang serbisyo ng Gogs:

   sudo systemctl stop gogs

   Palitan ang pangalan ng direktoryo ng pag-install ng Gogs.

   sudo mv /home/git/gogs{, _old}

   I-download ang pinakabagong bersyon ng Gogs at ilipat ito sa direktoryo /home/git :

   VERSION= wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp sudo tar xf /tmp/gogs_*_linux_amd64.tar.gz -C /home/git

   Tiyaking binago mo ang VERSION sa aktwal na bersyon ng paglabas ng Gogs.

   Kopyahin ang custom , data , mga direktoryo ng log sa nakuha na direktoryo gamit ang sumusunod na utos ng rsync:

   sudo rsync -a /home/git/gogs_old/{custom, data, log} /home/git/gogs/

   Sa wakas, simulan ang serbisyo ng Gogs:

   sudo systemctl restart gogs

Ayan yun.

Konklusyon

Naglakad ka ng tutorial na ito sa pag-install at pagsasaayos ng Gogs sa Ubuntu 18.04. Maaari mo na ngayong lumikha ng iyong unang proyekto at simulan ang paggamit ng iyong bagong Gogs server.

ubuntu gog