Link to this sectionIntegrazione con Google Cloud Storage#

L'integrazione con Google Cloud Storage collega i tuoi bucket GCS a Ultralytics Platform. Le tue immagini rimangono nei tuoi bucket: la piattaforma le indicizza sul posto, così puoi navigare, annotare e addestrare modelli YOLO senza doverne caricare una copia.

Funzionalità Pro

I dataset di Google Cloud Storage richiedono un piano Pro o Enterprise. Gli spazi di lavoro gratuiti vedono l'integrazione e riceveranno l'invito a eseguire l'upgrade durante la connessione. I dataset Google Cloud Storage esistenti rimangono completamente accessibili se un abbonamento termina: solo le nuove connessioni e importazioni richiedono un piano Pro.

Link to this sectionCreare un account di servizio in sola lettura#

La piattaforma legge sempre e solo dal tuo storage: non scrive, modifica o elimina mai i tuoi oggetti. Crea un account di servizio dedicato con accesso in sola lettura:

1. Nella console di Google Cloud, vai su IAM & Admin > Service Accounts (IAM e amministrazione > Account di servizio) e crea un account di servizio.
2. Assegna il ruolo Storage Object Viewer (roles/storage.objectViewer) sui bucket che desideri collegare.
3. Apri l'account di servizio, seleziona Keys > Add key > Create new key (Chiavi > Aggiungi chiave > Crea nuova chiave), scegli JSON e scarica il file della chiave.

Link to this sectionCollegarsi alla piattaforma#

1. Vai su Settings > Integrations (Impostazioni > Integrazioni) e trova la scheda Google Cloud.
2. Clicca su Connect (Connetti) e incolla il contenuto della chiave JSON dell'account di servizio.
3. La piattaforma elenca i bucket che l'account di servizio può leggere. Seleziona quelli da collegare o inserisci manualmente un nome di bucket se l'account non riesce a elencare i bucket.
4. Clicca su Connect (Connetti). La piattaforma verifica di poter elencare e leggere ogni bucket selezionato prima di salvare qualsiasi cosa.

Ricollegare lo stesso account di servizio in seguito aggiunge nuovi bucket all'integrazione esistente. Una credenziale salvata viene sostituita solo quando la sua sostituta è in grado di leggere tutti i bucket che hai già collegato.

Sicurezza delle credenziali

Le credenziali sono crittografate at-rest con AES-256-GCM, non vengono mai restituite al browser e non entrano mai nei payload dei processi di addestramento. Per revocare l'accesso, elimina la chiave dell'account di servizio in Google Cloud.

Link to this sectionCreare un dataset da un bucket GCS#

1. Fai clic su New Dataset e apri la scheda Cloud storage.
2. Scegli un bucket collegato e naviga nella cartella che contiene i tuoi dati.
3. Conferma la cartella, regola il nome del dataset e crea il dataset.

La Platform elenca la cartella una volta e indicizza ciò che trova:

• Immagini: gli oggetti .jpg, .jpeg, .png, .webp e .avif vengono indicizzati con le dimensioni lette da richieste di intestazione limitate. I pixel originali non vengono mai copiati fuori dal tuo bucket.
• Labels — i file sidecar YOLO .txt vengono analizzati nelle annotazioni della Platform, abbinati secondo il layout standard images/ → labels/ o come fratelli nella stessa cartella.
• Metadata — un data.yaml/data.yml fornisce nomi delle classi, tipo di task e forma dei keypoint della posa, esattamente come un caricamento di archivio.
• Splits — i nomi delle cartelle train, val e test nel percorso dell'oggetto assegnano gli split automaticamente.

Il dataset si comporta quindi come qualsiasi altro: naviga e annotalo, impostalo come pubblico o privato, condividilo con il tuo team e addestra modelli tramite l'addestramento gestito. Gli originali vengono trasmessi su richiesta e le immagini indicizzate non consumano la tua quota di storage della piattaforma.

Limiti

Una singola importazione indicizza fino a 50.000 oggetti e file di etichette o YAML fino a 1 MB ciascuno. I bucket più grandi dovrebbero essere suddivisi in più dataset.

Mantieni gli oggetti indicizzati immutabili

Ogni immagine indicizzata è bloccata sulla sua generazione di oggetti GCS e la piattaforma si chiude in caso di errore se un oggetto cambia al suo interno. Aggiungi nuovi oggetti invece di sovrascrivere quelli esistenti.

Link to this sectionImportazioni fallite#

Se un'importazione fallisce (una cartella vuota, un errore di battitura nel percorso o permessi revocati), il dataset mostra l'errore sulla sua pagina. Gli editori possono cliccare su Retry import (Riprova importazione) per riavviarla con il bucket e la cartella archiviati, oppure creare un nuovo dataset che punta al percorso corretto.

Link to this sectionAddestramento#

L'addestramento gestito funziona tramite il normale flusso di addestramento. I worker scaricano gli originali bloccati nello storage temporaneo del processo per l'esecuzione e li rimuovono al termine del processo: le tue credenziali Google Cloud non raggiungono mai l'infrastruttura di calcolo.

Link to this sectionLimitazioni attuali#

I dataset basati su GCS attualmente escludono funzionalità che richiedono copie delle tue immagini di proprietà della piattaforma: annotazione automatica, analisi di clustering, clonazione di dataset e version snapshots immutabili.

Eliminare un dataset basato su GCS, o singole immagini da esso, rimuove solo i riferimenti della piattaforma: i tuoi oggetti non vengono mai toccati.

Vedi anche le integrazioni con Amazon S3 e Azure Blob Storage.