تكامل Google Cloud Storage#

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

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

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

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

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

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

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

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

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

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

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 لإعادة تشغيلها باستخدام الحاوية والمجلد المخزنين، أو إنشاء مجموعة بيانات جديدة تشير إلى المسار المصحح.

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

التدريب#

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

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

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

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

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