رؤية YOLO لعام 2026:

تكامل Google Cloud Storage#

يربط تكامل Google Cloud Storage حاويات GCS الخاصة بك بـ Ultralytics Platform. تظل صورك في حاوياتك - تقوم المنصة بفهرستها في مكانها، بحيث يمكنك تصفح وتعليق وتدريب نماذج YOLO دون تحميل نسخة.

ميزة Pro

تتطلب مجموعات بيانات Google Cloud Storage خطة Pro أو Enterprise. تظهر مساحات العمل المجانية التكامل ويُطالبها بالترقية عند الاتصال. تظل مجموعات بيانات Google Cloud Storage الحالية قابلة للوصول بالكامل إذا انتهى الاشتراك - تتطلب الاتصالات وعمليات الاستيراد الجديدة فقط خطة Pro.

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

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

  1. في وحدة تحكم Google Cloud، انتقل إلى IAM & Admin > Service Accounts وأنشئ حساب خدمة.
  2. امنحه دور Storage Object Viewer (roles/storage.objectViewer) على الحويات التي تريد توصيلها.
  3. افتح حساب الخدمة، اختر Keys > Add key > Create new key، حدد JSON، وقم بتنزيل ملف المفتاح.
اكتشاف الحاويات يحتاج إلى إذن إضافي

roles/storage.objectViewer يغطي كل ما تفعلته Platform ببياناتك، ولكنه لا يسمح بسرد الحاويات في المشروع. أضف دوراً يحمل storage.buckets.list إذا كنت تريد أن تجد Platform حاوياتك نيابة عنك؛ وإلا فاكتب اسم كل حاوية يدوياً عند الاتصال.

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

  1. اذهب إلى Settings > Integrations وحدد Google Cloud Storage من قائمة التكاملات.
  2. الصق محتويات مفتاح JSON الخاص بحساب الخدمة.
  3. انقر فوق Find available buckets، ثم حدد الحاويات المراد الاتصال بها. إذا تعذر على حساب الخدمة سرد الحاويات، فأدخل اسم حاوية معروف يدوياً.
  4. انقر فوق Connect. تتحقق المنصة من قدرتها على سرد وقراءة كل حاوية محددة قبل حفظ أي شيء.

Ultralytics Platform Google Cloud Storage Integration Settings

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

يققرأ متصفحك ملف المفتاح الملصق ويرسل الحقول الثلاثة فقط التي تحتاجها Platform — client_email و private_key و project_id. باقي ملف JSON لا يغادر الصفحة أبداً.

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

أمان بيانات الاعتماد

يتم تشفير بيانات الاعتماد أثناء السكون باستخدام AES-256-GCM، ولا يتم إرجاعها إلى المتصفح أبداً، ولا يتم تعريضها لأحمال عمل التدريب أبداً. لإلغاء الوصول، احذف مفتاح حساب الخدمة في Google Cloud.

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

  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 في مسار الكائن بتعيين التقسيمات تلقائيًا.

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

القيود

تقوم عملية استيراد واحدة بفهرسة ما يصل إلى 50,000 كائن، وملفات التسميات أو YAML حتى 1 ميجابايت لكل منها. يجب تقسيم الحاويات الأكبر عبر مجموعات بيانات متعددة.

حافظ على الكائنات المفهرسة غير قابلة للتغيير

يتم تثبيت كل صورة مفهرسة على إصدار كائن GCS الخاص بها، وتتوقف المنصة عن العمل إذا تغير كائن ما تحتها. أضف كائنات جديدة بدلاً من الكتابة فوق الموجودة.

إخفاقات الاستيراد#

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

تؤدي إعادة المحاولة إلى إعادة سرد المجلد بدلاً من الاستئناف: يتم التقاط الكائنات المضافة منذ المحاولة الأولى، وتتم إزالة الكائنات التي لم تعد موجودة من مجموعة البيانات.

التدريب#

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

قطع الاتصال#

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

استخدم 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")

لإلغاء الوصول من المصدر بدلاً من ذلك، احذف مفتاح حساب الخدمة في Google Cloud.

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

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

حذف مجموعة بيانات مدعومة بـ GCS، أو صور فردية منها، يزيل مراجع المنصة فقط — لا يتم لمس كائناتك أبداً.

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

المساهمون
GLglenn-jocher6PDpderrenger1

التعليقات