في كل فريق يكبر يأتي اجتماع يطرح فيه أحدهم السؤال نفسه. الفريق بدأ بمستودع واحد فيه كل شيء: مكتبة صغيرة لحساب المبالغ بالهللات، وخدمة الطلبات، وخدمة الكتالوج. ثم أصبح الفريق ستة مطورين، وأصبح كل تعديل صغير في الكتالوج يشغل اختبارات الطلبات، وأصبح كل طلب دمج يلمس ملفات لا علاقة لصاحبه بها. فيقول أحدهم: «لنفصل كل خدمة في مستودع خاص بها، كما تفعل الشركات الكبيرة مع Microservices». ويرد آخر: «ولكن Google تضع كودها كله في مستودع واحد، ونحن ستة فقط». وغالباً ينتهي الاجتماع بقرار يعتمد على من تكلم أكثر، وليس على ما سوف يحدث فعلاً في العمل اليومي.
وفي هذا المقال لا نأخذ أياً من الرأيين على كلامه. نبني الفريق نفسه بالشكلين على سيرفر Gitea حقيقي مع Gitea Actions: مرة بمستودع واحد Monorepo فيه المكتبة والخدمتان، ومرة بثلاثة مستودعات Polyrepo، ثم نمرر على الشكلين المواقف نفسها التي سوف تمر بها: تعديل في خدمة واحدة، وتغيير غير متوافق في المكتبة المشتركة، وخطأ تقريب في الهللات يجب أن يصل إصلاحه إلى كل خدمة. ونعد في كل موقف ال Commits والمستودعات وخطوط CI التي تحركت، ونرى أين تعطل كل شكل. وسوف نناقش في هذا المقال ما يلي:
- ما الفرق بين Monorepo وPolyrepo بالضبط، ولماذا لا علاقة لهما بالفرق بين Monolith وMicroservices.
- من أين جاء كل شكل، وماذا تقول تجارب Google وFacebook المنشورة.
- المستودع الواحد في CI: مرشحات المسارات Path Filters، والتغيير غير المتوافق في Commit واحد، وماذا يحدث عندما ينسى المرشح خدمة.
- المستودعات المتعددة في CI: الإصدارات المثبتة، ورفع الإصدار، وانحراف الإصدارات بين الخدمات.
- إصلاح خطأ واحد في المكتبة المشتركة في الشكلين، مع تعارض حقيقي ظهر في الطريق.
- جدول بأرقام المختبر، ثم المقايضات الحقيقية: الصلاحيات، وحجم المستودع، وأدوات البناء، والإصدارات، والملكية.
- جدول قرار، والانتقال بين الشكلين، وأخطاء شائعة، وقائمة تحقق.
ما الفرق بالضبط؟ Monorepo vs Polyrepo
المستودع الواحد Monorepo يعني أن كود أكثر من مشروع يعيش في مستودع Git واحد: كل خدمة في مجلد، والمكتبات المشتركة في مجلد آخر، وتاريخ واحد يجمع الكل، وكل Commit يمكن أن يلمس أكثر من مشروع في الوقت نفسه. والمستودعات المتعددة Polyrepo، ويسميها البعض Multi-repo، تعني أن لكل مشروع مستودعه وتاريخه وصلاحياته وخط CI الخاص به، وما يشترك فيه المشروعان، مثل مكتبة، يصبح مستودعاً ثالثاً تنشر منه إصدارات، وكل مشروع يختار الإصدار الذي يستخدمه. والتعريفان بسيطان، ولكن كل الفرق العملي يأتي من نقطة واحدة: في Monorepo يرى كل مشروع النسخة الحالية من كل ما يعتمد عليه دائماً، وفي Polyrepo يرى كل مشروع النسخة التي اختارها، حتى لو كانت قديمة.
Monorepo ليس Monolith
هذا خلط شائع يجعل النقاش كله يدور في المكان الخطأ. الMonolith طريقة لبناء البرنامج ونشره: برنامج واحد يبنى وينشر كقطعة واحدة. والMicroservices طريقة أخرى: خدمات صغيرة تنشر كل منها وحدها. أما Monorepo وPolyrepo فطريقة لتخزين الكود فقط. والمحوران مستقلان تماماً: تستطيع أن تضع عشرين خدمة صغيرة تنشر كل منها وحدها في مستودع واحد، وهذا ما تفعله Google، وتستطيع أن تقسم Monolith واحداً على عدة مستودعات لمكتبات يجمعها عند البناء، وهذا أقل شيوعاً ولكنه موجود. لذلك عندما يقول أحدهم «سوف نتحول إلى Microservices، فلنقسم المستودع»، فالجزء الثاني ليس نتيجة للأول، وإنما قرار آخر يحتاج أسبابه الخاصة. وقد شرحنا الفرق بين أشكال بناء البرنامج في مدخل إلى تصميم الأنظمة.

من أين جاءت الفكرة؟ History
المستودع الواحد ليس فكرة جديدة، فأغلب المشاريع تبدأ هكذا لأنه الشكل الطبيعي لأي مشروع صغير. والجديد أن شركات كبيرة اختارته عن قصد وهي في حجم ضخم. وأشهر مثال موثق Google، التي نشر مهندساها Rachel Potvin وJosh Levenberg في 2016 مقالاً في مجلة Communications of the ACM بعنوان لماذا تخزن Google مليارات الأسطر من الكود في مستودع واحد، يصفان فيه مستودعاً واحداً يعمل عليه عشرات الآلاف من المطورين حول العالم كمصدر واحد للحقيقة، ونظام تخزين بنته Google بنفسها لهذا الغرض، والمزايا والمقايضات التي رأتها. والنقطة التي تهمنا هنا أن Google لم تستخدم Git لهذا، وإنما بنت أدواتها.
وFacebook واجهت المشكلة نفسها من جهة الأداة. ففي مقال هندسي من 2014 شرح فريقها أن مستودعهم أصبح أكبر بمرات من نواة Linux، التي كان فيها وقتها 17 مليون سطر و44 ألف ملف، وأن Git يفحص كل ملف فيصبح أبطأ كلما زاد عدد الملفات، فاختاروا أن يطوروا Mercurial بدلاً من Git، وبعد إضافاتهم أصبح أمر status أسرع من نظيره في Git بأكثر من خمس مرات، وأصبح الاستنساخ والسحب أسرع عشر مرات. والدرس من القصتين أن Monorepo في حجم الشركات الكبيرة يحتاج أدوات خاصة، وأن من يقلد Google يجب أن يتذكر أن Google لم تستخدم ما يستخدمه هو.
أما المستودعات المتعددة فانتشرت مع منصات استضافة الكود التي جعلت إنشاء مستودع أمراً يأخذ ثوان، ومع موجة Microservices التي ربطت في أذهان كثيرين بين «خدمة مستقلة» و«مستودع مستقل»، ومع أدوات إدارة الحزم التي تجعل نشر مكتبة داخلية واستخدامها بإصدار محدد سهلاً. وبين الشكلين ظهرت أدوات بناء تجعل المستودع الواحد عملياً في الحجم المتوسط، مثل Bazel الذي نشرته Google من أدواتها الداخلية، وNx وTurborepo في عالم JavaScript، وسوف نرى بعد قليل لماذا نحتاج هذه الأدوات.
تجهيز المختبر Lab Setup
نحتاج سيرفر Gitea وGitea Runner ينفذ خطوط CI، وجهاز مطور:
docker network create dv2g-net
docker run -d --name dv2g-gitea --network dv2g-net -p 3483:3000 \
-e GITEA__security__INSTALL_LOCK=true \
-e GITEA__server__ROOT_URL=http://dv2g-gitea:3000/ \
-e GITEA__database__DB_TYPE=sqlite3 \
-e GITEA__service__DISABLE_REGISTRATION=true \
-v dv2g-gitea-data:/data gitea/gitea:28.3.0
docker exec -u git dv2g-gitea gitea admin user create --admin --username team --password 'Lab-Pass-2026!' \
--email [email protected] --must-change-password=false
TOKEN=$(docker exec -u git dv2g-gitea gitea actions generate-runner-token)
docker run -d --name dv2g-runner --network dv2g-net \
-e GITEA_INSTANCE_URL=http://dv2g-gitea:3000/ -e GITEA_RUNNER_REGISTRATION_TOKEN=$TOKEN \
-e GITEA_RUNNER_NAME=runner-01 -e CONFIG_FILE=/config/config.yaml \
-v "$(pwd)/config.yaml:/config/config.yaml:ro" gitea/runner:4.1.0
docker exec dv2g-runner apk add --no-cache python3وملف إعداد ال Runner فيه سطر واحد مهم:
runner:
capacity: 2
timeout: 10m
labels:
- "host:host"الLabel host:host يعني أن المهام تعمل مباشرة داخل Container ال Runner نفسه، دون أن ينشئ Container لكل مهمة، ولهذا أضفنا إليه Python 3. واخترنا هذا الوضع لأن المختبر يقيس عدد خطوط CI التي تعمل في كل شكل، ولا يحتاج عزل المهام. ولا تقم بذلك في الإنتاج، لأن أي Workflow يستطيع أن يعدل بيئة ال Runner لكل المهام بعده، واستخدم الأنواع المعزولة التي شرحناها في Gitea Actions. وكل الأوامر في مجلد lab مع المقال، والكود Python صغير عن قصد: مكتبة money فيها دالتان، الأولى تحول الريال إلى هللات، والثانية تكتب المبلغ مع العملة، وخدمة orders تحسب مجموع الفاتورة بها، وخدمة catalog تصنع أسماء الروابط للمنتجات، ولكل واحد اختبارات unittest.
المستودع الواحد في CI: Monorepo
شكل المستودع Repository Layout
هذا هو المستودع shop بعد أول Commit:
find . -path ./.git -prune -o -type f -print | sortوالمخرج سوف يكون كما يلي:
./.gitea/workflows/catalog.yml
./.gitea/workflows/money.yml
./.gitea/workflows/orders.yml
./.gitignore
./README.md
./libs/money/money.py
./libs/money/test_money.py
./services/catalog/catalog.py
./services/catalog/test_catalog.py
./services/orders/orders.py
./services/orders/test_orders.pyثلاثة مشاريع في ثلاثة مجلدات، ولكل مشروع ملف Workflow خاص به. وهذا ملف خدمة الطلبات:
name: orders
on:
push:
paths:
- 'services/orders/**'
- 'libs/money/**'
jobs:
test:
runs-on: host
steps:
- name: checkout
run: git clone -q ${{ gitea.server_url }}/${{ gitea.repository }} src && git -C src checkout -q ${{ gitea.sha }}
- name: unit tests
run: cd src/services/orders && python3 -m unittest -vفي الإعداد أعلاه لاحظ التالي:
pathsتحتpushهو مرشح المسارات Path Filter: الخط يعمل فقط إذا لمس الدفع ملفاً يطابق أحد الأنماط. وGitea Actions يتبع صيغة GitHub Actions هنا، وهي موثقة في مرجع صيغة ال Workflows، ويذكر Gitea الفروق بينهما في صفحة المقارنة.- الطلبات تعتمد على المكتبة، لذلك كتبنا مجلد المكتبة في مرشحها أيضاً. وهذا السطر الثاني هو أهم سطر في المستودع كله، وسوف نرى ماذا يحدث عندما ينسى.
- خطوة checkout تستنسخ المستودع عند ال Commit الذي دفع بالضبط، لأن وضع host لا يحمل أداة
actions/checkoutالتي تحتاج Node. - الطلبات تستورد المكتبة من المجلد المجاور مباشرة، فلا يوجد «إصدار» للمكتبة أصلاً، والطلبات ترى دائماً آخر نسخة منها في ال Commit نفسه.
من يعمل مع كل دفع؟ Path Filters
دفعنا ثلاث مرات، وبعد كل دفع سألنا Gitea API عن خطوط CI التي بدأت لهذا ال Commit، وانتظرنا حتى تنتهي، بدالة صغيرة اسمها runs في ملف المختبر:
runs for shop@d1214c1: 3
catalog.yml success 1s
money.yml success 2s
orders.yml success 2s
runs for shop@516a5d8: 1
catalog.yml success 2s
runs for shop@57cfd2b: 0الدفع الأول أضاف كل الملفات، فعملت الخطوط الثلاثة. والثاني أصلح دالة أسماء الروابط في الكتالوج وحده، فعمل خط الكتالوج وحده. والثالث غير README فقط، فلم يعمل شيء، لأنه لا يطابق أي مرشح. وهذا هو الوعد الأول للمرشحات: المستودع الواحد لا يعني أن كل تعديل يختبر كل شيء. ولاحظ أن الأوقات هنا ثوان، لأن الاختبارات صغيرة، والرقم الذي يهمنا هو عدد الخطوط، فلو كانت اختبارات الطلبات تأخذ عشر دقائق في مشروع حقيقي، لكان الفرق بين خط وثلاثة خطوط فرقاً حقيقياً في وقت الفريق.
تغيير غير متوافق بخطوة واحدة Atomic Change
الآن الموقف الذي يميز المستودع الواحد. قرر الفريق أن الدالة format_sar يجب أن تصبح format_amount وتأخذ العملة، لأن المتجر سوف يبيع بالدولار أيضاً. وهذا تغيير غير متوافق Breaking Change: كل من يستدعي الاسم القديم سوف يفشل. ففي Commit واحد غيرنا المكتبة واختباراتها وخدمة الطلبات التي تستدعيها:
git diff --statوالمخرج سوف يكون كما يلي، ثم نتيجة الدفع:
libs/money/money.py | 4 ++--
libs/money/test_money.py | 4 ++--
services/orders/orders.py | 4 ++--
3 files changed, 6 insertions(+), 6 deletions(-)
runs for shop@86cf488: 2
money.yml success 3s
orders.yml success 3sتغيير واحد، في Commit واحد، يراجع في طلب دمج واحد، واختبر المكتبة والخدمة التي تستخدمها معاً قبل أن يدخل main. ولا توجد لحظة يكون فيها main في حالة نصفها جديد ونصفها قديم. وهذا ما يسمى التغيير الذري Atomic Change، وهو أقوى حجة للمستودع الواحد: من يغير واجهة مشتركة يرى فوراً كل من يستخدمها، ويصلحهم بنفسه، ويتحمل تكلفة تغييره. ولاحظ أن خط الكتالوج لم يعمل، لأن الكتالوج حتى هذه اللحظة لا يستخدم المكتبة.
ماذا لو نسي المرشح خدمة؟ What If: Stale Path Filter
بعد أسبوع أضاف مطور إلى الكتالوج دالة تكتب سعر المنتج، واستخدم فيها format_amount من المكتبة. وهذا قرار طبيعي تماماً، فالمكتبة المشتركة موجودة لهذا. ولكنه لم يغير ملف catalog.yml، لأنه لم يفكر فيه أصلاً. ودفع، فعمل خط الكتالوج ونجح. ثم بعد يومين قرر صاحب المكتبة أن تصبح العملة إجبارية، وأصلح الطلبات معها كما في القسم السابق، ودفع:
runs for shop@a4f5074: 1
catalog.yml success 2s
runs for shop@0afb71a: 2
money.yml success 2s
orders.yml success 2sخطان أخضران، وطلب الدمج يبدو سليماً تماماً، ودخل main. ثم شغلنا اختبارات الكتالوج بأيدينا على ال Commit نفسه:
cd services/catalog && python3 -m unittestوالمخرج سوف يكون كما يلي، مع سطر الخطأ من التفاصيل:
TypeError: format_amount() missing 1 required positional argument: 'currency'
----------------------------------------------------------------------
Ran 2 tests in 0.001s
FAILED (errors=1)main معطوب، والكتالوج سوف يفشل عند أول نشر، ولم يقل CI شيئاً. والسبب أن مرشح المسارات نسخة يدوية من خريطة الاعتماديات Dependency Graph، والخريطة الحقيقية في الكود تغيرت، والنسخة اليدوية لم تتغير. وهذا هو الوجه الآخر للوعد الأول: المرشحات توفر الوقت، ولكنها تفترض أن من يكتبها يعرف كل اعتماد، وأن كل مطور يضيف اعتماداً يتذكر أن يحدثها. وفي مستودع فيه ثلاثون خدمة وعشر مكتبات، هذا لا يحدث. أصلحنا الكتالوج، وأضفنا المكتبة إلى مرشحه:
git diff --statوالمخرج سوف يكون كما يلي:
.gitea/workflows/catalog.yml | 1 +
services/catalog/catalog.py | 2 +-
2 files changed, 2 insertions(+), 1 deletion(-)والحل الدائم ليس أن تتذكر أكثر، وإنما أن تجعل الأداة تعرف الاعتماديات من الكود نفسه. وهذا بالضبط ما تفعله أدوات البناء للمستودع الواحد، مثل Bazel وNx وTurborepo: كل مشروع يعلن ما يعتمد عليه في ملف بناء، أو تستنتجه الأداة من الاستيرادات، ثم تحسب الأداة عند كل تغيير المشاريع المتأثرة فقط، وتختبرها كلها. وفي فريق صغير بعدد قليل من الخدمات يكفي حل أبسط: اجعل خط CI ليلياً يختبر كل شيء دون مرشحات، فيكتشف ما فات المرشحات خلال يوم، بدلاً من أن يكتشفه العميل.

خط كامل كل ليلة Nightly Full Run
الحل البسيط الذي ذكرناه يستحق أن نكتبه، لأنه أرخص شبكة أمان للمستودع الواحد. ملف Workflow إضافي دون مرشحات، يعمل بجدول زمني بدلاً من الدفع، ويختبر كل مشروع في المستودع:
name: nightly
on:
schedule:
- cron: '0 1 * * *'
jobs:
test:
runs-on: host
strategy:
matrix:
dir: [libs/money, services/orders, services/catalog]
steps:
- name: checkout
run: git clone -q ${{ gitea.server_url }}/${{ gitea.repository }} src
- name: unit tests
run: cd src/${{ matrix.dir }} && python3 -m unittest -vالحدث schedule مع تعبير cron يجعل الخط يبدأ في الواحدة بعد منتصف الليل بتوقيت السيرفر، والمصفوفة matrix تنشئ مهمة لكل مجلد، فتظهر نتيجة كل مشروع وحدها. وهذا الخط لا يمنع main من أن يتعطل، ولكنه يجعل مدة العطل يوماً على الأكثر بدلاً من «حتى يلاحظ أحدهم». وإذا فشل فالخطوة التالية ليست إصلاح الكود فقط، وإنما أن تسأل لماذا لم يكتشفه خط الدفع، فغالباً ستجد مرشحاً ينقصه سطر، كما وجدنا.
جزء من المستودع فقط Sparse Checkout
اعتراض شائع على المستودع الواحد: «لماذا يستنسخ مطور الكتالوج كود كل الفريق؟». وGit نفسه يقدم جواباً: الاستنساخ الجزئي Partial Clone الذي لا ينزل محتوى الملفات إلا عند الحاجة، مع git sparse-checkout الذي يجعل مجلد العمل يحوي المجلدات التي تختارها فقط:
git clone -q --filter=blob:none --sparse http://dv2g-gitea:3000/team/shop.git catalog-only
git -C catalog-only sparse-checkout set services/catalog libs/money
(cd catalog-only && find . -path ./.git -prune -o -type f -print | sort)
du -sh /work/shop/.git /work/catalog-only/.gitوالمخرج سوف يكون كما يلي:
./.gitignore
./README.md
./libs/money/money.py
./libs/money/test_money.py
./services/catalog/catalog.py
./services/catalog/test_catalog.py
608.0K /work/shop/.git
212.0K /work/catalog-only/.gitفي المخرج أعلاه لاحظ التالي:
--filter=blob:noneيطلب من السيرفر كل ال Commits والأشجار دون محتوى الملفات Blobs، فينزلها Git عند الحاجة فقط، كما في توثيق Partial Clone. والسيرفر يجب أن يدعم ذلك، وGitea يدعمه.--sparseيبدأ بملفات الجذر فقط، ولهذا ظهر README و.gitignore، ثمsparse-checkout setيضيف المجلدين المطلوبين، فلا يظهر مجلد الطلبات أبداً.- حجم المجلد
.gitصار نحو الثلث. والرقم صغير في مستودعنا، ولكن النسبة هي ما يهم في مستودع حجمه عشرات الجيجابايت.
ولكن لاحظ ما لا يفعله: التاريخ كله ما زال موجوداً، وأي أمر يحتاج ملفات قديمة، مثل git log -p على مجلد آخر، سوف ينزلها من السيرفر عند الطلب. وsparse-checkout ليس صلاحية، فالمطور يستطيع أن يضيف أي مجلد في أي وقت. وهذا يقودنا إلى نقطة الصلاحيات التي سوف نعود إليها.
المستودعات المتعددة في CI: Polyrepo
ثلاثة مستودعات وإصدار مثبت Pinned Versions
الآن نبني الكود نفسه بالشكل الآخر: مستودع money للمكتبة، ومستودع orders، ومستودع catalog. ووضعنا على المكتبة الوسم v1.0.0، وفي كل خدمة ملفاً صغيراً اسمه MONEY_VERSION فيه الإصدار الذي تستخدمه. وفي مشروع حقيقي يكون هذا سطراً في ملف الاعتماديات، مثل requirements.txt أو package.json، والمكتبة تنشر في سجل حزم مثل سجل الحزم في Gitea، أما في المختبر فنستنسخ المكتبة عند الوسم مباشرة، والفكرة نفسها. وهذا خط CI لخدمة الطلبات:
name: ci
on:
push:
branches: [main]
jobs:
test:
runs-on: host
steps:
- name: checkout
run: git clone -q ${{ gitea.server_url }}/${{ gitea.repository }} src && git -C src checkout -q ${{ gitea.sha }}
- name: money at the pinned version
run: git -c advice.detachedHead=false clone -q --branch "$(cat src/MONEY_VERSION)" ${{ gitea.server_url }}/team/money deps/money
- name: unit tests
run: cd src && PYTHONPATH=../deps/money python3 -m unittest -vلا توجد مرشحات مسارات هنا، لأن كل مستودع مشروع واحد، فكل دفع إليه يخصه. والخطوة الثانية تجلب المكتبة بالإصدار المكتوب في الملف، وPYTHONPATH يجعل Python يجدها. وأول دفع لكل مستودع شغل خطه، والثلاثة نجحت:
runs for money@24cbd30: 1
ci.yml success 3s
runs for orders@dee8853: 1
ci.yml success 4s
runs for catalog@73d8bca: 1
ci.yml success 3sولاحظ أن الكتالوج هنا يستخدم المكتبة من البداية، كما انتهى إليه في المستودع الواحد، فلا توجد مرشحات ينساها أحد، لأن الاعتماد مكتوب صراحة في ملف MONEY_VERSION. وهذه أول ميزة حقيقية للمستودعات المتعددة: الاعتماد بين المشاريع ظاهر ومكتوب ومثبت بإصدار.
الإصدار v2.0.0 لا يختبر من يستخدمه Breaking Change
التغيير غير المتوافق نفسه: format_sar تصبح format_amount(halalas, currency). في مستودع المكتبة فقط، مع وسم v2.0.0، لأن رقم MAJOR يزيد مع كل تغيير غير متوافق بحسب SemVer:
runs for money@5e65c5d: 1
ci.yml success 1s
orders: dee8853 success
catalog: 73d8bca successخط المكتبة نجح، لأن اختباراتها تغيرت معها. وآخر نتيجة في الخدمتين ما زالت خضراء، لأن أحداً لم يدفع إليهما، ولأنهما تستخدمان v1.0.0 الذي لم يتغير. وهذا سلوك صحيح ومقصود: صاحب المكتبة يستطيع أن يتقدم دون أن ينتظر أحداً، والخدمات لا تتعطل فجأة بسبب تغيير لم تطلبه. ولكن انتبه إلى ما حدث فعلاً: صاحب التغيير لا يعرف أن الطلبات سوف تفشل مع إصداره، ولا أحد اختبر v2.0.0 مع أي خدمة. فالتكلفة لم تختف، وإنما انتقلت من صاحب التغيير إلى صاحب كل خدمة، ومن اليوم إلى يوم في المستقبل يقرر فيه أحدهم رفع الإصدار.
رفع الإصدار في orders Version Bump
بعد أسبوعين احتاجت الطلبات ميزة في v2.0.0، فغير صاحبها السطر في MONEY_VERSION ودفع:
runs for orders@d8b6773: 1
ci.yml failure 1sوطلبنا خطوات المهمة من Gitea API، ثم سجلها:
0 checkout success
1 money at the pinned version success
2 unit tests failure
ImportError: Failed to import test module: test_orders
...
File "/root/.cache/act/a6a8a46455fb07ad/hostexecutor/src/orders.py", line 1, in <module>
from money import to_halalas, format_sar
ImportError: cannot import name 'format_sar' from 'money' (/root/.cache/act/a6a8a46455fb07ad/hostexecutor/deps/money/money.py)الخطأ واضح: الاسم القديم غير موجود في الإصدار الجديد. ولاحظ المسار deps/money في آخر سطر، فهو يثبت أن الاختبار استخدم الإصدار المثبت وليس شيئاً آخر. فأصلح صاحب الطلبات الاستدعاء في Commit ثان، ودفع، فنجح. والنتيجة: التغيير الذي احتاج في المستودع الواحد Commit واحداً ودفعاً واحداً، احتاج هنا ثلاثة Commits في مستودعين، ووسماً، وثلاثة خطوط CI، أحدها فشل، وأسبوعين بين التغيير ومعرفة أثره. والأهم أن من أصلح الطلبات ليس من غير المكتبة، فهو يقرأ تغييراً كتبه غيره ليفهم ماذا يجب أن يغير، وإذا كان سجل التغييرات في المكتبة جيداً فهذا سهل، وإذا لم يكن فهذا يوم ضائع.
انحراف الإصدارات Version Skew
بعد كل هذا سألنا كل خدمة عن الإصدار الذي تستخدمه:
for r in orders catalog; do echo "$r -> money $(cat /work/poly/$r/MONEY_VERSION)"; doneوالمخرج سوف يكون كما يلي:
orders -> money v2.0.0
catalog -> money v1.0.0خدمتان، وإصداران مختلفان من المكتبة نفسها يعملان في الإنتاج في الوقت نفسه. وهذا ما يسمى انحراف الإصدارات Version Skew. ومع ثلاث خدمات هو مجرد سطر في جدول، ومع عشرين خدمة وخمس مكتبات يصبح سؤالاً لا يعرف أحد جوابه دون سكربت: من يستخدم أي إصدار من أي مكتبة؟ والانحراف ليس خطأ في ذاته، فهو ثمن الاستقلالية، ولكن له تكلفة سوف نراها في القسم التالي بوضوح.
وللانحراف وجه أخطر عندما تصبح الخدمات نفسها مكتبات. تخيل أن الطلبات والكتالوج ليسا خدمتين، وإنما مكتبتين تستخدمهما خدمة ثالثة في البرنامج نفسه، والأولى تطلب money v2 والثانية money v1. في Python، كما في أغلب اللغات، لا يستطيع البرنامج الواحد أن يحمل إصدارين من الحزمة نفسها في الوقت نفسه، فإما أن يفشل التثبيت لأن المتطلبات متعارضة، وإما أن يعمل أحدهما بإصدار لم يختبر معه. وهذه المشكلة معروفة باسم اعتماد الماسة Diamond Dependency، لأن رسم الاعتماديات يشبه الماسة: خدمة في الأعلى، ومكتبتان في الوسط، ومكتبة مشتركة في الأسفل. وفي المستودع الواحد لا توجد هذه المشكلة أصلاً، لأنه لا يوجد إلا إصدار واحد من كل شيء، وهو ما في ال Commit الحالي، وهذا من أسباب اختيار Google للمستودع الواحد كما يذكر مقالها.
تحديث الإصدارات آلياً Dependency Updates
الطريقة العملية لتقليل الانحراف في المستودعات المتعددة أن لا تترك رفع الإصدار لذاكرة الناس. أدوات مثل Renovate، الذي يدعم Gitea، تفحص ملفات الاعتماديات في كل مستودع، وعندما يصدر إصدار جديد من مكتبة تفتح طلب دمج يرفع الإصدار، فيعمل خط CI على الطلب، فإذا نجح دمجه صاحب الخدمة في دقيقة، وإذا فشل عرف فوراً أن التغيير يحتاج عملاً، بدلاً من أن يكتشفه بعد أسبوعين كما حدث للطلبات. وبهذا تقترب المستودعات المتعددة من سلوك المستودع الواحد في نقطة واحدة: أثر التغيير يظهر بسرعة. ولكنه يظهر لصاحب الخدمة وليس لصاحب التغيير، وما زال الإصلاح Commit منفصلاً في كل مستودع. وتذكر أن هذه الأداة تحتاج حساباً ورمز وصول بصلاحيات على كل المستودعات، فعامله كأي حساب آلي له صلاحيات واسعة.

إصلاح خطأ في المكتبة المشتركة What If: Bug Fix Everywhere
التغيير غير المتوافق تستطيع أن تؤجله. أما الخطأ في المكتبة المشتركة فيجب أن يصل إصلاحه إلى كل خدمة. واكتشف الفريق خطأ تقريب في تحويل الريال إلى هللات:
python3 -c "print(0.285 * 100, round(0.285 * 100))"والمخرج سوف يكون كما يلي:
28.499999999999996 28المبلغ 0.285 ريال يجب أن يصبح 29 هللة بالتقريب المعتاد، ولكن الحاسب يخزن 0.285 كعدد عشري ثنائي Floating Point أقل قليلاً منها، فيصبح الضرب في 100 أقل من 28.5، فيقرب إلى 28. وقد شرحنا لماذا يحدث هذا في الأرقام العشرية Floating Point من الداخل. والإصلاح أن نحسب بالنوع Decimal من النص مع تقريب النصف إلى الأعلى، ومع اختبار جديد للمبلغ 0.285.
في المستودع الواحد: Commit واحد غير المكتبة واختبارها، ودفع واحد:
libs/money/money.py | 5 ++++-
libs/money/test_money.py | 3 +++
2 files changed, 7 insertions(+), 1 deletion(-)
runs for shop@3da6a82: 3
catalog.yml success 2s
money.yml success 2s
orders.yml success 1sثلاثة خطوط، لأن مرشحي الطلبات والكتالوج يشملان المكتبة الآن، فاختبرت الخدمتان مع الإصلاح قبل أن يدخل main، ومع أول نشر لكل خدمة يصل الإصلاح إليها.
وفي المستودعات المتعددة: أصلحنا المكتبة على main، ووسمناها v2.0.1، ورفعت الطلبات إصدارها إليه، والخطان نجحا. ولكن الكتالوج ما زال على v1.0.0، ولا يستطيع أن ينتقل إلى v2 اليوم، لأن ذلك يعني أن يغير استدعاءاته أيضاً، وهذا ليس ما يريده أحد في يوم إصلاح خطأ في المال. فيجب أن نصدر v1.0.1 من فرع إصدار يخرج من v1.0.0، وننقل الإصلاح إليه بالانتقاء Cherry-pick:
git switch -q -c release/1.0 v1.0.0 && git cherry-pick -x main
git status --shortوالمخرج سوف يكون كما يلي:
Auto-merging money.py
Auto-merging test_money.py
CONFLICT (content): Merge conflict in test_money.py
M money.py
UU test_money.pyتعارض في ملف الاختبار. والسبب ظاهر في الفرق:
++<<<<<<< HEAD
+ self.assertEqual(format_sar(1250), "12.50 SAR")
++=======
+ self.assertEqual(format_amount(1250, "SAR"), "12.50 SAR")
+
+ def test_half_halala(self):
+ self.assertEqual(to_halalas(0.285), 29)
++>>>>>>> c7c17bb (fix: round half up with Decimal)الإصلاح على main كتب اختباره في ملف تغير فيه اسم الدالة في v2، فالسياق الذي يتوقعه غير موجود في v1. فأخذنا نسخة الفرع من الملف، وأضفنا الاختبار الجديد وحده بأيدينا، وشغلنا الاختبارات فنجحت، وأكملنا الانتقاء، ووسمنا v1.0.1، ثم رفع الكتالوج إصداره إليه. وهذا بالضبط ما شرحناه في Cherry-pick مع git bisect: كلما ابتعد فرع الإصدار عن main زادت فرصة التعارض. وانتبه إلى شيء آخر لم ننتبه له إلا بعد التجربة: خط CI في مستودع المكتبة يعمل على main فقط، كما كتبناه في branches: [main]، فالإصدار v1.0.1 نفسه لم يختبره CI أبداً، والاختبار الوحيد كان تشغيلنا اليدوي قبل إكمال الانتقاء. وفي فريق يدعم أكثر من إصدار للمكتبة، يجب أن يشمل CI فروع الإصدار أيضاً.

المقارنة بأرقام المختبر Lab Numbers
الجدول التالي يجمع ما عددناه في المختبر للموقفين، دون الدفعات الأولى التي أنشأت المستودعات:
| الموقف | Monorepo | Polyrepo |
|---|---|---|
| تعديل في الكتالوج وحده | Commit واحد، خط واحد | Commit واحد، خط واحد |
| تغيير غير متوافق في المكتبة | Commit واحد، خطان، والخدمة المتأثرة أصلحت في الوقت نفسه | 3 Commits في مستودعين، ووسم، و3 خطوط أحدها فشل، والكتالوج بقي على v1 |
| خطأ تقريب يجب أن يصل للجميع | Commit واحد، 3 خطوط | 4 Commits في 3 مستودعات، ووسمان، وفرع إصدار، وتعارض، و3 خطوط، وإصدار v1.0.1 دون CI |
| اعتماد جديد بين مشروعين | يجب تحديث مرشح المسارات، وإلا يفوت الاختبار | مكتوب صراحة في ملف الإصدار |
| من يعرف أثر التغيير | صاحب التغيير، قبل الدمج | صاحب كل خدمة، عندما يرفع الإصدار |
والقراءة الصحيحة لهذا الجدول ليست «المستودع الواحد أفضل». فالأرقام تقيس شيئاً واحداً: تكلفة التغيير الذي يعبر بين مشروعين. وإذا كانت مشاريعك نادراً ما تتغير معاً، فهذه التكلفة نادرة، وتصبح مزايا المستودعات المتعددة، مثل الاستقلالية والصلاحيات والسرعة، أهم. وإذا كانت تتغير معاً كل أسبوع، كما في فريق صغير يملك المكتبة والخدمات معاً، فهذه التكلفة يومية.

المقايضات الحقيقية Trade-offs
المختبر قاس جانباً واحداً، وفي القرار جوانب أخرى لا تظهر في خط CI صغير. وهذه أهمها، بالترتيب الذي نراه يحسم القرار في الفرق الصغيرة والمتوسطة.
الصلاحيات Access Control
في Git لا توجد صلاحية قراءة لمجلد داخل مستودع: من يستطيع أن يستنسخ المستودع يرى كل ما فيه وكل تاريخه. فإذا كان عندك كود لا يجب أن يراه كل الفريق، مثل خدمة تخص عميلاً بعقد سرية، أو كود يعمل عليه متعاقد خارجي يجب أن يرى جزءه فقط، فالمستودع المستقل هو الطريقة الوحيدة في Gitea لفصله. أما صلاحية الكتابة والمراجعة على مستوى المجلد فممكنة في المستودع الواحد: ملف CODEOWNERS في Gitea يربط كل مسار بمن يملكه، فيطلب Gitea مراجعتهم تلقائياً في كل طلب دمج يلمس ملفاتهم، وإذا فعلت ذلك في حماية الفرع لا يدمج الطلب حتى يوافق صاحب كل مسار. مثلاً:
libs/money/.* @team/payments
services/catalog/.* @team/catalogولاحظ أن الأنماط في Gitea تعابير منتظمة بصيغة Go، وليست أنماط Glob كما في paths، فالنقطة مع النجمة تعني أي شيء. وبهذا يحصل فريق المال على حق الموافقة على كل تغيير في مكتبته، حتى لو جاء من فريق آخر يصلح استدعاءاته، وهذا ما يجعل التغيير الذري ممكناً دون أن يفقد أحد ملكيته.
وللصلاحيات وجه آخر يغفل عنه كثيرون: أسرار خطوط CI. ففي Gitea Actions تعرف الأسرار Secrets على مستوى المستودع أو المنظمة أو المستخدم، كما في توثيق الأسرار، ولا توجد أسرار لمجلد داخل المستودع. فإذا كان مفتاح النشر لخدمة الطلبات سراً في المستودع الواحد، فأي Workflow في المستودع يستطيع أن يقرأه، ومنها خط الكتالوج، وأي مطور يستطيع أن يعدل ملف Workflow ويطبعه أو يرسله. وفي المستودعات المتعددة يبقى سر الطلبات في مستودعها فقط. لذلك إذا اخترت المستودع الواحد فلا تضع أسرار النشر الحساسة في المستودع نفسه، واجعلها في مستودع نشر منفصل أو منظمة منفصلة يتحكم فيها فريق التشغيل وحده، واحم ملفات .gitea/workflows بملف CODEOWNERS حتى لا يتغير أي منها دون موافقة من يملكها.
حجم المستودع وأداء Git Scale
Git سريع جداً في مستودع فيه بضعة آلاف من الملفات، وأغلب الفرق لن تقترب أبداً من الحجم الذي جعل Facebook تبحث عن بديل. ولكن المستودع الواحد يكبر بسرعة أكبر مما تتوقع، لأن كل مشروع جديد يضاف إليه، وكل ملف ثنائي يدخله أحدهم يبقى في التاريخ إلى الأبد. لذلك ضع قواعد مبكرة: لا ملفات ثنائية كبيرة في المستودع، واستخدم Git LFS أو سجل الحزم لها، واستخدم الاستنساخ الجزئي في خطوط CI، فخط الكتالوج لا يحتاج تاريخ كل شيء. والخبر الجيد أن ميزات مثل partial clone وsparse-checkout التي جربناها جاءت إلى Git نفسه، جزئياً بسبب ضغط المستودعات الكبيرة، فما كان يحتاج أدوات خاصة قبل عشر سنوات أصبح خيارات في الأمر git clone.
أدوات البناء Build Tools
رأينا أن مرشحات المسارات تعمل حتى تتغير الاعتماديات. ومع خمس خدمات تكفي المرشحات مع خط ليلي كامل. ومع ثلاثين تحتاج أداة تعرف خريطة الاعتماديات وتحسب ما تأثر، وتخزن نتائج البناء والاختبار السابقة Build Cache حتى لا تعيد ما لم يتغير. وهذا استثمار حقيقي: Bazel مثلاً يطلب أن تصف كل مشروع في ملفات BUILD بلغته، وهذا عمل أسابيع في مشروع قائم، وفريق يحتاج من يفهم الأداة. فإذا اخترت المستودع الواحد لفريق سوف يكبر، فاعرف أن هذا الاستثمار قادم، وقرر متى.
الإصدارات Releases
في المستودعات المتعددة لكل مشروع وسومه، وv2.0.1 يعني إصدار المكتبة دون لبس. وفي المستودع الواحد الوسم يخص المستودع كله، فإذا كانت كل خدمة تنشر وحدها تحتاج طريقة لتسمية إصداراتها، والشائع أن تضع اسم المشروع في الوسم، مثل orders/v1.4.0 وmoney/v2.0.1، وأن يبني خط النشر الخدمة التي يذكرها الوسم فقط. وتوليد سجل التغييرات لكل خدمة يحتاج أن تعرف الأداة أي Commits تخصها، وهذه الأدوات موجودة ولكنها إعداد إضافي. وقد شرحنا الإصدارات وسجل التغييرات في الإصدارات SemVer مع سجل التغييرات.
الملكية وطريقة عمل الفريق Ownership
المستودع الواحد يشجع على أن يصلح أي مطور أي مكان يحتاجه، وهذا رائع عندما يكون الفريق صغيراً ويعرف بعضه، ومزعج عندما يجد فريق المال أن خمسة فرق أخرى تعدل مكتبته كل أسبوع. والمستودعات المتعددة تشجع على حدود واضحة وواجهات مستقرة، وهذا رائع عندما تكون الفرق مستقلة فعلاً، ومزعج عندما يحتاج كل تغيير صغير اجتماعاً بين ثلاثة فرق. لذلك أفضل مؤشر لاختيار الشكل هو شكل الفريق نفسه: من يملك ماذا، ومن يغير ماذا مع من، وكم مرة.
الطريق الوسط Hybrid
أغلب الفرق لا تختار أحد الطرفين بشكل كامل. والترتيب الشائع: مستودع واحد للخدمات والمكتبات التي يملكها الفريق نفسه وتتغير معاً، ومستودعات مستقلة للأشياء التي لها حياة مستقلة فعلاً، مثل مكتبة مفتوحة المصدر يستخدمها آخرون، أو تطبيق جوال له دورة إصدار مختلفة تمر بالمتاجر، أو كود البنية التحتية الذي يملكه فريق آخر بصلاحيات أخرى.
وقد تسمع عن Git Submodules كطريقة تجمع المستودعات المتعددة في مستودع واحد: مستودع رئيسي يشير إلى Commit محدد في كل مستودع فرعي. ويبدو هذا أفضل ما في الشكلين، ولكنه في الواقع يحمل تعقيد الاثنين: المستودعات منفصلة فلا يوجد تغيير ذري، والإشارات إلى Commits يجب أن تحدث يدوياً، وكل مطور يجب أن يتذكر أوامر إضافية عند الاستنساخ والسحب. لذلك نقترح أن تستخدمه فقط عندما تحتاج كوداً خارجياً لا تملكه بإصدار ثابت، وليس لتنظيم كود فريقك.
علامات أن الشكل لم يعد يناسبك Warning Signs
القرار الذي كان صحيحاً لفريق من ثلاثة قد لا يبقى صحيحاً لفريق من ثلاثين، والعلامات تظهر في العمل اليومي قبل أن يقولها أحد في اجتماع. وهذه علامات أن المستودع الواحد أصبح عبئاً:
- خطوط CI على كل طلب دمج تأخذ أطول من وقت المراجعة نفسها، رغم المرشحات.
- main يتعطل أكثر من مرة في الشهر بسبب تغيير في مجلد لم يختبر معه مجلد آخر.
- أغلب طلبات الدمج تلمس مجلداً واحداً فقط، أي أن التغيير الذري الذي اخترت المستودع من أجله نادر.
- فريق يحتاج دورة إصدار مختلفة تماماً، مثل تطبيق جوال يمر بمراجعة المتاجر، ويتعطل بسبب قواعد بقية المستودع.
- تحتاج أن تخفي جزءاً من الكود عن بعض من يعمل في المستودع.
وهذه علامات أن المستودعات المتعددة أصبحت عبئاً:
- أغلب الميزات تحتاج طلبات دمج في أكثر من مستودع، تدمج بترتيب محدد، ومن ينسى الترتيب يعطل الإنتاج.
- جدول «من يستخدم أي إصدار» فيه إصدارات لم يعد أحد يصلح أخطاءها.
- مكتبة مشتركة صغيرة تأخذ إصداراتها وقتاً أطول من كتابة الكود نفسه.
- المطور الجديد يحتاج يوماً ليستنسخ ويربط خمسة مستودعات قبل أن يشغل خدمة واحدة.
وإذا رأيت ثلاث علامات من قائمة واحدة، فهذا وقت أن تعيد التجربة التي فعلناها في المختبر على تاريخك أنت، وأن تقرر بالأرقام.
كيف تقرر؟ Decision Table
| إذا كان عندك | فالأنسب غالباً | والسبب |
|---|---|---|
| فريق واحد صغير يملك كل الخدمات والمكتبات | Monorepo | التغييرات تعبر بين المشاريع كثيراً، والتغيير الذري يوفر أياماً |
| مكتبة مشتركة تتغير مع الخدمات كل أسبوع | Monorepo | كل تغيير فيها يختبر مع كل مستخدميها قبل الدمج |
| كود يجب ألا يراه كل الفريق | مستودع مستقل له | Git لا يعطي صلاحية قراءة لمجلد |
| فرق مستقلة بواجهات مستقرة ودورات إصدار مختلفة | Polyrepo | كل فريق يتقدم وحده، والتغيير العابر نادر |
| مكتبة يستخدمها آخرون خارج الفريق أو مفتوحة المصدر | مستودع مستقل لها | إصداراتها وعد لمستخدمين لا تستطيع أن تصلح كودهم |
| عشرات الخدمات في مستودع واحد | Monorepo مع أداة بناء | مرشحات المسارات اليدوية لا تكفي |

وفي فريق القصة، ستة مطورين يملكون المكتبة والخدمتين معاً، كان القرار المستودع الواحد، مع ملف CODEOWNERS لمكتبة المال، وخط ليلي يختبر كل شيء دون مرشحات، وقاعدة تقول إن كل اعتماد جديد بين مجلدين يضيف المجلد إلى مرشح الخدمة في Commit نفسه.
الانتقال بين الشكلين Migration
القرار ليس نهائياً، والانتقال في الاتجاهين ممكن مع الحفاظ على التاريخ. ومن المستودع الواحد إلى مستودع مستقل لمشروع واحد تستخدم أداة مثل git filter-repo لتستخرج تاريخ مجلد واحد وتجعله جذر مستودع جديد، فتبقى Commits ذلك المجلد برسائلها وكتابها. والعكس، جمع مستودعات في واحد، يتم غالباً بنقل ملفات كل مستودع إلى مجلده الخاص في تاريخه، ثم دمج التواريخ في المستودع الجديد. وفي الحالتين تتغير أرقام ال Commits، فخطط لتحديث الروابط إليها في التذاكر والوثائق، وتذكر أن التواقيع على ال Commits القديمة لن تبقى، لأن كل Commit يعاد كتابته يصبح كائناً جديداً لم يوقعه أحد.
أخطاء شائعة Common Mistakes
- الخلط بين Monorepo وMonolith: طريقة التخزين وطريقة النشر قراران منفصلان.
- تقليد Google دون أدواتها: المستودع الواحد في حجمها احتاج نظاماً خاصاً.
- مرشحات مسارات لا تتغير مع الكود: كما رأينا، main يتعطل وCI أخضر.
- Monorepo دون CODEOWNERS: فيعدل الجميع كل شيء دون موافقة من يملكه.
- Polyrepo دون سياسة رفع الإصدارات: فتبقى خدمات على إصدارات قديمة لا يصلح أحد أخطاءها.
- CI على main فقط في مكتبة لها فروع إصدار: فتنشر إصدارات إصلاح لم يختبرها أحد.
- Submodules لتنظيم كود الفريق: تعقيد الشكلين دون فائدة أي منهما.
- تقسيم المستودع لحل بطء الاختبارات: المرشحات وأدوات البناء تحل البطء دون أن تخسر التغيير الذري.
قائمة تحقق Checklist
- اكتب ما يتغير مع ماذا في آخر شهر: كم طلب دمج لمس أكثر من مشروع؟
- حدد الكود الذي يجب أن يبقى بصلاحيات منفصلة، وضعه في مستودع مستقل مهما كان القرار للباقي.
- في المستودع الواحد: مرشح مسارات لكل مشروع يشمل اعتمادياته، وخط ليلي كامل، وCODEOWNERS، وقاعدة للملفات الكبيرة.
- في المستودعات المتعددة: إصدارات SemVer مع سجل تغييرات، وCI على فروع الإصدار، وسكربت يعرض من يستخدم أي إصدار، وموعد لرفع الإصدارات.
- قرر متى تحتاج أداة بناء، قبل أن تحتاجها.
- جرب قرارك على موقف حقيقي من تاريخك، كما فعلنا في المختبر، قبل أن تنقل كل شيء.
ماذا تقرأ بعد ذلك؟ Next Steps
دليلGitea Actions: تشغيل CI/CD وبناء Docker Images على سيرفركاجعل سيرفرك يختبر الكود ويبني Docker Images تلقائياً مع كل push، دون أن يخرج كودك أو أسرارك إلى خدمة CI خارجية.
دليلTrunk-Based Development: فروع قصيرة ودمج يوميلماذا تنفجر الفروع الطويلة يوم الإصدار، وكيف يدمج الفريق عمله في main كل يوم بأمان مع CI وFeature Flags.
دليلالإصدارات SemVer مع سجل التغييرات Changelogكيف تعطي كل إصدار رقماً يعرف منه من يستخدم الكود هل الانتقال آمن، وتولد سجل التغييرات من رسائل Commits دون أن يضيع تغيير مهم.
دليلCherry-pick مع git bisect: نقل الإصلاح وإيجاد الخطأكيف تنقل إصلاحاً واحداً إلى الإصدار الذي يعمل عند العميل دون بقية التغييرات وتضع له وسماً، وكيف تجد الـ Commit الذي أدخل الخطأ بين عشرات الـ Commits في دقائق.المستودع الواحد يعمل أفضل مع فروع قصيرة تدمج في main كثيراً، وهذا ما نشرحه في التطوير على الفرع الرئيسي Trunk-Based. وإذا كنت تبني خطوط CI على سيرفرك فابدأ من مفهوم CI/CD للمبتدئين. والخريطة الكاملة لمقالات Git في Git في العمل اليومي.
الخلاصة Summary
- Monorepo وPolyrepo طريقتان لتخزين الكود، ولا علاقة لهما بطريقة النشر Monolith أو Microservices.
- في المستودع الواحد يرى كل مشروع آخر نسخة مما يعتمد عليه، فالتغيير غير المتوافق يتم في Commit واحد مع إصلاح كل مستخدميه.
- مرشحات المسارات تجعل CI يختبر ما تغير فقط، ولكنها نسخة يدوية من الاعتماديات، وفي المختبر تركت main معطوباً مع خطوط خضراء.
- في المستودعات المتعددة الاعتماد مكتوب ومثبت بإصدار، وصاحب المكتبة يتقدم وحده، والتكلفة تنتقل إلى كل مستخدم عندما يرفع الإصدار.
- إصلاح خطأ في مكتبة مشتركة احتاج Commit واحداً في المستودع الواحد، وأربعة Commits وتعارضاً في المستودعات المتعددة بسبب انحراف الإصدارات.
- الصلاحيات تحسم القرار للكود الذي يجب أن يبقى مخفياً، وشكل الفريق وملكيته يحسم الباقي.
سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال، وتنفيذ الشكلين على Gitea 28.3.0 مع Gitea Runner 4.1.0 بوضع host وPython 3.14، وgit 2.54.0 داخل Container من alpine:3.24.