تكامل Amazon S3#

يربط تكامل Amazon S3 حاويات S3 الخاصة بك بـ Ultralytics Platform. وتظل صورك في حاوياتك — إذ تفهرسها Platform في مكانها، بحيث يمكنك تصفحها والتعليق عليها وتدريب نماذج YOLO من دون تحميل نسخة منها.

إنشاء مستخدم IAM للقراءة فقط#

لا تقرأ Platform من مساحة التخزين لديك إلا البيانات — ولا تكتب عناصرَك أو تعدّلها أو تحذفها مطلقًا. استخدم مستخدم IAM مخصصًا يملك صلاحيات السرد والقراءة فقط — ولا تستخدم بيانات اعتماد المستخدم الجذر مطلقًا:

1. في وحدة تحكم AWS، انتقل إلى IAM > المستخدمون وأنشئ مستخدمًا من دون إمكانية الوصول إلى وحدة التحكم.

2. أرفق سياسة تمنح صلاحيات السرد والقراءة فقط للحاويات التي تريد ربطها:

   {
       "Version": "2012-10-17",
       "Statement": [
           { "Effect": "Allow", "Action": "s3:ListAllMyBuckets", "Resource": "*" },
           {
               "Effect": "Allow",
               "Action": ["s3:ListBucket", "s3:GetObject"],
               "Resource": ["arn:aws:s3:::my-bucket", "arn:aws:s3:::my-bucket/*"]
           }
       ]
   }

   s3:ListAllMyBuckets اختياري — إذ يتيح لـ Platform اكتشاف حاوياتك، فلا تضطر إلى كتابة أسمائها.

3. افتح علامة التبويب بيانات اعتماد الأمان للمستخدم، وأنشئ مفتاح وصول، ثم انسخ معرّف مفتاح الوصول ومفتاح الوصول السري.

الاتصال بـ Platform#

1. انتقل إلى الإعدادات > عمليات التكامل واختر Amazon S3 من قائمة عمليات التكامل.
2. أدخل معرّف مفتاح الوصول ومفتاح الوصول السري ومنطقة الحاوية (على سبيل المثال us-east-1).
3. انقر على العثور على الحاويات المتاحة، ثم اختر الحاويات المراد ربطها. إذا كانت السياسة لا تسمح بالاكتشاف، فأدخل يدويًا اسم حاوية معروفة.
4. انقر Connect. تتحقق Platform من قدرتها على سرد كل حاوية محددة وقراءة محتوياتها قبل حفظ أي شيء.

يلزم امتلاك دور مسؤول مساحة العمل أو مالكها لربط التخزين السحابي. يمكنك إضافة ما يصل إلى 50 حاوية في المرة الواحدة، ويعرض الاكتشاف ما يصل إلى 300 من الحاويات التي يمكن للمفتاح الوصول إليها.

تؤدي إعادة ربط مستخدم IAM نفسه لاحقًا إلى إضافة حاويات جديدة إلى التكامل الحالي. ولا تُستبدل بيانات الاعتماد المحفوظة إلا بعد التأكد من أن بيانات الاعتماد البديلة لا تزال قادرة على قراءة كل حاوية سبق ربطها. وإذا تعذرت قراءة أي حاوية، فسيذكر الخطأ اسمها، بما في ذلك الحاويات التي سبق ربطها باستخدام مستخدم IAM نفسه.

إنشاء مجموعة بيانات من حاوية S3#

1. انقر New Dataset وافتح علامة التبويب Cloud.
2. اختر حاوية متصلة، واستعرض المجلد الذي يحتوي على بياناتك.
3. أكّد المجلد، وعدّل اسم مجموعة البيانات، ثم أنشئها.

تسرد Platform محتويات المجلد مرة واحدة وتفهرس ما تعثر عليه:

• الصور — تُفهرس عناصر .jpg و.jpeg و.png و.webp و.avif مع قراءة الأبعاد عبر طلبات محدودة الحجم. ولا تحتفظ Platform بنسخة ثانية من الصورة المصدر.
• التسميات — تُحلّل ملفات YOLO الجانبية .txt وتحول إلى تعليقات توضيحية في Platform، وتُطابق وفق البنية القياسية images/ → labels/ أو بوصفها ملفات شقيقة في المجلد نفسه.
• البيانات الوصفية — يوفر ملف YAML أسماء الفئات وشكل النقاط المفتاحية للوضعيات، تمامًا كما يحدث عند رفع أرشيف. ويُفضّل استخدام data.yaml وdata.yml إذا احتوى المجلد على عدة ملفات.
• المهمة — تحدد عينة من ملفات التسميات نوع المهمة، لذا تُعرَف مجلدات التقسيم وتقدير الوضعيات وOBB من شكل التسميات، لا من المهمة التي اخترتها في مربع الحوار.
• التقسيمات — تعيّن أسماء المجلدات train وval وtest في مفتاح العنصر التقسيمات تلقائيًا.

تعمل مجموعة البيانات بعد ذلك مثل أي مجموعة أخرى: استعرضها وأضف إليها تعليقات توضيحية، واجعلها عامة أو خاصة، وشاركها مع فريقك، ودرّب عليها باستخدام التدريب المُدار. وتُبث الملفات الأصلية عند الطلب، ولا تشغل الصور المفهرسة حيزًا من حصة التخزين في Platform.

عمليات الاستيراد الفاشلة#

إذا فشل الاستيراد — بسبب مجلد فارغ، أو خطأ مطبعي في المسار، أو إلغاء الأذونات — فستعرض مجموعة البيانات الخطأ في صفحتها. يمكن للمحررين النقر على إعادة محاولة الاستيراد لإعادة تشغيله باستخدام الحاوية والمجلد المحفوظين، أو إنشاء مجموعة بيانات جديدة تشير إلى المسار المصحح.

تعيد محاولة الاستيراد سرد محتويات المجلد بدلًا من استئناف العملية: تُضاف العناصر التي أُضيفت منذ المحاولة الأولى، وتُزال من مجموعة البيانات العناصر التي لم تعد موجودة.

التدريب#

يتم التدريب المُدار عبر سير عمل التدريب المعتاد. يستخدم التدريب نسخ Platform الخاصة من الصور المثبّتة طوال مدة التشغيل، ولا تُكشف بيانات اعتماد AWS الخاصة بك مطلقًا لأحمال عمل التدريب.

قطع اتصال اتصال#

يؤدي قطع الاتصال إلى حذف بيانات الاعتماد المحفوظة من دون المساس بأي شيء في AWS. تظل مجموعات البيانات المنشأة من تلك الحاويات في مساحة عملك مع فئاتها وتصنيفاتها وتعليقاتها التوضيحية، لكن يتعذر تحميل صورها أو معاينتها أو التدريب عليها إلى أن يُربط مستخدم IAM نفسه مجددًا. ويمكنك مع ذلك إعادة تسميتها أو تعديل تصنيفاتها أو حذفها أثناء قطع الاتصال.

لقطع الاتصال، انتقل إلى الإعدادات > عمليات التكامل، واختر Amazon S3، وانقر على قطع الاتصال بجوار بيانات الاعتماد، ثم أكّد الإجراء. عند فتح إحدى مجموعات البيانات المرتبطة به، ستظهر رسالة تم قطع اتصال Amazon S3 مع رابط إلى هذه الإعدادات، وستعود مجموعة البيانات تلقائيًا بمجرد إعادة الاتصال.

يمكنك أيضًا قطع الاتصال باستخدام REST API، بالاستعانة بمعرّف التكامل الذي يعيده GET /api/integrations/buckets:

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/integrations/buckets/INTEGRATION_ID

from ultralytics_platform import Platform

client = Platform()  # reads ULTRALYTICS_API_KEY
integrations = client.storage_integrations.list()
client.storage_integrations.delete("INTEGRATION_ID")

لإلغاء الوصول من المصدر بدلًا من ذلك، عطّل مفتاح الوصول أو احذفه في AWS IAM.

القيود الحالية#

تستبعد مجموعات البيانات المرتبطة بـ S3 حاليًا الميزات التي تتطلب نسخًا من صورك تملكها Platform: التعليق التلقائي، وتحليل التجميع، واستنساخ مجموعات البيانات، ولقطات الإصدارات غير القابلة للتغيير.

يؤدي حذف مجموعة بيانات مرتبطة بـ S3 أو صور فردية منها إلى إزالة مراجع Platform فقط — ولا تُمس عناصرُك مطلقًا.

راجع أيضًا عمليات تكامل Google Cloud Storage وAzure Blob Storage.

الأسئلة الشائعة#