تكامل Google Cloud Storage#

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

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

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

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

الاتصال بـ Platform#

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

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

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

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

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

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 الخاصة من الصور المثبّتة طوال مدة التشغيل، ولا تُكشف بيانات اعتماد Google Cloud الخاصة بك مطلقًا لأحمال عمل التدريب.

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

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

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

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

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

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

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