A gogok telepítése és konfigurálása az ubuntu 18.04-en

A Gogs egy saját üzemeltetésű, nyílt forrású git szerver, Go nyelven írva. Ez magában foglalja a repository fájlszerkesztőt, a projekt kiadásának nyomon követését és a beépített wikit.

A Gogs egy könnyű alkalmazás, amely alacsony fogyasztású rendszerekre telepíthető. Ha sokkal kisebb memóriaterületű Gitlab alternatívát keres, és nincs szüksége a Gitlab által kínált összes csengőre és sípre, akkor feltétlenül próbálja ki a Gogot.

Ez az oktatóanyag a Gogs telepítésének és konfigurálásának lépéseit tartalmazza az Ubuntu 18.04-en. Ugyanezek az utasítások vonatkoznak az Ubuntu 16.04-re és minden más Ubuntu-alapú disztribúcióra.

Mielőtt elkezded

A Gogs az SQLite, PostgreSQL vagy MySQL / MariaDB adatbázis segítségével felhasználhatja az összes adat tárolását.

Ebben az oktatóanyagban az SQLite-t fogjuk használni a választott adatbázisként. Ha az SQLite nincs telepítve a rendszerére, telepítheti a következő gépeléssel:

sudo apt install sqlite3

További biztonsági szint érdekében javasolt egy alap tűzfal beállítása. Az Ubuntu 18.04 útmutatóban a Tűzfal beállítása az UFW-vel című szakaszban leírt lépéseket követheti.

A Gogs telepítése

Telepítjük a Gogs-t a binárisból. A telepítés nagyon egyszerű folyamat.

Telepítse a Git szoftvert

Az első lépés a Git telepítése a szerverre. Ehhez frissítse a helyi csomag indexét, és telepítse a git csomagot a következő parancsok futtatásával sudo felhasználóként:

sudo apt update sudo apt install git

Ellenőrizze a telepítést a Git verzió megjelenítésével:

git --version

git version 2.17.1

Hozzon létre egy Git felhasználót

Hozzon létre egy új rendszerfelhasználót a Gogs szolgáltatás futtatásához:

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

A parancs létrehozza a felhasználót, és a home könyvtárat /home/git állítja. A kimenet az alábbiak szerint néz ki:

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'…

Töltse le a Gogs bináris fájlt

Látogasson el a Gogs letöltése oldalra, és töltse le az építészet legújabb bináris fájljait. Az írás idején a legújabb verzió 0.11.86, ha van új verzió, akkor változtassa meg a VERSION változót az alábbi parancsban.

Töltse le a Gogs archívumot a /tmp könyvtárból a következő wget paranccsal:

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

A letöltés befejezése után bontsa ki a Gogs tar.gz fájlt, és helyezze át a /home/git könyvtárba:

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

Futtassa a következő parancsot a Gogs telepítési könyvtár tulajdonjogának megváltoztatásához a felhasználói és csoportos git:

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

Hozzon létre egy rendszerezett egységfájlt

A Gogs olyan Systemd egységfájlkal érkezik, amelyet már beállítottak, hogy megfeleljen a beállításoknak.

Másolja a fájlt az /etc/systemd/system/ könyvtárba a következő gépeléssel:

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

Ha kész, indítsa el és engedélyezze a Gogs szolgáltatást:

sudo systemctl start gogs sudo systemctl enable gogs

Ellenőrizze, hogy a szolgáltatás sikeresen elindult-e:

* 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

Telepítse a Gogs webes telepítőjét

Most, hogy a Gogs letöltött és fut, ideje befejezni a telepítést a webes felületen keresztül.

Nyissa meg a böngészőt, írja be a http://YOUR_DOMAIN_IR_IP:3000 és a következőhöz hasonló képernyő jelenik meg:

Az első regisztrált felhasználót automatikusan hozzáadjuk a Rendszergazda csoporthoz.

Ez az. A Gogs telepítve lett az Ubuntu gépen.

Az Nginx konfigurálása SSL terminációs proxyként

Ez a lépés nem kötelező, de erősen ajánlott. Az Nginx fordított proxyként való használatához rendelkeznie kell egy domain vagy aldomain, amely a szerver nyilvános IP-jére mutat. Ebben az oktatóanyagban a gogs.example.com fogjuk használni.

Először telepítse az Nginx-et, és az alábbi útmutatások követésével hozzon létre egy ingyenes Let's Encrypt SSL tanúsítványt:

Ha kész, nyissa meg a szövegszerkesztőt, és szerkessze a tartománykiszolgáló blokkfájlját:

sudo nano /etc/nginx/sites-enabled/gogs.example.com /etc/nginx/sites-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; } }

Ne felejtsd el cserélni a gogs.example.com webhelyet a Gogs domainre, és állítsd be a helyes utat az SSL tanúsítvány fájlokhoz. Minden HTTP kérést átirányítunk a Indítsa újra az Nginx szolgáltatást a változások hatályba lépése érdekében:

sudo systemctl restart nginx

Ezután meg kell változtatnunk a Gogs domain és a gyökér URL-t. Ehhez nyissa meg a konfigurációs fájlt, és szerkessze a következő sorokat:

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

DOMAIN = gogs.example.com ROOT_URL =

Indítsa újra a Gogs szolgáltatást a következő gépeléssel:

sudo systemctl restart gogs

Ezen a ponton a Gogs konfigurálva van, és elérheti a következő https://gogs.example.com : https://gogs.example.com

Az e-mail értesítések konfigurálása

Annak érdekében, hogy a Gogs értesítési e-maileket küldhessen, telepítheti a Postfix alkalmazást, vagy használhat tranzakciós e-mail szolgáltatást, például SendGrid, MailChimp, MailGun vagy SES.

Az e-mail értesítések engedélyezéséhez nyissa meg a konfigurációs fájlt, és szerkessze a következő sorokat:

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

Ügyeljen arra, hogy a helyes SMTP-kiszolgáló adatait megadja.

Indítsa újra a Gogs szolgáltatást a változások hatályba lépése érdekében:

sudo systemctl restart gogs

A Gogs lehetővé teszi a Slackhoz történő kapcsolódást web webhook létrehozásával és értesítések küldésével a Slack csatornáira.

A Gogok korszerűsítése

A Gogs frissítéséhez több kézi lépés szükséges.

1. Először állítsa le a Gogs szolgáltatást:

   sudo systemctl stop gogs

   Nevezze át a Gogs telepítési könyvtárát.

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

   Töltse le a legújabb Gogs verziót, és helyezze át a /home/git könyvtárba:

   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

   Ügyeljen arra, hogy a VERSION t megváltoztassa a tényleges Gogs kiadási verzióval.

   Másolja az custom , data és log a kibontott könyvtárba a következő rsync paranccsal:

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

   Végül indítsa el a Gogs szolgáltatást:

   sudo systemctl restart gogs

Ez az.

Következtetés

Ez az oktatóprogram végigvezette a Gogs telepítését és konfigurálását az Ubuntu 18.04-en. Most elkészítheti első projektjét, és elkezdheti az új Gogs szerver használatát.

ubuntu gogs