كيفية تثبيت وتكوين يأجوج على أوبونتو 18.04

Gogs هو خادم git مفتوح المصدر مستضاف ذاتيًا ومكتوب في Go. ويتضمن محرر ملفات مستودع ، وتتبع قضية المشروع ، ويكي مدمج.

تطبيق 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.

تثبيت يأجوج

سنقوم بتثبيت يأجوج من ثنائي. التثبيت عملية جميلة للأمام بشكل مستقيم.

تثبيت جيت

الخطوة الأولى هي تثبيت 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 وقم بتنزيل أحدث إصدار ثنائي للعمارة الخاصة بك. في وقت كتابة هذا التقرير ، كان أحدث إصدار هو 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

بمجرد اكتمال التنزيل ، قم باستخراج ملف Gogs tar.gz وانقله إلى الدليل /home/git :

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

قم بتشغيل الأمر التالي لتغيير ملكية دليل تثبيت Gogs إلى بوابة المستخدم والمجموعة:

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

إنشاء ملف وحدة systemd

يأتى Gogs بملف وحدة Systemd الذي تم تهيئته بالفعل لمطابقة إعدادنا.

انسخ الملف إلى /etc/systemd/system/ directory بكتابة:

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 وتشغيلها ، فقد حان الوقت لإنهاء التثبيت من خلال واجهة الويب.

افتح المتصفح ، واكتب http://YOUR_DOMAIN_IR_IP:3000 شاشة مشابهة للشاشة التالية:

تتم إضافة المستخدم المسجل الأول تلقائيًا إلى مجموعة المسؤولين.

هذا هو. تم تثبيت Gogs على جهاز Ubuntu الخاص بك.

تكوين Nginx كوكيل إنهاء SSL

هذه الخطوة اختيارية ولكنها موصى بها بشدة. لاستخدام Nginx كبروكسي عكسي ، يجب أن يكون لديك مجال أو مجال فرعي يشير إلى عنوان IP العمومي لخادمك. في هذا البرنامج التعليمي ، سنستخدم gogs.example.com .

أولاً ، قم بتثبيت Nginx وإنشاء شهادة Let's Encrypt SSL مجانية باتباع الإرشادات أدناه:

بمجرد الانتهاء من ذلك ، افتح محرر النصوص وقم بتحرير ملف كتلة خادم المجال:

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 للجذر. للقيام بذلك ، افتح ملف التكوين وتحرير الأسطر التالية:

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

تكوين إعلامات البريد الإلكتروني

من أجل تمكين 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

تتيح لك Gogs أيضًا الاتصال بـ Slack عن طريق إنشاء webhook على الويب وإرسال الإشعارات إلى قنوات Slack.

ترقية يأجوج

لترقية 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 باستخدام إصدار إصدار Gogs الفعلي.

   قم بنسخ الدلائل custom data log إلى الدليل المستخرج باستخدام الأمر rsync التالي:

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

   أخيرًا ، ابدأ تشغيل خدمة Gogs:

   sudo systemctl restart gogs

هذا هو.

استنتاج

مررتك هذه الدورة التعليمية عبر تثبيت Gogs وتكوينه على Ubuntu 18.04. يمكنك الآن إنشاء مشروعك الأول والبدء في استخدام خادم Gogs الجديد.

أوبونتو يأكلون