Ring Promoter
CI/CD Orbit + Lanes — ہر ریلیز اپنی اہلیت سے پروڈکشن تک پہنچتی ہے
Ring Promoter، TenthMatrix کا پروڈکشن گریڈ پروموشن کنٹرول پلین ہے۔ v1.0.2 میں Orbit (فلیٹ ویو) اور Lanes (APP × INT/TEST/ACC/PROD میٹرکس) ساتھ ساتھ ہیں، جبکہ ورژنز ترتیب وار رِنگز — int → test → acc → prod — سے لائیو ہیلتھ گیٹس، آٹو رول بیک اور مکمل آڈٹ ٹریل کے ساتھ آگے بڑھتے ہیں۔
Ring Promoter کیا ہے؟
ایک چھوٹا کنٹرول پلین جو ایپلیکیشن ورژنز کو مشترکہ رِنگز سے آگے بڑھاتا ہے۔ یہ طویل مدتی سروس کے طور پر (عموماً k3s پر) چلتا ہے، JSON REST API اور ایمبیڈڈ ویب UI فراہم کرتا ہے، اور ہر (application, ring) کے لیے موجودہ/سابقہ ورژنز اور تاریخ ٹریک کرتا ہے۔ Kubernetes ایپس اور VM/CI ایپس ایک ہی سطح شیئر کرتی ہیں — ڈیپلائر ہر ایپ کے لیے منتخب کیا جاتا ہے۔
Watch the overview

دیکھیں: CI/CD Orbit + Lanes (v1.0.2)
v1.0.2 واک تھرو
YouTube پر دیکھیں: دیکھیں: CI/CD Orbit + Lanes (v1.0.2)
دیکھیں: Ring Promoter کا فوری تعارف (5 منٹ)
5 منٹ کا تعارف
YouTube پر دیکھیں: دیکھیں: Ring Promoter کا فوری تعارف (5 منٹ)
دیکھیں: پروڈکشن سے پہلے QA گیٹس
QA گیٹس
YouTube پر دیکھیں: دیکھیں: پروڈکشن سے پہلے QA گیٹس
دیکھیں: Ring Promoter ڈیمو
TenthMatrix ڈیمو
YouTube پر دیکھیں: دیکھیں: Ring Promoter ڈیمو
رِنگ پروموشن کیسے کام کرتا ہے
ہر ریلیز اپنی اہلیت سے پروڈکشن تک پہنچتی ہے۔ ایک وقت میں ایک قدم — کوئی رِنگ کبھی نہیں چھوڑی جاتی — پروموٹ سے پہلے ہیلتھ چیک اور ناکامی پر آٹو رول بیک کے ساتھ۔
int میں ایک ورژن سیڈ کریں
کسی ایپلیکیشن کے لیے Integration رِنگ میں ایک ورژن (امیج ٹیگ، برانچ یا ref) سیڈ کر کے پائپ لائن شروع کریں۔
ایک وقت میں ایک رِنگ پروموٹ کریں
promote {from_ring} ہمیشہ اگلی رِنگ کو ہدف بناتا ہے۔ آپ براہ راست int → prod نہیں جا سکتے۔ سورس رِنگ کا پہلے صحت مند ہونا ضروری ہے۔
درست ڈیپلائر کے ساتھ ڈیپلائے کریں
KubectlDeployer (set image + rollout)، GitHubActionsDeployer (VM/CI ایپس کے لیے workflow-dispatch)، یا k8sjob runner Jobs — ہر ایپلیکیشن کے لیے منتخب۔
ری ٹرائز کے ساتھ ہیلتھ چیک
ڈیپلائے کے بعد، قابلِ ترتیب ری ٹرائز کے ساتھ HTTP ہیلتھ چیکس چلتے ہیں۔ اختیاری ورژن تصدیق کے لیے اینڈ پوائنٹ کو ابھی ڈیپلائے ہوا عین ورژن بتانا ہوتا ہے۔
ناکامی پر آٹو رول بیک
اگر ہدف غیر صحت مند رہے تو Ring Promoter خود بخود پچھلے ورژن پر رول بیک کرتا ہے اور ناکامی کو تاریخ میں درج کرتا ہے۔
اختیاری آٹو پروموٹ
کسی رِنگ کو فلیگ کریں تاکہ صحت مند لینڈنگ اسی لاکڈ آپریشن میں آگے بڑھتی رہے — مثلاً test → acc آٹو پروموٹ کریں، مگر prod کے گیٹ پر انسانوں کو رکھیں۔
Integration
int
نئے بلڈز اور AI ایجنٹ / API تبدیلیوں کا پہلا پڑاؤ۔
Test
test
قبولیت سے پہلے خودکار تصدیق اور سوک۔
Acceptance
acc
اسٹیک ہولڈر / UAT گیٹ — اکثر آخری آٹو پروموٹ پڑاؤ۔
Production
prod
لائیو ٹریفک — کنفیگر ہونے پر آخری رِنگ پاس ورڈ سے محفوظ۔
AI دور کے CI/CD کے لیے ٹیمیں Ring Promoter کیوں چنتی ہیں
AI پروڈکٹس تیزی سے بدلتی ہیں — ماڈلز، ایجنٹس، MCP ٹولز، گیٹ ویز۔ Ring Promoter ڈیلیوری روکے بغیر پروموشنز کو منظم رکھتا ہے۔
ترتیب وار رِنگز، کوئی چھلانگ نہیں
مشترکہ پائپ لائن int → test → acc → prod۔ نئی رِنگ شامل کرنا ring پیکیج میں ایک ہی جگہ کی تبدیلی ہے — ایپس ہر رِنگ میں اپنی جگہ config میں بتاتی ہیں، کوڈ میں نہیں۔
ہیلتھ گیٹڈ پروموشن
پروموٹ سے پہلے اور بعد میں لائیو ہیلتھ چیکس۔ اختیاری health_version_field / header کلاسک جھوٹے گرین کو روکتا ہے: پرانے پوڈز 200 جواب دیتے رہتے ہیں جبکہ نیا ورژن کبھی رول ہی نہیں ہوا۔
خودکار رول بیک
ری ٹرائز کے بعد ناکام ہیلتھ پچھلا ورژن بحال کر دیتی ہے۔ سیڈ، پروموٹ اور رول بیک سب آڈٹ ہوتے ہیں — کامیاب ہوں یا ناکام۔
Kubernetes + VM/CI ڈیپلائرز
kubectl رول آؤٹس، GitHub Actions workflow-dispatch (مثلاً VMs پر WSL Proxy)، اور لائیو لاگز والے Kubernetes Job ایگزیکیوٹرز کے لیے ایک کنٹرول پلین۔
محفوظ ہم وقتی
ریپلیکاز میں Postgres سیشن ایڈوائزری لاکس کے ذریعے فی ایپ سیریلائزیشن۔ آپریشنز HTTP سے الگ چلتے ہیں تاکہ LB ٹائم آؤٹس درمیان میں رول بیک نہ روک سکیں۔
UI + REST API
ایمبیڈڈ Next.js کنسول اور بیئرر ٹوکن REST API۔ ایسنک ڈیپلائمنٹ ویوز AI اسٹیک ریلیزز دیکھنے والے آپریٹرز کے لیے پیش رفت اسٹریم کرتے ہیں۔
کنفیگ پر مبنی ایپس
YAML سے ایپلیکیشن شامل کریں: namespaces، Deployments، امیج ریپوز، ہیلتھ URLs، ڈیپلائر کی قسم — Ring Promoter کو فورک کرنے کی ضرورت نہیں۔
AI پلیٹ فارمز کے لیے تیار
ایجنٹ سروسز، MCP گیٹ ویز، GPU انفرنس فرنٹ ڈورز اور TenthMatrix پروڈکٹس کو انہی رِنگز سے پروموٹ کریں جن پر آپ کی پلیٹ فارم ٹیم پہلے سے بھروسہ کرتی ہے۔
AI سے چلنے والی ڈیپلائمنٹس کے لیے تیار
ماڈل ویٹس، ایجنٹ رن ٹائمز اور ایج گیٹ ویز مختلف رفتار سے شپ ہوتے ہیں۔ Ring Promoter ہر تبدیلی کو ایک ہی پروموشن پروٹوکول پر رکھتا ہے۔
- AI ایجنٹ APIs اور MCP گیٹ ویز کو کلاسک سروسز والی انہی رِنگز سے پروموٹ کریں۔
- ورژن کی تصدیق شدہ ہیلتھ خاموش رول بیکس پکڑتی ہے جب پرانا انفرنس سائیڈ کار اب بھی OK جواب دیتا ہے۔
- ابتدائی رِنگز کو آٹو پروموٹ کریں تاکہ ریسرچ بلڈز تیزی سے آگے بڑھیں؛ prod پر انسانی گیٹ برقرار رہتا ہے۔
- GitHub Actions ڈیپلائر پائپ لائنز دوبارہ لکھے بغیر موجودہ AI/ML CI کو دوبارہ استعمال کرتا ہے۔
- پروڈکشن تک کیا پہنچا، اس کے تعمیلی جائزوں کے لیے ہر (app, ring) کی مکمل تاریخ۔
سلوشن آرکیٹیکچر
صاف انٹرفیسز: Deployer، Executor، Health Checker، Store — پروموشن قواعد دوبارہ لکھے بغیر پروڈکشن بیک اینڈز بدلیں۔
کنٹرول پلین
k3s (یا لوکل) پر Go سروس + ایمبیڈڈ UI + REST API۔
رِنگز
ترتیب وار پائپ لائن ایک بار متعین؛ ایپس ہر رِنگ کے لیے وسائل میپ کرتی ہیں۔
ڈیپلائرز
ہر ایپ کے لیے kubectl، GitHub Actions، یا k8sjob ایگزیکیوٹرز۔
اسٹور
تاریخ اور لاکس کے ساتھ Postgres (prod) یا میموری (dev)۔
v1.0.2 میں Orbit + Lanes
فلیٹ کے لیے Orbit پر رکیں۔ جب انوائرنمنٹ میٹرکس چاہیے تو Lanes پر جائیں۔
پروڈکٹ سائٹ پر جاری رکھیں
ڈیمو، دستاویزات اور تازہ ترین Ring Promoter ریلیزز کے لیے https://www.ringpromoter.com/ دیکھیں۔
Ring Promoter حاصل کریں
ringpromoter.com پر پروڈکٹ دیکھیں، TenthMatrix کا تفصیلی جائزہ پڑھیں، یا AI پلیٹ فارمز کے لیے CI/CD کے بارے میں ہم سے بات کریں۔