Link to this sectionتكامل Google Cloud Storage#

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

ميزة Pro

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

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

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

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

Link to this sectionالاتصال بالمنصة#

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

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

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

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

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

1. انقر فوق New Dataset وافتح علامة التبويب Cloud storage.
2. اختر حاوية متصلة وانتقل إلى المجلد الذي يحتوي على بياناتك.
3. أكد المجلد، واضبط اسم مجموعة البيانات، وأنشئ مجموعة البيانات.

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

• الصور — تتم فهرسة الكائنات من نوع .jpg و .jpeg و .png و .webp و .avif مع قراءة الأبعاد من طلبات الرأس المحددة. لا يتم نسخ وحدات البكسل المصدرية أبداً خارج حاويتك.
• Labels — يتم تحليل ملفات YOLO الجانبية بتنسيق .txt إلى تعليقات توضيحية (annotations) في المنصة، ويتم مطابقتها حسب التخطيط القياسي images/ → labels/ أو كملفات مصاحبة في المجلد نفسه.
• Metadata — يوفر ملف data.yaml/data.yml أسماء الفئات، ونوع المهمة، وشكل النقاط الرئيسية (keypoint shape)، تماماً مثل تحميل الأرشيف.
• Splits — تقوم أسماء المجلدات train و val و test الموجودة في مسار الكائن بتعيين التقسيمات تلقائياً.

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

القيود

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

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

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

Link to this sectionإخفاقات الاستيراد#

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

Link to this sectionالتدريب#

يعمل التدريب المُدار من خلال تدفق التدريب العادي. يقوم العمال بتنزيل النسخ الأصلية المثبتة إلى وحدة تخزين المهام المؤقتة للتشغيل وإزالتها عند تنظيف المهمة — بيانات اعتماد Google Cloud الخاصة بك لا تصل أبداً إلى بيئة الحوسبة.

Link to this sectionالقيود الحالية#

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

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

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