ربط GitLab بـ Notion
يساعد GitLab الفرق على إدارة التعليمات البرمجية، والتعاون في تطوير البرمجيات، وتتبع الإصدارات. يمكنك مزامنة مشاريع GitLab، والمشكلات، وطلبات الدمج، وخطوط الأنابيب، والإصدارات في Notion للحفاظ على عمل التطوير جنباً إلى جنب مع خطط فريقك ومستنداته.
نحن نستبدل مزامنات GitLab المُدارة الحالية بمزامنات مخصصة مدعومة بواسطة Notion Workers. يمكنك تخصيص البيانات التي تقوم بمزامنتها وكيفية تنظيمها في Notion. تظل بياناتك المتزامنة الحالية في Notion؛ اتبع هذا الدليل لإعداد بديل. تعرف على المزيد حول Notion Workers →
ستتوقف مزامنات GitLab الحالية عن العمل في 30 أكتوبر 2026. ستستمر في العمل بشكل طبيعي حتى ذلك الحين، لكنها لن تنتقل من تلقاء نفسها. نوصي بإعداد مزامنة بديلة قبل ذلك التاريخ.
تقوم Workers بتشغيل مزامنتك على البنية التحتية لـ Notion. لإعداد بديلك، استخدم @-mention للإشارة إلى قاعدة بياناتك المتزامنة الحالية في محادثة مع Notion AI وقم بتضمين المهارة لمزامنة GitLab.
اجعل هذه جاهزة:
قاعدة بياناتك المتزامنة مع GitLab الحالية في Notion. تأكد من أن Notion AI يمكنه الوصول إليها.
القائمة الكاملة لمشاريع GitLab المراد تضمينها. يمكنك تقديم عناوين URL للمشروع، أو المعرفات الرقمية، أو المسارات مثل my-team/my-project. تعرف على كيفية عرض المشاريع في GitLab →
رمز وصول شخصي أو خاص بالمشروع لـ GitLab مع read_api وإمكانية الوصول إلى كل مشروع محدد.
الوصول إلى Workers والأدوات التي يحتاجها Notion AI لإنشاء ونشر Worker في مساحة عملك.
صفحة المهارة هذه، التي ستنسخها إلى حساب Notion الخاص بك: GitLab Guide: Worker Sync. هذه المهارة مخصصة لـ GitLab.com. إذا كنت تستخدم مثيل GitLab مُدار ذاتياً، فأخبر Notion AI قبل الإعداد. يحتاج عنوان API الخاص بالدليل وتكوين بيانات الاعتماد إلى التكيف والتحقق من صحة مثيلك.
ملاحظة: ينشئ هذا الدليل قواعد بيانات بديلة. تظل قاعدة بياناتك الحالية متاحة أثناء التحقق منها. لا يتم نقل روابط صفحاتها، وطرق عرضها، وعلاقاتها، والمعلومات الخاصة بـ Notion تلقائيًا.
افتح محادثة مع Notion AI في مساحة العمل التي تحتوي على قاعدة بياناتك المتزامنة الحالية.
انسخ المطالبة أدناه. استبدل @Existing GitLab sync database بكتابة @ واختيار قاعدة البيانات الفعلية من قائمة الإشارات. إذا كانت المشكلات وطلبات الدمج في قواعد بيانات متزامنة منفصلة، فقم بالإشارة إلى كلتيهما.
استبدل مزامنة GitLab الحالية الخاصة بي، @Existing GitLab sync database، باستخدام Notion Worker عبر GitLab Guide: Worker Sync.
افحص قاعدة البيانات الحالية وأكّد معي قائمة مشاريع GitLab الكاملة. اتبع المهارة لإنشاء المزامنات كل ساعة، وقواعد البيانات الخمس ذات الصلة، وطرق العرض، ولوحة المعلومات ضمن صفحة GitLab Sync خاصة. إذا كان هناك Worker بديل موجود بالفعل، فافحصه وأعد استخدامه حيثما كان ذلك مناسباً.
حافظ على قاعدة بياناتي الحالية سليمة. حدد الخصائص المخصصة، والقيم الخاصة بـ Notion فقط، وطرق العرض، والعلاقات، والروابط التي تحتاج إلى معالجة منفصلة. اطلب رمز GitLab الخاص بي من خلال إدخال بيانات اعتماد آمن، وليس في المحادثة.
عاين كل مشروع ونوع بيانات تم اختياره، وأكمل المزامنة الأولى، وتحقق من السجلات وعلاقات المشروع. اعرض لي قواعد البيانات البديلة، وأي اختلافات، وخطوات التبديل قبل تغيير المزامنة القديمة.
حدد إشارة إلى قاعدة بيانات فعلية في المطالبة. كتابة اسم قاعدة البيانات وحده لا يمنح Notion AI رابطًا للفحص.
أكّد قائمة المشاريع الكاملة، بما في ذلك المشاريع المخفية بواسطة عوامل تصفية عرض Notion الحالية الخاصة بك. الرمز المقتصر على مشروع واحد لن يكون كافيًا لمزامنة تحتاج أيضًا إلى الوصول إلى مشاريع أخرى.
اتبع تعليمات Notion AI لتقديم رمز GitLab الخاص بك من خلال إدخال بيانات الاعتماد الآمن. يحتاج الرمز إلى read_api والوصول إلى المشاريع المحددة.
لا تقم بلصق الرمز في الدردشة، أو صفحة Notion، أو خاصية قاعدة بيانات. يستخدم Worker بيانات اعتماد وسيطة، لذا لا يحتاج الكود الخاص به إلى قراءة الرمز الخام.
يستخدم هذا الإعداد بيانات اعتماد Worker جديدة. ولا يوفرها ربط GitLab الحالي الخاص بك تلقائيًا.
إذا لم يتمكن Notion AI من الوصول إلى المهارة أو أدوات Worker، فقم بحل مشكلة الوصول تلك أولًا. يحتوي الدليل المرتبط أيضًا على تعليمات الإعداد لشخص في فريقك يمكنه استخدام واجهة سطر أوامر Notion.
تنشئ المهارة صفحة مزامنة GitLab خاصة تحتوي على خمس قواعد بيانات متزامنة ولوحة تحكم:
قاعدة البيانات | ما تتضمنه |
|---|---|
مشاريع GitLab | أسماء المشاريع، والمسارات، والأوصاف، وحالة الأرشفة، والرؤية، والفروع الافتراضية، والروابط، وتواريخ النشاط. |
مشكلات GitLab | المشكلات عبر مختلف الحالات، مع المسؤولين، والتصنيفات، والمعالم، والخطورة، وتواريخ الاستحقاق، وعلاقات المشاريع. |
طلبات الدمج في GitLab | طلبات الدمج عبر مختلف الحالات، مع حالة المسودة، والمؤلفين، والمسؤولين، والفروع، وحالة الدمج، وعلاقات المشاريع. |
خطوط أنابيب GitLab | حالة خط الأنابيب، والمراجع، والمصدر، والتواريخ، والروابط، وعلاقات المشاريع. |
إصدارات GitLab | أسماء الإصدارات، والوسوم، والأوصاف، وتواريخ الإصدار، والروابط، وعلاقات المشاريع. |
تجمع لوحة تحكم GitLab هذه السجلات معًا في مخططات وقوائم عمل. وهي تتضمن المشكلات المفتوحة، وطلبات الدمج المفتوحة، وخطوط الأنابيب الفاشلة، والإصدارات الأخيرة، ونشاط المشروع.
تحتوي قواعد البيانات الخمس المتزامنة على السجلات. وتعرض لوحة التحكم طرق عرض لتلك السجلات. قد تكون قاعدة بيانات المشكلات أو طلبات الدمج القديمة الخاصة بك تغطي أنواع بيانات أقل مما يوفره الإعداد الافتراضي لهذه المهارة.
تحقق من هذه الاختلافات قبل التبديل:
الأشخاص والتصنيفات: يتم تخزين المؤلفين، والمسؤولين، والتصنيفات كنصوص في هذا الدليل. وهي ليست خصائص أشخاص أو اختيار متعدد في Notion.
علاقات المشروع: يجب أن ترتبط المشكلات وطلبات الدمج وخطوط الأنابيب والإصدارات بسجلات مشاريعها المحددة.
هوية السجل: يجب أن تظل السجلات من مشاريع مختلفة متميزة حتى عند استخدامها لنفس رقم المشكلة أو طلب الدمج المحلي للمشروع.
محتوى إضافي: لا يقوم الدليل بمزامنة تعليقات المشكلات أو مناقشات طلبات الدمج أو ملفات المستودع أو سجلات المهام. اطلب من Notion AI تقييم أي حقول إضافية يحتاجها سير عملك الحالي.
انتظر حتى تؤكد Notion AI أن جميع عمليات المزامنة الخمس سليمة وأن الاستيراد الأولي قد اكتمل.
قارن كل مشروع محدد بـ GitLab. تحقق من عينة من المشكلات المفتوحة والمغلقة وطلبات الدمج وخطوط الأنابيب والإصدارات.
تأكد من أن علاقات المشروع وطرق عرض لوحة المعلومات تظهر السجلات المتوقعة.
تحقق من وصول تغيير حديث في GitLab إلى البديل بعد تحديث ناجح.
راجع الخصائص المخصصة لقاعدة البيانات القديمة والقيم الخاصة بـ Notion فقط مع Notion AI. انقل ما تحتاجه باستخدام معرفات سجلات GitLab الثابتة.
قم بتحديث الروابط وطرق عرض قاعدة البيانات المرتبطة والعلاقات والأتمتة التي يجب أن تستخدم البديل. راجع أذونات مشاركة الصفحة الجديدة.
بمجرد أن يبدأ فريقك في استخدام البديل، اطلب من Notion AI المساعدة في إيقاف المزامنة القديمة مع إبقاء قاعدة البيانات القديمة متاحة للرجوع إليها.
لست بحاجة إلى حذف قاعدة البيانات القديمة لاستخدام Worker. احتفظ بها حتى تتأكد من مراعاة معلومات فريقك وسير عمله.
تقوم المهارة بإعداد خمس عمليات مزامنة كل ساعة، واحدة لكل نوع من أنواع البيانات. تتم مزامنة المشاريع أولاً أثناء الإعداد حتى تتمكن قواعد البيانات الأخرى من ربط سجلاتها بالمشاريع الصحيحة.
تقرأ كل عملية تحديث ناجحة جميع صفحات النتائج للمشاريع المُكوَّنة وتُحدِّث قاعدة بيانات Notion المطابقة. يستمر Worker في العمل عند إغلاق Notion.
تتدفق التحديثات من GitLab إلى Notion. قم بإجراء تغييرات على القيم المتزامنة في GitLab؛ لا تتم كتابة التغييرات في Notion مرة أخرى.
المزامنة كل ساعة هي الجدولة، وليست ضماناً بأن كل تحديث سينتهي في وقت محدد. يمكن أن تؤدي سجلات المشاريع الكبيرة وحدود طلبات GitLab إلى تأخير الإكمال.
تلميح: احتفظ بقائمة المشاريع كاملة. تستخدم عمليات المزامنة هذه وضع الاستبدال: تتم إزالة السجلات المفقودة من التحديث المكتمل من قاعدة البيانات التي تمت مزامنتها. قد تؤدي إزالة مشروع من التكوين إلى إزالة سجلاته التي تمت مزامنتها، بما في ذلك المعلومات الخاصة بـ Notion فقط الموجودة على تلك الصفحات. اطلب من Notion AI معاينة كل مشروع ونوع بيانات محدد قبل تطبيق أي تغيير.
تبدأ المهارة بصفحة GitLab Sync خاصة. شاركها فقط مع الأشخاص الذين يجب أن يروا السجلات المستوردة.
تتحكم أذونات Notion في الوصول إلى البيانات المتزامنة. لا تفرض خاصية Visibility لمشروع GitLab أو خاصية Confidential للمشكلة إذن المصدر ذلك في Notion. راجع البيانات المضمنة بواسطة الرمز المميز قبل مشاركة الصفحة.
مشروع مفقود
قم بتأكيد قائمة المشاريع الكاملة والوصول إلى الرمز المميز. امنح Notion AI عنوان URL الخاص بالمشروع أو معرفه الرقمي إذا تغير مساره. لا تقم بإجراء تحديث بقائمة مختصرة لمجرد تجاوز خطأ في الوصول.
مشكلة أو طلب دمج مفقود
اطلب من Notion AI التحقق من اختيار المشروع، وما إذا كان يتحقق من المشكلات وطلبات الدمج في كل حالة، وفي كل صفحة من النتائج. تحقق من عوامل تصفية عرض Notion أيضًا.
لوحة المعلومات فارغة
اطلب من Notion AI التحقق من قواعد بيانات المصدر، ونتائج مزامنتها الأخيرة، وعلاقات المشروع قبل إعادة بناء لوحة المعلومات. يمكن أن تكون لوحة المعلومات فارغة بينما لا يزال الاستيراد الأولي قيد التشغيل.
أرى قواعد بيانات مكررة
اطلب من Notion AI فحص الـ Worker الحالي، وعناوين URL لقاعدة البيانات، وهيكل الصفحة قبل إنشاء أي شيء آخر. تتطلب المهارة خمس قواعد بيانات متزامنة فعلية ولوحة معلومات واحدة تحت GitLab Sync. اطلب من Notion AI تحديد أي تكرارات قبل إزالتها.
توقفت التحديثات
اطلب من Notion AI التحقق من أحدث عمليات التشغيل لـ Worker، وانتهاء صلاحية الرمز المميز، وأذونات الرمز المميز، والوصول إلى كل مشروع محدد. بالنسبة للمثيل المُدار ذاتيًا، تحقق أيضًا من مضيف GitLab المُكوَّن. يمكن أن تؤدي حدود الطلبات إلى تأخير التحديثات.
