Link to this sectionIntegrazione Amazon S3#

L'integrazione con Amazon S3 collega i tuoi bucket S3 a Ultralytics Platform. Le tue immagini rimangono nei tuoi bucket: la piattaforma le indicizza in loco, così puoi sfogliare, annotare e addestrare modelli YOLO senza doverne caricare una copia.

Funzionalità Pro

I dataset Amazon S3 richiedono un piano Pro o Enterprise. Gli spazi di lavoro gratuiti vedono l'integrazione e ricevono l'invito a eseguire l'upgrade al momento della connessione. I dataset Amazon S3 esistenti rimangono completamente accessibili anche in caso di termine dell'abbonamento: solo le nuove connessioni e importazioni richiedono un piano Pro.

Link to this sectionCrea un utente IAM in sola lettura#

La piattaforma legge sempre e solo dal tuo storage: non scrive, modifica o elimina mai i tuoi oggetti. Usa un utente IAM dedicato con permessi di solo elenco e lettura: non usare mai le credenziali root:

1. Nella console AWS, vai su IAM > Utenti e crea un utente senza accesso alla console.

2. Allega una policy che conceda solo l'accesso in elenco e lettura ai bucket che vuoi collegare:

   {
       "Version": "2012-10-17",
       "Statement": [
           { "Effect": "Allow", "Action": "s3:ListAllMyBuckets", "Resource": "*" },
           {
               "Effect": "Allow",
               "Action": ["s3:ListBucket", "s3:GetObject"],
               "Resource": ["arn:aws:s3:::my-bucket", "arn:aws:s3:::my-bucket/*"]
           }
       ]
   }

   s3:ListAllMyBuckets è facoltativo: consente alla piattaforma di rilevare i tuoi bucket così non devi digitarne i nomi.

3. Apri la scheda Credenziali di sicurezza dell'utente, crea una chiave di accesso e copia l'ID chiave di accesso e la chiave di accesso segreta.

Link to this sectionCollegarsi alla piattaforma#

1. Vai su Impostazioni > Integrazioni e trova la scheda Amazon S3.
2. Fai clic su Connetti e inserisci l'ID chiave di accesso, la chiave di accesso segreta e la regione del bucket (ad esempio us-east-1).
3. La piattaforma elenca i bucket che la credenziale può leggere. Seleziona quelli da collegare, o inserisci manualmente il nome di un bucket se la policy non ne consente il rilevamento automatico.
4. Clicca su Connect (Connetti). La piattaforma verifica di poter elencare e leggere ogni bucket selezionato prima di salvare qualsiasi cosa.

Ricollegare lo stesso utente IAM in seguito aggiunge nuovi bucket all'integrazione esistente. Una credenziale salvata viene sostituita solo se la nuova può ancora leggere ogni bucket che hai già collegato.

Una regione per connessione

Una connessione legge i bucket nella regione specificata. Se i tuoi bucket si trovano in più regioni, connettiti una volta per ogni regione.

Sicurezza delle credenziali

Le credenziali sono crittografate a riposo con AES-256-GCM, non vengono mai restituite al browser e non entrano mai nei payload dei processi di addestramento. Per revocare l'accesso, disattiva la chiave di accesso in AWS IAM.

Link to this sectionCrea un dataset da un bucket S3#

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.
• Suddivisioni (Splits) — i nomi delle cartelle train, val e test nella chiave dell'oggetto assegnano automaticamente le suddivisioni.

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 è associata al suo ETag oggetto S3 e la piattaforma si blocca se un oggetto viene modificato sottotraccia. 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 training. I worker scaricano gli originali associati in uno storage temporaneo per l'esecuzione e li rimuovono al termine del processo: le tue credenziali AWS non raggiungono mai l'infrastruttura di calcolo.

Link to this sectionLimitazioni attuali#

I dataset basati su S3 escludono attualmente funzionalità che richiedono copie delle immagini possedute dalla piattaforma: auto-annotazione, analisi di clustering, clonazione di dataset e snapshot di versione immutabili.

L'eliminazione di un dataset basato su S3, o di singole immagini in esso contenute, rimuove solo i riferimenti della piattaforma: i tuoi oggetti non vengono mai toccati.

Vedi anche le integrazioni con Google Cloud Storage e Azure Blob Storage.