تكامل 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.

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

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

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

التدريب#

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

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

انظر أيضًا إلى تكاملي Amazon S3 وAzure Blob Storage.

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