تطبيق Next.js: نشر إلى staging عبر البوابات، ثم إلى production
آخر تحديث
ابن تغييرا في واجهة Next.js بسير العمل UI Implementation، وادمجه عبر البوابة، واستدع عنوان webhook للنشر إلى staging، ولا تصدره إلى production إلا بعد staging.
صفحة الأسعار تغيير تريد أن يجربه الناس بأنفسهم قبل أن يراه العملاء. وهذا القالب يبني تغييرا في واجهة Next.js، ويرسله إلى staging عبر خط النشر الخاص بك بعد دمجه، ويوقف الإصدار إلى production إلى أن يصل التغيير إلى staging.
الوكلاء الذين يعملون
| الخطوة | الوكيل |
|---|---|
| UI plan | UI Designer |
| Implement | Builder |
| Code review | Reviewer |
| Behavior test | Tester |
يخطط وكيل UI Designer للتخطيط والحالات وإمكانية الوصول (ترتيب التركيز، والتسميات، وحالة الضغط في زر التبديل). وبعد خطوة Implement، تكتب جولة كتابة الكود التغيير، ويعمل سكربت الاختبار في ملف package.json داخل بيئة معزولة غير متصلة بالشبكة. ثم تقرأ خطوتا Code review و Behavior test التغيير المكتوب ونتيجة الاختبار، وتقرأ مراجعة الملاحظات الفروقات. والملاحظات المفتوحة بخطورة high أو critical والاختبارات الفاشلة تمنع التغيير، ويوافق شخص غير الذي بدأ الجلسة قبل أن يفتح طلب السحب، حين يكون في مساحة العمل شخص آخر يملك صلاحية الموافقة.
أرسل عمليات الدمج إلى staging
افتح Release → Deployments، واختر Deploy targets، وأدخل للمشروع ما يلي:
| الحقل | قيمة مثال |
|---|---|
| Deploy webhook URL | https://deploy.example.com/hooks/web-staging |
| Environment | staging |
| Signing secret | سلسلة عشوائية يعرفها خط النشر لديك أيضا |
حين تدمج طلب السحب من لوحة التحكم، تعمل بوابة الجودة مرة أخرى أولا. ثم يرسل AI CodeOps طلب POST من نوع pr_merged، موقّعا بالترويسة X-CodeOps-Signature، ويسجل عملية نشر بالحالة in progress. فيبني خط النشر لديك وينشر إلى staging. وإذا فشل استدعاء عنوان webhook، تفتح حادثة.
لا ترقّ إلى production إلا من staging
لا يستطيع خط النشر لديك إبلاغ النتيجة النهائية، فحين تصبح staging سليمة، اختر Record deployment: البيئة staging، والحالة succeeded، وقيمة Commit SHA التي نشرتها. ثم تسأل مهمة production البوابة، كما يلي:
curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $WORKSPACE_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"pullRequestURL\":\"$PR_URL\",\"commitSHA\":\"$COMMIT_SHA\",\"requireDeployedTo\":\"staging\"}" \
| jq -e '.allowed == true'
يعثر عنوان طلب السحب على الجلسة؛ ويجب أن تطابق تجزئة الإيداع SHA سجل staging. ومن دون هذا السجل، يكون الجواب رفضا بالرسالة "Not yet deployed to "staging" — promote there before releasing". راجع عمليات النشر عبر البوابات.
وإذا ساء شيء في production، فتراجع في خط النشر لديك وسم عملية النشر بأنها rolled back، كما في التراجع. ولجانب المراجعة في التطبيق نفسه، ابدأ بـقالب مراجعة طلبات السحب في Next.js.
الأسئلة الشائعة
هل يستضيف AI CodeOps بيئة معاينة أو بيئة staging؟
لا. إنه يستدعي عنوان webhook للنشر الذي تضبطه، وخط النشر الخاص بك هو الذي ينشر. ولا يحتفظ AI CodeOps بأي بيانات اعتماد لبنيتك التحتية.
لماذا يقول فحص production إن التغيير ليس في staging بعد؟
عملية النشر عبر webhook تبقى بالحالة in progress، لأن خط النشر لديك لا يستطيع إبلاغ النتيجة. سجل عملية النشر إلى staging بالحالة succeeded، مع تجزئة الإيداع SHA الخاصة بها، قبل الإصدار.