هل لا تريد دفع الكود الخاص بك إلى مستودع Git مُستضاف؟ إذن قم بتشغيل خادم Git الخاص بك داخليًا. Gogs هي أسهل طريقة للقيام بذلك. إليك كيفية إعداده.
المشكلة مع مستودعات التخزين المستضافة على السحابة
بدون شك، جيت يعد Git نظام التحكم في الإصدارات الرائد. حتى مع المشاريع التي يعمل بها مطور واحد، يوفر Git قيمة وفائدة بسبب وظيفة إدارة الإصدارات. بالنسبة للمشاريع التي يعمل بها مطورون متعددون، يقدم Git بُعدًا آخر تمامًا. من خلال مستودع مركزي بعيد، يتيح Git إمكانية تعاونية من شأنها أن تحول الطريقة التي تنظر بها فرق التطوير الخاصة بك إلى التحكم في الإصدارات.
ولهذا السبب فإن الخدمات مثل جيثب, جيت لاب، و بيتبوكيت هناك العديد من المستودعات التي تستضيفها GitHub، ولكن لماذا شهدت مثل هذا الإقبال والنمو؟ تستضيف GitHub وحدها أكثر من 200 مليون مستودع. ولكن المستودعات المستضافة على السحابة لا تناسب الجميع. معظمها تفرض رسومًا لاستضافة المستودعات الخاصة. بعضها يفرض حدودًا للتخزين أو حدودًا للمستخدمين أو حدودًا لنقل البيانات على الحسابات المجانية.
حتى لو كان استخدامك وحجم فريقك يتناسبان مع قيود الحسابات المجانية، أو حتى إذا كنت على استعداد لدفع ثمن ترخيص تجاري، فقد لا تشعر بالراحة عند تخزين قاعدة التعليمات البرمجية الخاصة بك في السحابة.
البديل هو استضافة خادم Git الخاص بك إما محليًا على شبكتك الخاصة، أو الوصول إليه بشكل خاص في سحابتك الخاصة. كان إعداد خادم Git الذي يوفر واجهة ويب ذات المظهر والأسلوب والخيارات التي جعلتها GitHub وشركات أخرى شائعة للغاية يتطلب درجة معينة من المهارة الفنية. وهنا يأتي دور Gogs.
ما هو جوجس؟
جوج هو مشروع جديد نسبيًا، مكتوب بلغة يذهب، الذي يوفر نسخة Git سهلة التثبيت، ولكنها كاملة الميزات. لا توجد حدود لحجم الفريق، أو التخزين، أو أي شيء آخر.
حتى لو كنت مبرمجًا هاويًا، فإن استخدام Gogs كخدمة Git على شبكتك المحلية يتيح لك تخزين نسخة من الكود الخاص بك بعيدًا عن جهاز التطوير الخاص بك. عندما تريد أنت أو شخص آخر العمل على جهاز كمبيوتر مختلف أو جديد، يمكنك ببساطة استنساخ مستودع من خادم Gogs الخاص بك تمامًا كما تفعل من GitHub.
إذا كنت ستستخدم Gogs بشكل متكرر، فربما تجد أنه من المناسب إضافته إلى تطبيقات بدء التشغيل للكمبيوتر الذي يعمل عليه.
كيفية تثبيت Gogs
لتثبيت Gogs، قم بتنزيل ملف الأرشيف المناسب، وفك ضغطه، وتشغيل الملف الثنائي الرئيسي. قم بملء بعض النماذج، وسيقوم Gogs بتهيئة المستودع الخاص بك وإضافتك كمستخدم مسؤول. يمكنك بعد ذلك الانتقال إلى مثيل Gogs الخاص بك وإضافة المستخدمين وإنشاء المستودعات.
يستخدم Gogs قاعدة بيانات لتخزين البيانات الخلفية. وهو يدعم ماي إس كيو إل, ماريا دي بي, بوستجرس كيو ال، و تي دي بيإذا كنت تريد استخدام أحد محركات قواعد البيانات القوية هذه، فيجب عليك تحديد موقعها وتثبيتها بنفسك، قبل تثبيت Gogs. بالنسبة للفرق الأصغر حجمًا، يمكنك استخدام إس كيو لايت 3إذا اخترت SQLite3، فسيتم تثبيته لك. بالطبع، ستحتاج إلى
git تم تثبيته أيضاً.
تنزيل ثنائي مناسب.
- بالنسبة لمعظم توزيعات Linux الحديثة، قم بتنزيل الملف “Linux amd64”.
- إذا كنت تستخدم إصدار 32 بت من Linux، قم بتنزيل الملف “Linux 386”.
- إذا كنت تقوم بالتثبيت على Raspberry Pi 2 أو إصدار سابق، فقم بتنزيل الملف “Linux armv7”.
- إذا كنت تقوم بالتثبيت على Raspberry Pi 3 أو 3+ أو إصدار أحدث، فقم بتنزيل الملف “Linux armv8”.
- إذا كنت تستخدم جهاز Mac بمعالج Intel، فقم بتنزيل الملف “macOS amd64”.
- بالنسبة لجهاز Apple Silicon Mac، قم بتنزيل الملف “macOS arm64”.
لقد قمنا بتنزيل ملف ZIP “Linux amd64” لتثبيته على جهاز كمبيوتر يعمل بنظام 64 بت يعمل بنظام التشغيل Ubuntu 22.10. حجم الملف صغير — حوالي 25 ميجا بايت فقط — لذا لا تتفاجأ إذا تم تنزيله بسرعة كبيرة. هذا أمر طبيعي.
حدد موقع الملف في نظام الملفات لديك. إذا احتفظت بموقع التنزيل الافتراضي للمتصفح، فمن المحتمل أن يكون الملف موجودًا في دليل “~/Downloads”. انقر بزر الماوس الأيمن فوقه وحدد “استخراج” من قائمة السياق. قد تستخدم بعض متصفحات الملفات “استخراج هنا” بدلاً من ذلك.
يتم استخراج الدليل من ملف ZIP. ويتم تسميته على اسم الملف الذي تم تنزيله. وفي حالتنا، كان اسمه “gogs_0.11.91_linux_amd64”.
انقر نقرًا مزدوجًا فوق الدليل المستخرج وسوف ترى دليلًا آخر يسمى “gogs”.
انقر نقرًا مزدوجًا فوق دليل “gogs”. سترى ملفات ودلائل Gogs. انقر بزر الماوس الأيمن في نافذة متصفح الملفات وحدد “فتح في المحطة الطرفية” من قائمة السياق.
لبدء تشغيل مثيل Gogs، اكتب هذا الأمر:
./gogs الويب
يتم تشغيل Gogs ويخبرك أنه يستمع على المنفذ 3000.
اتصل بخادم Gogs الخاص بك عن طريق فتح متصفح ويب والانتقال إلى عنوان IP أو اسم الشبكة للكمبيوتر الذي يعمل عليه Gogs. أضف “:3000” بعد عنوان IP أو اسم الشبكة. لا تقم بتضمين أي مسافات.
إذا كنت تتصفح على الكمبيوتر الذي يعمل عليه Gogs، فيمكنك استخدام “localhost” كاسم للجهاز، مثل “localhost:3000”. يُسمى كمبيوتر Gogs الخاص بنا “ubuntu-22-10.local”، لذا من كمبيوتر مختلف على نفس الشبكة، يكون العنوان الذي نحتاج إلى التصفح إليه هو “ubuntu-22-10.local:3000″، بما في ذلك رقم المنفذ.
عندما تفعل ذلك لأول مرة، سترى النموذج الذي يلتقط بعض معلومات الإعداد الأولي.
أول شيء يتعين علينا القيام به هو تحديد “SQLite3” من القائمة المنسدلة “نوع قاعدة البيانات” وإدخال اسم المستخدم الخاص بك في الحقل “تشغيل المستخدم”.
إذا كنت تريد إعداد إشعارات البريد الإلكتروني، فستحتاج إلى تكوين بعض الخطوات الإضافية. ستحتاج إلى نقل رسائل البريد الإلكتروني عبر خادم بريد بروتوكول نقل البريد البسيط (SMTP) الذي لديك إذن لاستخدامه. إذا كنت مستخدمًا لخدمة Gmail من Google، فيمكنك استخدام خادم SMTP لخدمة Gmail من Google.
سيتطلب هذا إعدادات على خادم البريد للسماح لحسابك بقبول البريد الإلكتروني وإرساله. تختلف هذه الإعدادات من خادم بريد إلى آخر.
يتطلب Gogs منك إدخال المعلومات التالية حول خادم البريد الإلكتروني الخاص بك.
- مضيف SMTP:عنوان ومنفذ خادم البريد الإلكتروني. في مثالنا، هذا هو خادم SMTP الخاص بشركة Google على smtp.gmail.com:587.
- من:عنوان البريد الإلكتروني الذي سيتم إرسال البريد الإلكتروني منه. بالنسبة إلى Gmail، يجب أن يكون هذا عنوان بريد Gmail الإلكتروني للحساب الذي تستخدمه.
- البريد الإلكتروني للمرسل:يجب أن يكون هو نفس معرف حساب البريد الإلكتروني المذكور أعلاه. هذا هو معرف حساب البريد الإلكتروني الذي سيستخدمه Gogs للتواصل مع خادم SMTP.
- كلمة مرور المرسل: هذا هو لا كلمة المرور لحساب Gmail. وهي كلمة المرور الخاصة بالتطبيق والتي تحصل عليها من Google عندما تقوم بتكوين حسابك للسماح لتطبيق بإرسال بريد إلكتروني نيابة عنك.
- تمكين تأكيد التسجيل:لجعل Gogs تتحقق من رسائل البريد الإلكتروني للمستخدمين، حدد مربع الاختيار هذا. سيتلقى المستخدمون الجدد رسالة بريد إلكتروني تحتوي على رابط. يجب عليهم النقر فوق لإثبات أن عنوان البريد الإلكتروني أصلي وتحت سيطرتهم.
- تمكين إشعار البريد الإلكتروني:قم بتحديد مربع الاختيار هذا للسماح بإشعارات البريد الإلكتروني من Gogs.
بالطبع، إذا كنت لا تريد أن تزعجك رسائل البريد الإلكتروني، يمكنك تخطي كافة إعدادات البريد الإلكتروني.
انقر فوق الزر الأزرق “تثبيت Gogs” عندما تكون مستعدًا للمتابعة. يكتب Gogs ملف تكوين، ويقوم بتهيئة تخزين قاعدة البيانات، ويبدأ تشغيل مثيل Git الخاص بك.
ستشاهد الصفحة الرئيسية لـ Gogs.
سيتم منح حساب المستخدم الأول الذي تقوم بإنشائه حقوق المسؤول تلقائيًا. انقر فوق رابط “التسجيل”.
أكمل نموذج “التسجيل” باسم حسابك وكلمة المرور لهذا الحساب (أدخلها مرتين) والأرقام الموجودة في رمز التحقق. انقر فوق الزر الأخضر “إنشاء حساب جديد”. سترى صفحة “تسجيل الدخول”.
أدخل اسم حسابك وكلمة المرور، ثم انقر على زر “تسجيل الدخول” باللون الأخضر.
جولة سريعة في جوجس
إذا كنت على دراية بأي مثيل Git آخر يمكن الوصول إليه عبر الويب، فستجد طريقك حول Gogs بسهولة بالغة.
إن عرض “لوحة معلومات” Gogs غير واضح إلى أن يتوفر لديك مستودع للعمل عليه. انقر فوق الزر الأزرق “+” وأكمل نموذج “مستودع جديد”.
يطلب اسم المستودع، سواء كان خاصًا أو عامًا، ووصفًا.
الحقول الثلاثة التالية تقوم بإنشاء ملفات من القوالب.
- تتيح لك قائمة “.gitignore” تحديد قالب لملف “.gitignore” الخاص بك مع إعدادات تتوافق مع اللغات المحددة. يمكنك إجراء أكثر من اختيار من هذه القائمة، لتلبية احتياجات المستودعات التي تستخدم مزيجًا من تقنيات التطوير.
- تتيح لك قائمة “الترخيص” اختيار ترخيص من قائمة شاملة.
- تحتوي قائمة “Readme” على خيار واحد، وهو ملف “README.md” الافتراضي.
قم بتحديد مربع الاختيار “تهيئة هذا المستودع باستخدام الملفات والقوالب المحددة”، ثم انقر فوق الزر الأخضر “إنشاء مستودع”.
يتم عرض مستودعك الجديد لك. لقد أنشأ Gogs ملفاتنا القياسية الثلاثة لنا، وأضافها إلى المستودع مع رسالة الالتزام “الالتزام الأولي”.
لقد قمنا باستنساخ المستودع على جهاز الكمبيوتر الخاص بنا، وأضفنا ملفًا يسمى “ack.c”، وقمنا بتثبيته، ثم قمنا برفعه إلى مستودع Gogs البعيد الخاص بنا. وقد تم كل هذا باستخدام أوامر Git القياسية.
كما هو متوقع، يظهر ملفنا الجديد في مستودع Gogs الخاص بنا.
يؤدي النقر فوق ملف إلى إظهار محتوى الملف الفردي. يتم تفسير ملفات Markdown لك، مع العناوين والروابط والقوائم وكل ميزات Markdown الأخرى. عادةً ما تتم كتابة ملفات “README.md” بلغة Markdown.
بالنقر على أيقونة القلم “تحرير”، يمكننا تعديل ملف “README.md” مباشرةً. أضفنا بعض النصوص الإضافية، واستخدمنا علامات Markdown لإدراج الروابط التشعبية والخط المائل، وقمنا بتنفيذ التغييرات التي أجريناها. كل ذلك من داخل Gogs.
عند العودة إلى عرض المستودع الخاص بنا، يتم عرض ملف “README.md” المحدث، ويعرض إدخال “README.md” في قائمة الملفات رسالة التزام جديدة ووقت التحديث.
أسهل خادم Git – Bar None
يعد Gogs إنجازًا مطلقًا، فهو يمزج بشكل مثالي بين الوظيفة والبساطة.
بمجرد تشغيله، سيلبي احتياجات أغلب فرق التطوير الصغيرة أو الهواة. يتم تنشيط بعض خياراته المتقدمة عن طريق تحرير ملف التكوين الذي يوجد افتراضيًا في “~/Downloads/gogs_0.12.10_linux_amd64/gogs/custom/conf/app.ini.” لاحظ أن المسار سيعكس إصدار Gogs الذي تستخدمه.
يمكن إجراء الإدارة العامة للنظام من لوحة الإدارة الموجودة على
Your Profile > Admin panel .
على الرغم من أن وثائق Gogs مختصرة إلى حد كونها موجزة، فهذا يعني أنه من السهل العثور على ما تبحث عنه، كما أن الأوصاف مفصلة بما يكفي لتتبعها.
إذا كنت حذرًا بشأن المستودعات المستضافة على السحابة والتي تقع في النهاية تحت سيطرة الآخرين، ففكر في استخدام Gogs محليًا. لن تفقد الوظائف، ولكنك ستكتسب التحكم والخصوصية المضمونة.