ترحيل Sandbox إلى Next

# ترحيل الإصدار المستقر (stable) إلى الإصدار التجريبي 1.0 من Sandbox SDK (`@next`)

**نفذ** عملية النقل. اتبع الخطوات بالترتيب. التفاصيل موجودة في الوثائق — استرجع الصفحة المرتبطة عندما تتطلب الخطوة تفصيلا.

دليل بشري: [الترحيل](https://developers.cloudflare.com/sandbox/sdk/migrate/index.md) · [الإصدار التجريبي 1.0](https://developers.cloudflare.com/sandbox/index.md)

يجب أن تبدأ **المشاريع الجديدة** على `@next` (**`sandbox-next`**)، وليس هذه المهارة. **العمل المستقر اليومي** ← **`sandbox-stable`**. تنظيف واجهات برمجة التطبيقات المهملة **دون** الانتقال إلى `@next` ← [دليل إهمال 2026](https://developers.cloudflare.com/sandbox/sdk/migrate/index.md) أولا إذا لزم الأمر.

يجب على التطبيقات الحالية الترحيل **عندما تستطيع**، لتكون جاهزا عندما يصبح الإصدار 1.0 هو الإصدار المستقر. **لا** تفرض التحويل إلى الإنتاج دون موافقة المستخدم.

**فضل أنواع `@next` المثبتة ووثيقة الترحيل على الذاكرة.**

## سير العمل

1. **راجع** القواعد الصارمة وخريطة الاستبدال 2. **دقق** قاعدة التعليمات البرمجية؛ اذكر النتائج والأشكال المستهدفة 3. **وضح** مع المستخدم (التحويل، الجسر، صورة Python، المواقع غير الواضحة) 4. **حدث** الحزمة والصورة والتعليمات البرمجية 5. **تحقق**

توقف بعد أي خطوة تتطلب قرارا من المستخدم.

## قواعد صارمة

- يجب أن تكون حزمة Worker وصورة الحاوية من نفس خط `@next`. - يستخدم التحويل إلى الإنتاج طرح الحاوية **الفوري**. بروتوكولات التحكم المستقرة و`@next` غير متوافقة في كلا الاتجاهين؛ الطرح التدريجي يترك نافذة مختلطة معطلة. يمكن إيقاف عمل الحاوية قيد التنفيذ. - بعد التحويل، `await sandbox.exec(...)` يعني أن العملية **بدأت**، وليس أن الأمر **انتهى**. - Argv كما هو (لا يوجد shell ضمني). تتطلب صيغة Shell ثنائي shell صريحا. - لا تحتوي معالجات العمليات على **stdin** ← استخدم المحطات الطرفية للإدخال التفاعلي. - `timeout` / `AbortSignal` للمراقبة يلغيان **الانتظار فقط**، وليس العملية. - لا توجد حلقة إعادة محاولة واحدة لكل خطأ. - لا تخترع واجهات برمجة تطبيقات (`gitCheckout` على النواة، stdin للعملية، مساعد إكمال تنفيذ السلسلة). - الجسر المنشور ذاتيا يبقى على **الإصدار المستقر** (ليس جزءا من خط الإصدار التجريبي بعد).

## خريطة الاستبدال

| الإصدار المستقر (Stable) | `@next` | | ------------------------ | ------- | | `SANDBOX_TRANSPORT` / `transport` / `setTransport` | إزالة — RPC فقط | | `await sandbox.exec("cmd")` ← نتيجة مخزنة مؤقتا | `await sandbox.exec(argv)` ← معالج، ثم `output` / ينتظر | | `execStream` / `startProcess` | نفس المعالج: `logs`، `waitFor*`، `kill` | | الجلسات الافتراضية / المسماة | اختفت — `cwd`/`env` لكل عملية إطلاق، أو نص برمجي واحد ل shell | | `sandbox.terminal(request)` / محطة الجلسة | `createTerminal` + `terminal.connect(request)` | | xterm `sessionId` | `terminalId` | | طرق المترجم على `Sandbox` | `withInterpreter` ← `sandbox.interpreter.*` | | `gitCheckout` | argv `git` عبر `exec` | | إشارات إنهاء السلسلة | رقمية فقط | | الملفات، نقاط التثبيت، النسخ الاحتياطية، المنافذ، الأنفاق، `proxyToSandbox` | لم تتغير في الغالب (تجاهل أجزاء الجلسة/النقل في الصفحات المستقرة) |

العمق: [الترحيل](https://developers.cloudflare.com/sandbox/sdk/migrate/index.md) · بعد النقل، العمل اليومي ← **`sandbox-next`**

## التدقيق

```sh rg 'SANDBOX_TRANSPORT|transport:|setTransport|enableDefaultSession|createSession|getSession|deleteSession|execStream\(|startProcess\(|killProcess\(|sandbox\.terminal\(|sessionId|gitCheckout\(|SandboxTransport|ExecutionSession' ```

أيضا: سلسلة `exec(`, `cd` ثم `exec` لاحقا، `createCodeContext` / `runCode` مجردة على `Sandbox`.

## التوضيح (اسأل عند الحاجة)

- هل يمكن قطع الإنتاج باستخدام `--containers-rollout=immediate` (قد تتوقف العمليات/المحطات الطرفية/التدفقات الحية)؟ - الجسر المنشور ذاتيا؟ اتركه على الإصدار المستقر. - مترجم Python ← متغير الصورة **`-python`**؟ - مواقع الاستدعاء غير المشمولة بالخريطة؟

## الترقية

### الحزمة والصورة

```sh npm install @cloudflare/sandbox@next ```

```dockerfile FROM cloudflare/sandbox:next # Python: cloudflare/sandbox:next-python ```

نفس علامة الإصدار التجريبي المسبق على Worker والصورة عندما لا تكون على `next` العائمة.

### التعليمات البرمجية حسب المنطقة

طبق الاستبدالات من الخريطة. لكل منطقة، نفذ من الوثيقة — وليس من العادات المستقرة:

| المنطقة | الوثيقة | | -------- | ------- | | الأوامر / المعالجات / الانتظارات | [العمليات](https://developers.cloudflare.com/sandbox/index.md) · [واجهة برمجة تطبيقات العمليات](https://developers.cloudflare.com/sandbox/index.md) | | `cwd` / `env` / الأسرار | [البيئة](https://developers.cloudflare.com/sandbox/index.md) · [حركة المرور الصادرة](https://developers.cloudflare.com/sandbox/sdk/guides/outbound-traffic/index.md) | | إسقاط الجلسات | [الترحيل](https://developers.cloudflare.com/sandbox/sdk/migrate/index.md) · [دورة الحياة](https://developers.cloudflare.com/sandbox/index.md) | | المحطات الطرفية | [المحطات الطرفية](https://developers.cloudflare.com/sandbox/index.md) | | المترجم | [المترجم](https://developers.cloudflare.com/sandbox/index.md) | | الأخطاء | [الأخطاء](https://developers.cloudflare.com/sandbox/index.md) | | مهمة دائمة عبر الطلبات | [تنفيذ العملية — العمر / المتانة](https://developers.cloudflare.com/sandbox/index.md) |

**الأوامر (الشكل):**

```ts // قبل (الإصدار المستقر) const result = await sandbox.exec("npm test");

// بعد (@next) con ```