تكامل Amazon S3#

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

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

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

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

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 اختياري — إذ يتيح للمنصة اكتشاف حاوياتك، فلا تضطر إلى كتابة أسمائها.

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

الاتصال بـ Platform#

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

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

تؤدي إعادة الاتصال باستخدام مستخدم 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.

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

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

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

التدريب#

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

قطع الاتصال#

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

استخدم 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 حاليًا إلى الميزات التي تتطلب نسخًا من صورك تملكها المنصة: التعليق التوضيحي التلقائي، وتحليل التجميع، واستنساخ مجموعات البيانات، ولقطات الإصدارات غير القابلة للتغيير.

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

اطّلع أيضًا على تكاملي Google Cloud Storage وAzure Blob Storage.

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