احفظ مشروعك في GitHub
باختصاراربط GitHub بنقرة واحدة عبر GitHub App الخاص بـ MonstarX (لا حاجة إلى رمز، وأنت تختار المستودعات)، ثم اضغط GitHub في الشريط العلوي للمشروع لإنشاء مستودع جديد أو ربط مستودع موجود. يرسل MonstarX المشروع كاملًا، ثم يحفظ كل تغيير يجريه في commit، ويجلب ما تحفظه أنت على GitHub. أما التطبيقات المستوردة فتُزامن مع فرع باسم monstarx، فلا يتحرك فرعك الخاص أبدًا.
GitHub هو المكان الذي يحفظ فيه المطورون الشفرة، مع سجل لكل تغيير. اربط مشروع MonstarX بمستودع على GitHub (مجلد المشروع على GitHub)، فيبقى الاثنان متطابقين في الاتجاهين: ما ينشئه MonstarX يُرسَل إلى هناك في شكل commits، وما تحفظه أنت أو أي مطور هناك يعود إلى MonstarX.
يفيدك ذلك عندما يريد مطور العمل على الشفرة في محرره الخاص، أو عندما تحفظ شركتك كل الشفرة على GitHub، أو عندما تنشر من GitHub، كما تفعل Railway مثلًا.
كيف أربط حسابي على GitHub؟
Section titled “كيف أربط حسابي على GitHub؟”تربط GitHub مرة واحدة لحسابك كله في MonstarX، من الإعداداتالتكاملات أو من زر GitHub في أي مشروع. وأسهل طريقة هي GitHub App الخاص بـ MonstarX: لا رمز عليك إنشاؤه أو لصقه، وأنت تحدد بالضبط المستودعات التي يمكن لـ MonstarX الوصول إليها.
-
انقر على ربط حساب GitHub الشخصي.
-
يُفتح GitHub ويسألك أين تريد تثبيت التطبيق. اختر حسابك الشخصي (لا مؤسسة).
-
اختر المستودعات التي يمكن لـ MonstarX استخدامها: All repositories، أو Only select repositories ثم حدد ما تريده منها. ويمكنك تغيير ذلك لاحقًا على GitHub.
-
انقر على Install، ثم على Authorize عندما يطلب منك GitHub التأكيد.
-
تعود إلى MonstarX، وتظهر على البطاقة متصل · GitHub App.
بعض ما يجب معرفته عن GitHub App:
- لا حاجة إلى موافقة أي مؤسسة. يُثبَّت على حسابك الشخصي فقط. وإذا اخترت مؤسسة بالخطأ، يطلب منك MonstarX تثبيته على حسابك الشخصي والمحاولة مجددًا.
- تُنشأ المستودعات الجديدة في حسابك الشخصي. ويستطيع MonstarX دائمًا الوصول إلى أي مستودع أنشأه، حتى لو اخترت Only select repositories.
- المستودعات التي تختارها هي الحد. لربط مستودع موجود، يجب أن يكون من المستودعات التي منحتها للتطبيق. وأضف المزيد من إعدادات GitHub الخاصة بالتطبيقات المثبتة.
- صلاحية الوصول قصيرة الأمد وتُجدَّد تلقائيًا، وتُحفظ مشفّرة. ولا تُرسَل أبدًا إلى متصفحك.
طرق أخرى للربط
Section titled “طرق أخرى للربط”إذا كنت تفضّل، تتوفر طريقتان أخريان أيضًا:
| الطريقة | متى تستخدمها |
|---|---|
| مستودع شخصي مع وصول محدود (في الإعدادات: ربط مستودع شخصي مع وصول محدود) | عندما تريد أن يصل MonstarX إلى مستودع واحد بالضبط باستخدام رمز الوصول الشخصي (كلمة مرور تنشئها على GitHub لغرض واحد). أنشئ رمزًا دقيق الصلاحيات (fine-grained) يكون فيه حسابك الشخصي هو مالك المورد، ويقتصر على ذلك المستودع، مع صلاحية Contents: read and write. وأنشئ المستودع على GitHub أولًا، لأن هذا النوع من الرموز لا يستطيع إنشاء مستودعات جديدة. |
| استخدم تفويض GitHub بدلًا من ذلك | عندما تريد الإرسال إلى مستودعات في مؤسسات أنت عضو فيها. قد تتضمن شاشة تسجيل الدخول المعتادة في GitHub صلاحية الوصول إلى تلك المؤسسات، فراجعها قبل أن توافق. |
بعد الربط، تعرض البطاقة طريقة الاتصال (GitHub App أو مسجّل الدخول عبر GitHub أو رمز الوصول الشخصي)، وتسرد كل مستودع يحدّثه MonstarX، مع وقت آخر مزامنة لكل منها، وما إذا كانت المزامنة تلقائي أو يدويًا. وإذا ربطت بطريقة أخرى لاحقًا، يحل الاتصال الجديد محل القديم، وتبقى مستودعاتك المرتبطة مرتبطة.
كيف أحفظ مشروعًا في GitHub؟
Section titled “كيف أحفظ مشروعًا في GitHub؟”-
افتح المشروع وانقر على GitHub في الشريط العلوي. (تجده أيضًا في الإعداداتتصدير للمشروع، تحت حفظ الشفرة في GitHub.)
-
إذا لم يكن حسابك مربوطًا بعد، فاربطه من هناك مباشرةً.
-
اختر مستودع جديد أو المستودع الموجود:
- مستودع جديد: اختر المالك (أنت أو إحدى مؤسساتك)، واكتب اسم المستودع، واترك مستودع خاص محددًا ما لم ترد أن يرى الجميع الشفرة، ثم انقر على إنشاء مستودع وإرسال الشفرة.
- المستودع الموجود: اكتب
owner/repositoryأو الصق عنوانه على github.com، واكتب فرع إن أردت (يُستخدم الفرع الافتراضي إذا تركته فارغًا)، ثم انقر على ربط ومزامنة. ويجب أن يملك حسابك صلاحية الإرسال إليه.
-
يرسل MonstarX المشروع كاملًا في شكل مستودع جاهز للنشر. وتظهر نقطة خضراء على زر GitHub عندما يكون متزامنًا.
يبدأ المستودع الجديد بـ commit واحد عنوانه “Initial commit from MonstarX”. أما في المستودع الموجود، فيُحفظ المشروع في commit فوق الفرع، ولا يمس MonstarX أبدًا الملفات التي لا يديرها، مثل ملف LICENSE أو مهام CI أو ملفات التوثيق.
ماذا يوجد في المستودع؟
Section titled “ماذا يوجد في المستودع؟”كل ما يمنحك إياه التصدير: شفرة التطبيق، وملفات إطار عمل MonstarX، والإعدادات اللازمة لتشغيله ونشره، وعمليات ترحيل قاعدة البيانات، وقائمة بأسماء الأسرار التي يحتاج إليها التطبيق (دون قيمها أبدًا)، وملف README.
وهناك أشياء لا تصل إلى GitHub أبدًا:
- قيم الأسرار وصفوف قاعدة بيانات تطبيقك والملفات المرفوعة تبقى لدى MonstarX.
- الصفوف المستوردة من جدول بيانات لا تُرسَل أبدًا، لأن المستودع قد يكون عامًا، وهي بيانات عملائك.
- الملفات الثنائية والملفات التي يزيد حجمها على 1 MB تُتخطى وتُدرج في سجل المزامنة.
متى يزامن MonstarX؟
Section titled “متى يزامن MonstarX؟”ما دام خيار إرسال كل تغيير تلقائيًا مفعّلًا (وهو مفعّل افتراضيًا)، يزامن MonstarX:
- بعد كل طلب يغيّر ملفات التطبيق، ويكون طلبك هو رسالة الـ commit؛
- بعد كل إصلاح تلقائي من QA؛
- بعد استعادة إصدار؛
- بعد حفظ ملف أو حذفه في تبويب الشفرة.
ويرسل زر مزامنة الآن في قائمة GitHub التغييرات ويجلبها متى شئت. وأوقف الإرسال التلقائي إذا كنت تفضّل المزامنة يدويًا.
ماذا يحدث عندما يعدّل أحد الشفرة على GitHub؟
Section titled “ماذا يحدث عندما يعدّل أحد الشفرة على GitHub؟”احفظ commits على GitHub كالمعتاد. وعند المزامنة التالية، يجلب MonstarX التغييرات إلى المشروع:
- التغييرات على ملفات التطبيق نفسه (
src/وpublic/وmigrations/وREADME.md) تصل إلى MonstarX. تتحدث المعاينة، وتُشغَّل عمليات ترحيل قاعدة البيانات الجديدة، ويظهر في الإصدارات إصدار باسم من GitHub: متبوعًا بعنوان الـ commit. - تسرد بطاقة في المحادثة، مثل «الملفات المستلمة من GitHub: 3 ملفات»، الملفاتِ المعنية، فتعرف أنت ووكيل الإنشاء في MonstarX ما الذي تغيّر.
- التغييرات على ملفات إطار عمل MonstarX، مثل
package.jsonأو ملفات الإعدادات، تبقى على GitHub إلى أن يغيّر MonstarX نفسه ذلك الملف في المرة التالية. - إذا تغيّر الملف نفسه على الجانبين، يحتفظ MonstarX بنسخته، ويحتفظ GitHub بنسختك في السجل. وتشير البطاقة إلى ذلك بعبارة «تغيّر على الجانبين — احتُفظ بنسخة MonstarX».
ماذا تعرض قائمة GitHub بعد الربط؟
Section titled “ماذا تعرض قائمة GitHub بعد الربط؟”- المستودع وفرعه، وهل هو خاص أم عام.
- وقت آخر مزامنة (آخر مزامنة منذ بضع دقائق)، أو فشلت المزامنة الأخيرة مع السبب.
- مزامنة الآن وفتح المستودع.
- إرسال كل تغيير تلقائيًا.
- المزامنات الأخيرة: آخر خمس عمليات مزامنة، مع الـ commit الخاص بكل منها.
- إلغاء ربط المستودع: يوقف المزامنة. ويبقى المستودع على GitHub.
- قطع الاتصال: يفصل حسابك على GitHub. ولا يُرسَل شيء حتى تربطه مجددًا.
ماذا عن تطبيق استوردته من GitHub؟
Section titled “ماذا عن تطبيق استوردته من GitHub؟”عندما تستورد تطبيقًا من مستودع تملك صلاحية الإرسال إليه، يبقى المشروع مرتبطًا به، على فرع جديد باسم monstarx يبدأ من الـ commit الذي استوردته. ولا يتحرك فرعك الخاص أبدًا. وعندما ترضى عن تغييرات MonstarX، يأخذك زر فتح طلب دمج (pull request) في قائمة GitHub إلى GitHub لدمجها.
الأسئلة الشائعة
Section titled “الأسئلة الشائعة”هل أحتاج إلى رمز GitHub؟
لا. يثبّت ربط حساب GitHub الشخصي تطبيق GitHub App الخاص بـ MonstarX: تسجّل الدخول على GitHub، وتختار المستودعات، وانتهى الأمر. أما رمز الوصول الشخصي فهو مجرد بديل لمن يريد حصر MonstarX في مستودع واحد بهذه الطريقة.
هل يستطيع GitHub App الوصول إلى مؤسسة شركتي؟
لا. يُثبَّت على حسابك الشخصي فقط، وينشئ المستودعات الجديدة هناك. وللإرسال إلى مستودع تابع لمؤسسة، اربط حسابك عبر استخدم تفويض GitHub بدلًا من ذلك، أو اطلب من المؤسسة إضافتك لتتمكن من ربطه من حسابك.
كيف أمنح MonstarX صلاحية الوصول إلى مستودع آخر لاحقًا؟
على GitHub، افتح إعداداتك الخاصة بتطبيقات GitHub المثبتة، واختر MonstarX، وأضف المستودع (أو بدّل إلى All repositories). ثم اربطه من قائمة GitHub في المشروع.
هل مستودعي خاص؟
المستودع الجديد خاص افتراضيًا، فلا تُلغِ تحديد مستودع خاص إلا إذا أردت أن تكون الشفرة عامة. ولا يرسل MonstarX أبدًا قيم الأسرار أو بيانات تطبيقك.
هل يمكنني ربط مستودع تابع لمؤسسة شركتي؟
نعم، إذا كان حسابك على GitHub يملك صلاحية الإرسال إليه. استخدم المستودع الموجود، أو اختر المؤسسة بصفتها المالك عند إنشاء مستودع جديد.
ماذا يحدث إذا ألغيت ربط المستودع؟
يتوقف MonstarX عن المزامنة. ويبقى المستودع وكل سجله على GitHub، ويمكنك ربطه مجددًا لاحقًا.
غيّر مطور ملف package.json على GitHub. لماذا لم يعد التغيير؟
ملفات إطار العمل مثل package.json وملفات الإعدادات يديرها MonstarX. تبقى التعديلات عليها على GitHub إلى أن يغيّر MonstarX ذلك الملف في المرة التالية، ولا تتراجع عنها عمليات المزامنة اللاحقة بصمت أبدًا.
هل يمكنني النشر من المستودع؟
نعم. المستودع جاهز للنشر، وRailway تنشر منه. راجع أيضًا النشر على استضافات أخرى.
ماذا يحدث للربط إذا نقلت ملكية المشروع؟
يُلغى، حتى لا يُرسَل أي شيء أبدًا إلى حسابك على GitHub نيابةً عن المالك الجديد. ويبقى المستودع نفسه كما هو.