تكامل Amazon S3#

يقوم تكامل Amazon S3 بتوصيل مستودعات S3 الخاصة بك بـ Ultralytics Platform. تظل صورك في مستودعاتك — تقوم المنصة بفهرستها في مكانها، حتى تتمكن من تصفح وتعليق وتدريب نماذج 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، وقم بنسخ معرف مفتاح الوصول (access key ID) ومفتاح الوصول السري (secret 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. أكد المجلد، واضبط اسم مجموعة البيانات، وأنشئ مجموعة البيانات.

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

• Images — تتم فهرسة كائنات .jpg و .jpeg و .png و .webp و .avif مع الأبعاد المقروءة من خلال طلبات محدودة. لا تحتفظ المنصة بنسخة ثانية من الصورة الأصلية.
• Labels — يتم تحليل ملفات YOLO الجانبية .txt إلى تعليقات على المنصة، مطابقة لتخطيط images/ → labels/ القياسي أو كأشقاء في نفس المجلد.
• Metadata — يوفر ملف YAML أسماء الفئات وشكل نقاط مفتاح الوضع، تماماً مثل تحميل الأرشيف. يُفضل data.yaml و data.yml عندما يحتوي المجلد على عدة ملفات.
• Task — عينة من ملفات التسميات تحدد المهمة، لذا يتم التعرف على مجلدات تقسيم الصور (segment) والوضع (pose) و OBB من شكل التسمية الخاص بها بدلاً من المهمة التي اخترتها في مربع الحوار.
• Splits — تقوم أسماء المجلدات 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.