تكامل 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، ثم انسخ معرّف مفتاح الوصول ومفتاح الوصول السري.

الاتصال بالمنصة#

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

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

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

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

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

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

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

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

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

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

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