Πώς να εγκαταστήσετε το GitLab Community Edition (CE) 11.x στο Ubuntu 18.04 LTS

Από τη στιγμή που το GitHub εξαγοράστηκε από τη Microsoft, αρκετοί προγραμματιστές έχουν προγραμματίσει να μεταφέρουν τα δικά τους αποθετήρια κώδικα από το github.com σε μια εναλλακτική λύση που φιλοξενείται από τον ίδιο τον εαυτό. Το GitLab Community Edition (CE) είναι η πιο κοινή επιλογή.

Ως εξελιγμένη και ευέλικτη λύση, το GitLab CE μπορεί να αναπτυχθεί χρησιμοποιώντας διάφορες μεθόδους, αλλά μόνο η επίσημα προτεινόμενη μέθοδος, η εγκατάσταση του πακέτου Omnibus, θα καλυφθεί εδώ.

Προαπαιτούμενα

• Ένα νέο παράδειγμα διακομιστή Vultr Ubuntu 18.04 LTS x64 με τουλάχιστον 4 GB μνήμης. 8 GB ή περισσότερα προτείνονται για εξυπηρέτηση έως και 100 χρηστών. Ας πούμε ότι η διεύθυνση IPv4 του είναι 203.0.113.1.
• Ένας χρήστης sudo .
• Ένας τομέας gitlab.example.comπου δείχνει προς την περίπτωση που αναφέρεται παραπάνω.

Σημείωση: Κατά την ανάπτυξη στο παράδειγμα του διακομιστή σας, φροντίστε να αντικαταστήσετε όλες τις παραδειγματικές τιμές με πραγματικές.

Βήμα 1: Εκτελέστε βασικές εργασίες για τη φιλοξενία του GitLab CE

Ενεργοποιήστε ένα τερματικό SSH και συνδεθείτε στην παρουσία του διακομιστή Ubuntu 18.04 LTS x64 ως χρήστης sudo.

Προσθέστε ένα διαμέρισμα swap και τροποποιήστε τη ρύθμιση swappiness

Κατά την ανάπτυξη του GitLab CE 11.x σε ένα μηχάνημα με μνήμη 4 GB, απαιτείται να ρυθμίσετε ένα διαμέρισμα swap 4 GB για ομαλή λειτουργία:

sudo dd if=/dev/zero of=/swapfile count=4096 bs=1M
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile   none    swap    sw    0   0' | sudo tee -a /etc/fstab
free -m

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

Για λόγους απόδοσης συστήματος, συνιστάται να διαμορφώσετε τη ρύθμιση swappiness του πυρήνα σε χαμηλή τιμή όπως 10:

echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
cat /proc/sys/vm/swappiness

Η έξοδος της catεντολής θα είναι 10.

Ρυθμίστε το όνομα κεντρικού υπολογιστή του μηχανήματος και το πλήρως πιστοποιημένο όνομα τομέα (FQDN)

Χρησιμοποιήστε τις ακόλουθες εντολές για να ρυθμίσετε ένα όνομα κεντρικού υπολογιστή gitlab, και ένα FQDN, gitlab.example.com, για το μηχάνημα:

sudo hostnamectl set-hostname gitlab
sudo sed -i "1 i\203.0.113.1 gitlab.example.com gitlab" /etc/hosts

Μπορείτε να επιβεβαιώσετε τα αποτελέσματα:

hostname
hostname -f

Τροποποιήστε τους κανόνες του τείχους προστασίας

Να επιτρέπεται η εισερχόμενη κίνηση SSH, HTTP και HTTPS

sudo ufw allow OpenSSH
sudo ufw allow http
sudo ufw allow https
sudo ufw enable

Ενημερώστε το σύστημα

sudo apt update
sudo apt upgrade -y && sudo shutdown -r now

Κατά τη διάρκεια της αναβάθμισης, ενδέχεται να ενημερωθείτε ότι η τρέχουσα εγκατεστημένη έκδοση του αρχείου διαμόρφωσης grub έχει τροποποιηθεί τοπικά. Επειδή στην πραγματικότητα δεν είμαστε υπεύθυνοι για την τροποποίηση, χρησιμοποιήστε το UPβέλος για να επισημάνετε την install the package maintainer's versionεπιλογή και, στη συνέχεια, πατήστε ENTER.

Όταν το σύστημα είναι σε λειτουργία και λειτουργεί ξανά, συνδεθείτε ξανά ως ο ίδιος χρήστης sudo για να προχωρήσετε.

Βήμα 2: Εγκαταστήστε τις απαιτούμενες εξαρτήσεις

Πριν εγκαταστήσετε το GitLab CE, πρέπει να εγκαταστήσετε τις απαιτούμενες εξαρτήσεις:

sudo apt install -y curl openssh-server ca-certificates

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

sudo apt install -y postfix

Κατά την εγκατάσταση, ενδέχεται να εμφανιστεί μια οθόνη διαμόρφωσης:

1. Πατήστε TABγια να επισημάνετε το <OK>κουμπί στην πρώτη οθόνη και, στη συνέχεια, πατήστε ENTER.
2. Επιλέξτε Internet Siteκαι πατήστε ENTER.
3. Για το mail nameπεδίο, εισαγάγετε το FQDN του διακομιστή σας gitlab.example.comκαι πατήστε ENTER.
4. Εάν εμφανιστούν άλλες οθόνες, πατήστε ENTERγια να αποδεχτείτε τις προεπιλεγμένες ρυθμίσεις.

Εκκινήστε και ενεργοποιήστε την υπηρεσία Postfix:

sudo systemctl enable postfix.service
sudo systemctl start postfix.service

Τροποποίηση κανόνων τείχους προστασίας για το Postfix:

sudo ufw allow Postfix
sudo ufw allow 'Postfix SMTPS'
sudo ufw allow 'Postfix Submission'

Έχοντας εγκαταστήσει το Postfix, πρέπει να ρυθμίσετε τις παραμέτρους του Postfix επεξεργάζοντας το κύριο αρχείο διαμόρφωσης /etc/postfix/main.cfσύμφωνα με τις πραγματικές ρυθμίσεις διακομιστή σας.

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

Εναλλακτικά, εάν θέλετε να χρησιμοποιήσετε άλλη λύση ανταλλαγής μηνυμάτων, απλώς παραλείψτε την εγκατάσταση του Postfix και επιλέξτε να χρησιμοποιήσετε έναν εξωτερικό διακομιστή SMTP μετά την εγκατάσταση του GitLab CE.

Βήμα 3: Ρυθμίστε το αποθετήριο GitLab APT και, στη συνέχεια, εγκαταστήστε το GitLab CE

Ρυθμίστε το αποθετήριο GitLab CE APT στο σύστημά σας:

cd
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

Στη συνέχεια, εγκαταστήστε το GitLab CE 11.x:

sudo EXTERNAL_URL="http://gitlab.example.com" apt install -y gitlab-ce

Η εγκατάσταση μπορεί να διαρκέσει λίγο.

Τέλος, τοποθετήστε το αγαπημένο σας πρόγραμμα περιήγησης στο web http://gitlab.example.comκαι, στη συνέχεια, υποβάλετε έναν νέο κωδικό πρόσβασης όπως σας ζητηθεί για να ολοκληρώσετε την εγκατάσταση.

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

• Όνομα χρήστη: root
• Κωδικός πρόσβασης: <your-new-password>

Βήμα 4: Ενεργοποιήστε την πρόσβαση HTTPS ενσωματώνοντας ένα πιστοποιητικό Let's Encrypt SSL

Προς το παρόν, έχετε εγκαταστήσει με επιτυχία το GitLab CE 11.x στην παρουσία του διακομιστή σας και οι χρήστες μπορούν ήδη να επισκεφτούν τον ιστότοπο χρησιμοποιώντας το πρωτόκολλο HTTP. Για λόγους ασφαλείας, συνιστάται να ενεργοποιήσετε την πρόσβαση HTTPS στον διακομιστή GitLab ενσωματώνοντας ένα πιστοποιητικό Let's Encrypt SSL.

Χρησιμοποιήστε το viπρόγραμμα επεξεργασίας για να ανοίξετε το αρχείο διαμόρφωσης GitLab CE:

sudo vi /etc/gitlab/gitlab.rb

Βρείτε τις ακόλουθες δύο γραμμές:

external_url 'http://gitlab.example.com'
# letsencrypt['contact_emails'] = [] # This should be an array of email addresses to add as contacts

Αντικαταστήστε τα ανάλογα:

external_url 'https://gitlab.example.com'
letsencrypt['contact_emails'] = ['[email protected]']

Αποθήκευση και έξοδος:

:wq!

Ρυθμίστε ξανά το GitLab CE χρησιμοποιώντας ενημερωμένες ρυθμίσεις:

sudo gitlab-ctl reconfigure

Η επαναδιαμόρφωση μπορεί να διαρκέσει λίγο.

Αφού ολοκληρωθεί η επαναδιαμόρφωση, όλοι οι χρήστες θα αναγκαστούν να χρησιμοποιήσουν το πρωτόκολλο HTTPS κατά την πρόσβαση στον ιστότοπο του GitLab.

Σημείωση: Μετά την εναλλαγή από HTTP σε HTTPS, τα cookie παλαιού τύπου ενδέχεται να προκαλέσουν σφάλμα GitLab 422. Η εκκαθάριση των cookies διορθώνει αυτό το πρόβλημα.