> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/ar/alsyanh/s3-migration.md).

# الترحيل إلى S3

## الترحيل إلى S3

{% hint style="info" %}
هذه التعليمات مخصّصة للإصدار v5.x وما بعده. إذا كنت تتبع هذا الدليل لإصدار أقدم، فيُرجى استخدام `sharelatex` بدلًا من `Overleaf` في أسماء المسارات و `SHARELATEX_` البادئة بدلاً من `OVERLEAF_` لمتغيرات البيئة.
{% endhint %}

{% hint style="warning" %}
عملاء Server Pro: يُرجى التواصل مع الدعم قبل ترحيل بياناتك إلى S3.
{% endhint %}

{% hint style="success" %}
**يسعدنا أن نسمع منك!** إذا رغبت في مشاركتنا عدد الملفات التي رحّلتها، وحجمها الإجمالي، والوقت الذي استغرقه الترحيل، فأرسل بريدًا إلكترونيًا إلى [`support@overleaf.com`](mailto:support@overleaf.com) .
{% endhint %}

سيرشدك هذا الدليل خلال الترحيل من التخزين على القرص إلى مخزن كائنات متوافق مع S3. وهو يشير إلى أقسام من مستند المقدمة حول [إعداد S3](/on-premises/ar/aliadadat/overleaf-toolkit/s3.md).

### المتطلبات

* مخزن كائنات متوافق مع S3 للتواصل معه، انظر [S3](/on-premises/ar/aliadadat/overleaf-toolkit/s3.md#s3-setup) للاطلاع على الخيارات
* مساحة قرص خالية لترحيل البيانات الموجودة، بحدود الحجم الحالي على القرص
* نافذة صيانة لإجراء الترحيل الفعلي
* نسخة احتياطية كاملة، بما في ذلك الإعدادات، لتمكين الاستعادة منها

### قدّر حجم القرص المطلوب للترحيل

يمكننا استخدام `du` لحساب استخدام القرص الحالي:

```shell
docker exec sharelatex \\
  du --human-readable --max-depth=0 /var/lib/overleaf/data/user_files

docker exec sharelatex \\
  du --human-readable --max-depth=0 /var/lib/overleaf/data/template_files
```

في حال لم تكن لديك مساحة قرص كافية على الخادم الحالي، فحاول توصيل قرص آخر بالخادم.

{% hint style="info" %}
تحتوي أدلة السجل بالفعل على البنية الصحيحة. يمكنك الرفع مباشرةً من مجلد المصدر المربوط، ولا يتطلب ذلك أي مساحة قرص إضافية.
{% endhint %}

### خطوات الترحيل

#### الخطوة 0: أوقف المثيل

نحتاج إلى التأكد من أن جميع ملفات المستخدم/القالب ستُرحَّل. من الأفضل إيقاف المثيل لتجنب فقدان الملفات التي جرى رفعها حديثًا.

يرجى الاطلاع على دليلنا حول إجراء نسخة احتياطية متسقة لمعرفة إجراءات الإيقاف.

#### الخطوة 1: أعد كتابة بنية الدليل

نحتاج إلى إعادة كتابة بنية الدليل لملفات المشروع لرفعها إلى S3. إن بنية الدليل للتخزين المحلي في filestore هي `<project-id>_<file-id>` وبنية الدليل في S3 هي `<project-id>/<file-id>`.

فيما يلي، `/srv/overleaf-s3-migration` يُستخدم لتخزين الملفات في بنية الدليل الجديدة.

يمكننا الاستفادة من `tar` لإعادة كتابة البنية:

```shell
mkdir -p /srv/overleaf-s3-migration/user_files \\
         /srv/overleaf-s3-migration/template_files
docker exec sharelatex \\
  tar --create --directory /var/lib/overleaf/data/user_files . \\
| tar --extract --directory /srv/overleaf-s3-migration/user_files \\
  --transform=sx_x/x
docker exec sharelatex \\
  tar --create --directory /var/lib/overleaf/data/template_files . \\
| tar --extract --directory /srv/overleaf-s3-migration/template_files \\
  --transform=sx_x/xg
```

#### الخطوة 2: حمّل الملفات

وفقًا لتفضيلك، يمكنك استخدام عميل minio mc S3 أو aws cli لرفع الملفات إلى مخزن الكائنات المتوافق مع S3.

**aws cli**

{% hint style="info" %}

* هنا ينبغي أن تستبدل `overleaf-user-files`, `overleaf-template-files`, `overleaf-project-blobs` و `overleaf-chunks` بأسماء حاويات S3 الخاصة بك.
* كما استبدل `/srv/overleaf-bind-mount` بالمسار المحلي لـ `/var/lib/overleaf` الربط التثبيتي. افتراضيًا، هذا هو `~/overleaf_data` في عملية نشر docker-compose.yml و `<toolkit-checkout>/data/overleaf` عند استخدام Toolkit.
  {% endhint %}

{% code overflow="wrap" %}

```shell
aws s3 sync /srv/overleaf-s3-migration/user_files s3://overleaf-user-files
aws s3 sync /srv/overleaf-s3-migration/template_files s3://overleaf-template-files

aws s3 sync /srv/overleaf-bind-mount/data/history/overleaf-project-blobs s3://overleaf-project-blobs
aws s3 sync /srv/overleaf-bind-mount/data/history/overleaf-chunks s3://overleaf-chunks
```

{% endcode %}

**minio mc**

نستخدم اسم الخادم المستعار "s3" هنا، وربما تكون قد اخترت اسمًا آخر.

{% code overflow="wrap" %}

```shell
mc mirror /srv/overleaf-s3-migration/user_files s3/overleaf-user-files
mc mirror /srv/overleaf-s3-migration/template_files s3/overleaf-template-files

mc mirror /srv/overleaf-bind-mount/data/history/overleaf-project-blobs s3/overleaf-project-blobs
mc mirror /srv/overleaf-bind-mount/data/history/overleaf-chunks s3/overleaf-chunks
```

{% endcode %}

#### الخطوة 3: ابدأ تشغيل المثيل مع التوجيه إلى S3

أضف جميع المتغيرات المتعلقة بـ S3 إلى إعداداتك، كما هو موضح بالتفصيل في [نظرة عامة على المتغيرات](/on-premises/ar/aliadadat/overleaf-toolkit/s3.md#overview-of-variables) قسم [S3](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/s3) دليل الإعداد.

بالنسبة لعمليات نشر Docker Compose، يمكنك أيضًا إزالة الربط التثبيتي لدليل البيانات من قسم volumes.

{% hint style="success" %}
يرجى الإبقاء على [الربط التثبيتي لقرص مؤقت للملفات العابرة](/on-premises/ar/aldam/troubleshooting.md#running-overleaf-with-an-nfs-filesystem) كما هو.
{% endhint %}

يمكنك الآن بدء تشغيل المثيل والتحقق من الترحيل:

* يمكنه معاينة الملفات الثنائية في المحرر
* يمكنه تجميع ملف PDF مع الصور
* يمكنه رفع ملفات جديدة

### التراجع

يمكنك التراجع عن الترحيل بسلاسة عبر عكس الخطوات:

1. أوقف المثيل
2. أعد مزامنة الملفات في الاتجاه المعاكس بقلب ترتيب المصدر/الوجهة
3. اكتب الملفات الجديدة مرة أخرى في الدليل المحلي باستخدام تحويل عكسي `تحويل`
4. أعد تشغيل المثيل بالتهيئة القديمة

{% code overflow="wrap" %}

```shell
# عند استخدام aws cli
aws s3 sync s3://overleaf-user-files /srv/overleaf-s3-migration/user_files
aws s3 sync s3://overleaf-template-files /srv/overleaf-s3-migration/template_files
aws s3 sync s3://overleaf-project-blobs /srv/overleaf-bind-mount/data/history/overleaf-project-blobs
aws s3 sync s3://overleaf-chunks /srv/overleaf-bind-mount/data/history/overleaf-chunks

# عند استخدام minio mc
mc mirror s3/overleaf-user-files /srv/overleaf-s3-migration/user_files
mc mirror s3/overleaf-template-files /srv/overleaf-s3-migration/template_files
mc mirror s3/overleaf-project-blobs /srv/overleaf-bind-mount/data/history/overleaf-project-blobs
mc mirror s3/overleaf-chunks /srv/overleaf-bind-mount/data/history/overleaf-chunks
```

{% endcode %}

```shell
# اكتب الملفات في Server CE/Server Pro المحلي
tar --create --directory /srv/overleaf-s3-migration/user_files . \\
| docker exec --interactive sharelatex \\
    tar \\
      --extract \\
      --keep-old-files \\
      --directory /var/lib/overleaf/data/user_files \\
      --transform=sx./xx --transform=sx/x_x \\
      --wildcards '*/*/*'

tar --create --directory /srv/overleaf-s3-migration/template_files . \\
| docker exec --interactive sharelatex \\
    tar \\
      --extract \\
      --keep-old-files \\
      --directory /var/lib/overleaf/data/template_files \\
      --transform=sx./xx --transform=sx/x_xg \\
      --wildcards '*/*/*/*/pdf-converted-cache/*' \\
      --wildcards '*/*/*/*/pdf' \\
      --wildcards '*/*/*/*/zip'
```

{% hint style="info" %}
التحويل الأول يزيل المجلد الأعلى مستوى. أما التحويل الثاني فيغيّر بنية الدليل إلى بنية مسطحة. وتضمن أحرف البدل استخراج الملفات فقط، وليس مجلداتها الأصلية (مجلدات المشروع).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/ar/alsyanh/s3-migration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.