كيفية تثبيت Gogs 0.11.53 على CentOS 7

• المتطلبات الأساسية
• الخطوة 1: تنفيذ مهام إعداد النظام الأساسية
• الخطوة 2: تثبيت سلسلة MariaDB 10.3
• الخطوة 3: تثبيت Gogs
• الخطوة 4 (اختياري): الحصول على شهادة Let's Encrypt SSL
• الخطوة 5 (اختياري): قم بتثبيت Nginx كخادم وكيل عكسي

Gogs ، أو خدمة Go Git ، هي حل خادم Git خفيف الوزن يعمل بكامل طاقته.

في هذا البرنامج التعليمي ، سأوضح لك كيفية تثبيت أحدث إصدار ثابت من Gogs ، على مثيل خادم CentOS 7. في وقت كتابة هذا التقرير ، كان أحدث إصدار من Gogs 0.11.53.

المتطلبات الأساسية

• نسخة خادم Vultr CentOS 7 تم إنشاؤها حديثًا بعنوان IPv4 203.0.113.1.
• A المستخدم سودو .
• المجال gogs.example.comالذي يتم الإشارة إليه إلى مثيل الخادم المذكور أعلاه.

الخطوة 1: تنفيذ مهام إعداد النظام الأساسية

افتح محطة SSH وقم بتسجيل الدخول إلى مثيل خادم CentOS 7 كمستخدم sudo.

قم بإنشاء ملف مبادلة

في بيئة الإنتاج ، مطلوب ملف مبادلة لعمليات النظام على نحو سلس. على سبيل المثال ، عند نشر Gogs على جهاز به ذاكرة 2 جيجا بايت ، يوصى بإنشاء ملف مبادلة 2 جيجا بايت (2048 ميجا بايت) كما يلي:

sudo dd if=/dev/zero of=/swapfile count=2048 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

ملاحظة: إذا كنت تستخدم حجم خادم مختلفًا ، فقد يختلف الحجم المناسب لملف المبادلة.

اسم مضيف الإعداد واسم المجال المؤهل بالكامل (FQDN)

لتمكين أمان HTTPS ، تحتاج إلى إعداد اسم مضيف (مثل gogs) و FQDN (مثل gogs.example.com) على جهاز CentOS 7:

sudo hostnamectl set-hostname gogs
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 gogs.example.com gogs
127.0.0.1 gogs
::1       gogs
EOF

يمكنك تأكيد النتائج:

hostname
hostname -f

تعديل قواعد جدار الحماية من أجل السماح الواردة HTTPو HTTPSحركة المرور

بشكل افتراضي ، يتم حظر المنافذ 80( HTTP) و 443( HTTPS) في CentOS 7. تحتاج إلى تعديل قواعد جدار الحماية على النحو التالي قبل أن يتمكن الزوار من الوصول إلى موقعك على الويب:

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

قم بتثبيت ال EPEL YUM الريبو ثم قم بتحديث النظام

لإصلاح الأخطاء وتحسين أداء النظام ، يوصى دائمًا بتحديث النظام إلى أحدث حالة مستقرة باستخدام YUM:

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

بعد إعادة تشغيل النظام ، قم بتسجيل الدخول كمستخدم sudo نفسه للمتابعة.

الخطوة 2: تثبيت سلسلة MariaDB 10.3

يحتاج Gogs إلى نظام إدارة قاعدة بيانات ، مثل MySQL / MariaDB أو PostgreSQL أو SQLite. في هذا البرنامج التعليمي ، سنقوم بتثبيت واستخدام الإصدار المستقر الحالي من MariaDB.

قم بتثبيت وبدء الإصدار المستقر الحالي لـ MariaDB:

curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
sudo yum install MariaDB-server MariaDB-devel -y
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

تأمين MariaDB:

sudo /usr/bin/mysql_secure_installation

عند مطالبتك بالرد على الأسئلة كما هو موضح أدناه:

• Enter current password for root (enter for none): ENTER
• Set root password? [Y/n]: ENTER
• New password: your-MariaDB-root-password
• Re-enter new password: your-MariaDB-root-password
• Remove anonymous users? [Y/n]: ENTER
• Disallow root login remotely? [Y/n]: ENTER
• Remove test database and access to it? [Y/n]: ENTER
• Reload privilege tables now? [Y/n]: ENTER

قم بتسجيل الدخول إلى هيكل MySQL كأصل:

mysql -u root -p

في shell MariaDB ، أنشئ قاعدة بيانات MariaDB مخصصة (يجب أن تستخدم utf8mb4مجموعة الأحرف) ومستخدم MariaDB مخصص لـ Gogs:

CREATE DATABASE gogs DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'gogsuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON gogs.* TO 'gogsuser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;

ملاحظة: لأغراض أمنية ، تأكد من استبدال gogsو gogsuser، yourpasswordبأغراضك الخاصة.

الخطوة 3: تثبيت Gogs

تثبيت Git:

sudo yum install -y git

قم بإنشاء مستخدم مخصص ومجموعة مخصصة ، كلاهما يسمى git:

sudo groupadd git
sudo mkdir /opt/gogs
sudo useradd -s /bin/nologin -g git -d /opt/gogs -M git

قم بتنزيل ملف ثنائي Gogs 0.11.53 وفك ضغطه:

cd
wget https://dl.gogs.io/0.11.53/gogs_0.11.53_linux_amd64.tar.gz
sudo tar -zxvf gogs_0.11.53_linux_amd64.tar.gz -C /opt
sudo chown -R git:git /opt/gogs

قم بإعداد ملف وحدة systemd لـ Gogs:

sudo cp /opt/gogs/scripts/systemd/gogs.service /lib/systemd/system/

استخدم viالمحرر لفتح gogs.serviceالملف الذي تم إنشاؤه حديثًا :

sudo vi /lib/systemd/system/gogs.service

ابحث عن الأسطر التالية:

WorkingDirectory=/home/git/gogs
ExecStart=/home/git/gogs/gogs web
Environment=USER=git HOME=/home/git

قم بتعديلها على التوالي:

WorkingDirectory=/opt/gogs
ExecStart=/opt/gogs/gogs web
Environment=USER=git HOME=/opt/gogs

احفظ واخرج:

:wq!

ابدأ وتمكين خدمة Gogs:

sudo systemctl daemon-reload
sudo systemctl start gogs.service
sudo systemctl enable gogs.service

سيتم تشغيل Gogs الآن على مثيل خادم CentOS 7 ، والاستماع على المنفذ 3000.

تعديل قواعد جدار الحماية للسماح للزوار بالوصول إلى المنفذ 3000:

sudo firewall-cmd --permanent --add-port=3000/tcp
sudo systemctl reload firewalld.service

بعد ذلك ، تحتاج إلى توجيه مستعرض الويب المفضل لديك http://203.0.113.1:3000لإنهاء التثبيت.

في Install Steps For First-time Runواجهة ويب Gogs ، املأ الحقول المطلوبة كما هو موضح أدناه.

ملاحظة: تأكد من عدم ترك جميع الحقول الأخرى على حالها.

في Database Settingsالقسم:

• المستعمل: gogsuser
• كلمه السر: yourpassword

في Application General Settingsالقسم:

• نطاق: gogs.example.com
• عنوان URL للتطبيق: http://gogs.example.com:3000/

في Admin Account Settingsالقسم:

• اسم المستخدم: <your-admin-username>
• كلمه السر: <your-admin-password>
• تأكيد كلمة المرور: <your-admin-password>
• البريد الإلكتروني للمشرف: <your-admin-email>

أخيرًا ، انقر فوق Intall Gogsالزر لإنهاء التثبيت. تذكر أنه سيتم تخزين إعداداتك المخصصة التي تم إجراؤها في واجهة تثبيت الويب Gogs في ملف التكوين المخصص لـ Gogs /opt/gogs/custom/conf/app.ini.

في الوقت الحالي ، يمكن للمستخدمين زيارة موقع Gogs على http://gogs.example.com:3000. من أجل تسهيل وصول الزوار ، بحيث لم يعودوا بحاجة إلى الإلحاق :3000، وتحسين أمن النظام ؛ يمكنك تثبيت Nginx كوكيل عكسي وتمكين HTTPS باستخدام شهادة Let's Encrypt SSL.

ملاحظة: على الرغم من أن الإرشادات في الخطوتين التاليتين اختيارية ، إلا أنه يوصى بشدة بتنفيذ جميع هذه التعليمات لتمكين أمان HTTPS.

الخطوة 4 (اختياري): الحصول على شهادة Let's Encrypt SSL

عدم السماح بالوصول إلى المنفذ 3000:

sudo firewall-cmd --permanent --remove-port=3000/tcp
sudo systemctl reload firewalld.service

تثبيت الأداة المساعدة Certbot:

sudo yum -y install yum-utils
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
sudo yum install -y certbot

التقدم بطلب للحصول على شهادة Let's Encrypt SSL للمجال gogs.example.com:

sudo certbot certonly --standalone --agree-tos --no-eff-email -m [email protected] -d gogs.example.com

سيتم حفظ الشهادة والسلسلة على النحو التالي:

/etc/letsencrypt/live/gogs.example.com/fullchain.pem

سيتم حفظ الملف الرئيسي هنا:

/etc/letsencrypt/live/gogs.example.com/privkey.pem

بشكل افتراضي ، تنتهي صلاحية شهادة Let's Encrypt SSL في غضون ثلاثة أشهر. يمكنك إعداد وظيفة cron على النحو التالي للتجديد التلقائي لشهادات Let's Encrypt الخاصة بك:

sudo crontab -e

اضغط Iوأدخل السطر التالي:

0 0,12 * * * python -c 'import random; import time; time.sleep(random.random() * 3600)' && certbot renew

احفظ واخرج:

:wq!

ستحاول وظيفة cron هذه تجديد شهادة Let's Encrypt ظهرًا كل يوم.

الخطوة 5 (اختياري): قم بتثبيت Nginx كخادم وكيل عكسي

قم بتثبيت Nginx باستخدام EPEL YUM repo:

sudo yum install -y nginx

إنشاء ملف تكوين لـ Gogs:

cat <<EOF | sudo tee /etc/nginx/conf.d/gogs.conf
# Redirect HTTP to HTTPS
server {
    listen      80;
    server_name gogs.example.com;
    return      301 https://\$server_name\$request_uri;
}

server {

    # Setup HTTPS certificates
    listen       443 default ssl;
    server_name  gogs.example.com;
    ssl_certificate      /etc/letsencrypt/live/gogs.example.com/fullchain.pem;
    ssl_certificate_key  /etc/letsencrypt/live/gogs.example.com/privkey.pem;

    # Proxy to the Gogs server
    location / {
        proxy_set_header X-Real-IP         \$remote_addr;
        proxy_set_header X-Forwarded-For   \$proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-Host  \$http_host;
        proxy_set_header Host              \$http_host;
        proxy_max_temp_file_size           0;
        proxy_pass                         http://127.0.0.1:3000;
        proxy_redirect                     http:// https://;
    }
}
EOF

أعد تشغيل Nginx من أجل تفعيل التهيئة:

sudo systemctl daemon-reload
sudo systemctl restart nginx.service
sudo systemctl enable nginx.service

أخيرًا ، وجه متصفح الويب المفضل لديك http://gogs.example.com/لبدء استكشاف موقع Gogs الخاص بك. ستجد أن بروتوكول HTTPS يتم تنشيطه تلقائيًا. سجّل الدخول كمشرف أعددته سابقًا ، أو سجل حسابات مستخدمين جديدة للعمل الجماعي.