Πώς να εγκαταστήσετε και να διαμορφώσετε gogs στο ubuntu 18.04

Gogs είναι ένας αυτο-φιλοξενείται ανοιχτού κώδικα git server γραμμένο σε Go. Περιλαμβάνει έναν επεξεργαστή αρχείου αποθετηρίου, εντοπισμό ζητήματος έργου και ενσωματωμένο wiki.

Το Gogs είναι μια ελαφριά εφαρμογή και μπορεί να εγκατασταθεί σε συστήματα χαμηλής ισχύος. Αν ψάχνετε για μια εναλλακτική λύση στο Gitlab με πολύ μικρότερο αποτύπωμα μνήμης και δεν χρειάζεστε όλα τα κουδούνια και τις σφυρίχτρες που προσφέρει η Gitlab τότε σίγουρα θα πρέπει να δοκιμάσετε τους Gogs.

Αυτό το σεμινάριο καλύπτει τα βήματα για την εγκατάσταση και τη διαμόρφωση του Gogs στο Ubuntu 18.04. Οι ίδιες οδηγίες ισχύουν για το Ubuntu 16.04 και για οποιαδήποτε άλλη διανομή που βασίζεται στο Ubuntu.

Πριν ξεκινήσεις

Οι Gogs μπορούν να χρησιμοποιήσουν τη βάση δεδομένων SQLite, PostgreSQL ή MySQL / MariaDB για να αποθηκεύσουν όλα τα δεδομένα τους.

Σε αυτό το σεμινάριο, θα χρησιμοποιήσουμε το SQLite ως βάση δεδομένων επιλογής. Εάν το SQLite δεν είναι εγκατεστημένο στο σύστημά σας, μπορείτε να το εγκαταστήσετε πληκτρολογώντας:

sudo apt install sqlite3

Για πρόσθετο επίπεδο ασφάλειας, συνιστάται η δημιουργία ενός βασικού τείχους προστασίας. Μπορείτε να ακολουθήσετε τα βήματα που περιγράφει ο τρόπος ρύθμισης ενός τείχους προστασίας με το UFW στον οδηγό Ubuntu 18.04.

Εγκατάσταση Gogs

Θα εγκαταστήσουμε το Gog από δυαδικό. Η εγκατάσταση είναι μια αρκετά απλή διαδικασία.

Εγκαταστήστε το Git

Το πρώτο βήμα είναι να εγκαταστήσετε το Git στο διακομιστή σας. Για να γίνει αυτό, ανανεώστε το τοπικό ευρετήριο πακέτων και εγκαταστήστε το πακέτο git εκτελώντας τις ακόλουθες εντολές ως χρήστη sudo:

sudo apt update sudo apt install git

Επαληθεύστε την εγκατάσταση προβάλλοντας την έκδοση Git:

git --version

git version 2.17.1

Δημιουργήστε έναν χρήστη Git

Δημιουργήστε ένα νέο χρήστη του συστήματος για να εκτελέσετε την υπηρεσία Gogs πληκτρολογώντας:

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

Η εντολή θα δημιουργήσει τον χρήστη και θα ορίσει τον αρχικό κατάλογο στο /home/git . Η έξοδος θα φαίνεται κάπως παρακάτω:

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

Κατεβάστε το Gogs δυαδικό

Επισκεφθείτε τη σελίδα "Λήψη Gogs" και κάντε λήψη του τελευταίου δυαδικού αρχείου για την αρχιτεκτονική σας. Κατά τη στιγμή της σύνταξης, η τελευταία έκδοση είναι 0.11.86, αν υπάρχει διαθέσιμη νέα έκδοση, αλλάξτε τη μεταβλητή VERSION στην παρακάτω εντολή.

Κάντε λήψη του αρχείου Gogs στον κατάλογο /tmp χρησιμοποιώντας την ακόλουθη εντολή wget:

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

Μόλις ολοκληρωθεί η λήψη, εξαγάγετε το αρχείο ggg tar.gz και μετακινήστε τον στον κατάλογο /home/git :

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

Εκτελέστε την ακόλουθη εντολή για να αλλάξετε την ιδιοκτησία του καταλόγου εγκατάστασης του Gogs στον χρήστη και την ομάδα git:

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

Δημιουργήστε ένα συστημένο αρχείο μονάδας

Οι Gogs έρχονται με ένα αρχείο Systemd μονάδας που έχει ήδη ρυθμιστεί ώστε να ταιριάζει με τη ρύθμισή μας.

Αντιγράψτε το αρχείο στον /etc/systemd/system/ κατάλογο πληκτρολογώντας:

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

Αφού γίνει, ξεκινήστε και ενεργοποιήστε την υπηρεσία Gogs:

sudo systemctl start gogs sudo systemctl enable gogs

Βεβαιωθείτε ότι η υπηρεσία ξεκίνησε με επιτυχία:

* 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

Εγκαταστήστε το Gogs χρησιμοποιώντας το πρόγραμμα εγκατάστασης ιστού

Τώρα που το Gogs κατεβάζεται και λειτουργεί, είναι καιρός να ολοκληρώσετε την εγκατάσταση μέσω της διασύνδεσης web.

Ανοίξτε το πρόγραμμα περιήγησής σας, πληκτρολογήστε http://YOUR_DOMAIN_IR_IP:3000 και θα εμφανιστεί μια οθόνη παρόμοια με την παρακάτω:

Ο πρώτος εγγεγραμμένος χρήστης προστίθεται αυτόματα στην ομάδα διαχειριστή.

Αυτό είναι. Τα Gogs έχουν εγκατασταθεί στο μηχάνημά σας στο Ubuntu.

Διαμόρφωση του Nginx ως διακομιστή μεσολάβησης SSL τερματισμού

Αυτό το βήμα είναι προαιρετικό αλλά συνιστάται ιδιαίτερα. Για να χρησιμοποιήσετε το Nginx ως αντίστροφη διακομιστή μεσολάβησης, πρέπει να έχετε έναν τομέα ή έναν υποτομέα που να δείχνει στο διακομιστή σας δημόσια IP. Σε αυτό το σεμινάριο, θα χρησιμοποιήσουμε το gogs.example.com .

Κατ 'αρχάς, εγκαταστήστε το Nginx και δημιουργήστε ένα δωρεάν Let's Encrypt SSL certificate ακολουθώντας τους παρακάτω οδηγούς:

Μόλις ολοκληρωθεί, ανοίξτε τον επεξεργαστή κειμένου και επεξεργαστείτε το αρχείο μπλοκ διακομιστή τομέα:

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; } }

Μην ξεχάσετε να αντικαταστήσετε το gogs.example.com με τον τομέα σας Gogs και να ορίσετε τη σωστή διαδρομή στα αρχεία πιστοποιητικών SSL. Όλες οι αιτήσεις HTTP θα ανακατευθυνθούν στο Κάντε επανεκκίνηση της υπηρεσίας Nginx για να εφαρμοστούν οι αλλαγές:

sudo systemctl restart nginx

Στη συνέχεια, πρέπει να αλλάξουμε τον τομέα Gogs και τη διεύθυνση URL root. Για να το κάνετε αυτό, ανοίξτε το αρχείο ρυθμίσεων και επεξεργαστείτε τις ακόλουθες γραμμές:

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

DOMAIN = gogs.example.com ROOT_URL =

Επανεκκινήστε την υπηρεσία Gogs πληκτρολογώντας:

sudo systemctl restart gogs

Σε αυτό το σημείο, το Gogs έχει ρυθμιστεί και μπορείτε να το έχετε πρόσβαση στη https://gogs.example.com : https://gogs.example.com

Ρύθμιση ειδοποιήσεων ηλεκτρονικού ταχυδρομείου

Για να μπορούν οι Gogs να στέλνουν μηνύματα ηλεκτρονικού ταχυδρομείου ειδοποιήσεων, μπορείτε είτε να εγκαταστήσετε το Postfix είτε να χρησιμοποιήσετε κάποια υπηρεσία αλληλογραφίας συναλλαγών όπως SendGrid, MailChimp, MailGun ή SES.

Για να ενεργοποιήσετε ειδοποιήσεις μέσω ηλεκτρονικού ταχυδρομείου, ανοίξτε το αρχείο ρυθμίσεων και επεξεργαστείτε τις ακόλουθες γραμμές:

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

Βεβαιωθείτε ότι έχετε τοποθετήσει τις σωστές πληροφορίες διακομιστή SMTP.

Επανεκκινήστε την υπηρεσία Gogs για να εφαρμοστούν οι αλλαγές:

sudo systemctl restart gogs

Το Gog σας επιτρέπει επίσης να συνδεθείτε στο Slack δημιουργώντας webhook web και να στείλετε ειδοποιήσεις στα κανάλια Slack.

Αναβάθμιση του Gogs

Για να αναβαθμίσετε το Gogs, απαιτούνται πολλά χειροκίνητα βήματα.

1. Πρώτα σταματήστε την υπηρεσία Gogs:

   sudo systemctl stop gogs

   Μετονομάστε τον κατάλογο εγκατάστασης του Gogs.

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

   Κάντε λήψη της τελευταίας έκδοσης Gogs και μετακινήστε την στον κατάλογο /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

   Βεβαιωθείτε ότι αλλάξατε την VERSION με την VERSION του πραγματικού Gogs.

   Αντιγράψτε custom , data , καταλόγους καταλόγων στον κατάλογο που εξάγεται χρησιμοποιώντας την ακόλουθη εντολή rsync:

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

   Τέλος, ξεκινήστε την υπηρεσία Gogs:

   sudo systemctl restart gogs

Αυτό είναι.

συμπέρασμα

Αυτό το σεμινάριο σας οδήγησε στην εγκατάσταση και διαμόρφωση των Gogs στο Ubuntu 18.04. Τώρα μπορείτε να δημιουργήσετε το πρώτο σας έργο και να αρχίσετε να χρησιμοποιείτε το νέο σας διακομιστή Gogs.

ubuntu gogs