Link to this sectionIntegración con Google Cloud Storage#

La integración con Google Cloud Storage conecta tus buckets de GCS a Ultralytics Platform. Tus imágenes permanecen en tus buckets: Platform las indexa en su ubicación actual, por lo que puedes explorar, anotar y entrenar modelos YOLO sin necesidad de subir una copia.

Funcionalidad Pro

Los datasets de Google Cloud Storage requieren un plan Pro o Enterprise. Los espacios de trabajo gratuitos verán la integración y se les solicitará actualizar al intentar conectarse. Los datasets de Google Cloud Storage existentes seguirán siendo totalmente accesibles si finaliza una suscripción; solo las nuevas conexiones e importaciones requieren Pro.

Link to this sectionCrea una cuenta de servicio de solo lectura#

Platform solo lee de tu almacenamiento; nunca escribe, modifica ni elimina tus objetos. Crea una cuenta de servicio dedicada solo con acceso de lectura:

1. En la consola de Google Cloud, ve a IAM y administración > Cuentas de servicio y crea una cuenta de servicio.
2. Concédele el rol de Visor de objetos de almacenamiento (roles/storage.objectViewer) en los buckets que quieras conectar.
3. Abre la cuenta de servicio, elige Claves > Añadir clave > Crear nueva clave, selecciona JSON y descarga el archivo de la clave.

Link to this sectionConéctate a Platform#

1. Ve a Configuración > Integraciones y busca la tarjeta de Google Cloud.
2. Haz clic en Conectar y pega el contenido del archivo JSON de la clave de cuenta de servicio.
3. Platform enumerará los buckets que la cuenta de servicio puede leer. Selecciona los que quieras conectar o introduce el nombre de un bucket manualmente si la cuenta no puede enumerar buckets.
4. Haz clic en Conectar. Platform verificará que puede enumerar y leer cada bucket seleccionado antes de guardar nada.

Volver a conectar la misma cuenta de servicio más tarde añadirá nuevos buckets a la integración existente. Una credencial guardada solo se reemplaza si su sustituta puede seguir leyendo todos los buckets que ya has conectado.

Seguridad de las credenciales

Las credenciales se cifran en reposo con AES-256-GCM, nunca se devuelven al navegador y nunca entran en las cargas útiles de los trabajos de entrenamiento. Para revocar el acceso, elimina la clave de la cuenta de servicio en Google Cloud.

Link to this sectionCrea un dataset desde un bucket de GCS#

1. Haz clic en New Dataset y abre la pestaña Cloud storage.
2. Elige un bucket conectado y navega hasta la carpeta que contiene tus datos.
3. Confirma la carpeta, ajusta el nombre del conjunto de datos y créalo.

La plataforma lista la carpeta una vez e indexa lo que encuentra:

• Imágenes: los objetos .jpg, .jpeg, .png, .webp y .avif se indexan con dimensiones leídas a partir de solicitudes de cabecera acotadas. Los píxeles originales nunca se copian fuera de tu bucket.
• Labels — los archivos adjuntos YOLO .txt se analizan para convertirse en anotaciones de la plataforma, emparejados mediante el diseño estándar images/ → labels/ o como hermanos en la misma carpeta.
• Metadata — un archivo data.yaml/data.yml proporciona los nombres de las clases, el tipo de tarea y la forma de los keypoints de pose, exactamente igual que una carga de archivo.
• Splits — los nombres de carpeta train, val y test en la ruta del objeto asignan los splits automáticamente.

El dataset se comporta entonces como cualquier otro: explóralo y anótalo, configúralo como público o privado, compártelo con tu equipo y entrénate en él mediante entrenamiento gestionado. Los originales se transmiten bajo demanda y las imágenes indexadas no consumen tu cuota de almacenamiento de Platform.

Límites

Una única importación indexa hasta 50 000 objetos y archivos de etiquetas o YAML de hasta 1 MB cada uno. Los buckets más grandes deben dividirse en varios datasets.

Mantén los objetos indexados inmutables

Cada imagen indexada está vinculada a su generación de objeto GCS, y Platform falla de forma segura si un objeto cambia subyacente. Añade nuevos objetos en lugar de sobrescribir los existentes.

Link to this sectionImportaciones fallidas#

Si una importación falla (una carpeta vacía, un error tipográfico en la ruta o permisos revocados), el dataset muestra el error en su página. Los editores pueden hacer clic en Reintentar importación para reiniciarla con el bucket y la carpeta almacenados, o crear un nuevo dataset que apunte a la ruta corregida.

Link to this sectionEntrenamiento#

El entrenamiento gestionado funciona a través del flujo de entrenamiento normal. Los trabajadores descargan los originales vinculados en el almacenamiento de trabajo temporal para la ejecución y los eliminan al limpiar el trabajo; tus credenciales de Google Cloud nunca llegan a la computación.

Link to this sectionLimitaciones actuales#

Los datasets respaldados por GCS excluyen actualmente funciones que requieren copias de tus imágenes propiedad de Platform: auto-anotación, análisis de agrupamiento, clonación de datasets e instantáneas de versión inmutables.

Eliminar un dataset respaldado por GCS, o imágenes individuales del mismo, solo elimina las referencias de Platform; tus objetos nunca se ven afectados.

Consulta también las integraciones con Amazon S3 y Azure Blob Storage.