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

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

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

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

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

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

Ενεργοποιήστε ένα τερματικό SSH και συνδεθείτε στην παρουσία του διακομιστή CentOS 7 ως χρήστης 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
cat <<EOF | sudo tee /etc/hosts
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
203.0.113.1 gitlab.example.com gitlab
EOF

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

hostname
hostname -f

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

Να επιτρέπεται η εισερχόμενη κυκλοφορία HTTP και HTTPS:

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld.service

Εγκαταστήστε το αποθετήριο EPEL YUM και στη συνέχεια ενημερώστε το σύστημα

sudo yum install -y epel-release
sudo yum -y update && sudo shutdown -r now

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

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

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

sudo yum install -y curl policycoreutils-python openssh-server openssh-clients

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

sudo yum install -y postfix
sudo systemctl enable postfix.service
sudo systemctl start postfix.service
sudo firewall-cmd --permanent --add-service=smtp
sudo firewall-cmd --permanent --add-service=pop3
sudo firewall-cmd --permanent --add-service=imap
sudo firewall-cmd --permanent --add-service=smtps
sudo firewall-cmd --permanent --add-service=pop3s
sudo firewall-cmd --permanent --add-service=imaps
sudo firewall-cmd --reload

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

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

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

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

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

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

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

sudo EXTERNAL_URL="http://gitlab.example.com" yum 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'] = ['admin@example.com']

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

:wq!

Εκτελέστε την ακόλουθη εντολή για να ρυθμίσετε εκ νέου το GitLab CE χρησιμοποιώντας τις ενημερωμένες ρυθμίσεις:

sudo gitlab-ctl reconfigure

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

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

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