Link to this sectionIntégration Amazon S3#
L'intégration Amazon S3 connecte tes buckets S3 à Ultralytics Platform. Tes images restent dans tes buckets — Platform les indexe sur place, ce qui te permet de parcourir, d'annoter et d'entraîner des modèles YOLO sans avoir à télécharger une copie.
Les jeux de données Amazon S3 nécessitent un forfait Pro ou Enterprise. Les espaces de travail gratuits voient l'intégration et sont invités à passer à la version supérieure lors de la connexion. Les jeux de données Amazon S3 existants restent entièrement accessibles si un abonnement prend fin — seuls les nouvelles connexions et les imports nécessitent le forfait Pro.
Link to this sectionCréer un utilisateur IAM en lecture seule#
Platform ne fait que lire tes données de stockage — il ne modifie, ne supprime ni n'écrit jamais tes objets. Utilise un utilisateur IAM dédié avec un accès en lecture et en liste uniquement — n'utilise jamais les identifiants root :
-
Dans la console AWS, va dans IAM > Users et crée un utilisateur sans accès à la console.
-
Attache une politique n'accordant que les accès en liste et en lecture aux buckets que tu souhaites connecter :
{ "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:ListAllMyBucketsest facultatif — il permet à Platform de découvrir tes buckets afin que tu n'aies pas à saisir leurs noms manuellement. -
Ouvre l'onglet Security credentials de l'utilisateur, crée une access key, et copie l'ID de la clé d'accès ainsi que la clé d'accès secrète.
Link to this sectionSe connecter à la Platform#
- Va dans Settings > Integrations et trouve la carte Amazon S3.
- Clique sur Connect et saisis l'ID de la clé d'accès, la clé d'accès secrète, et la région du bucket (par exemple
us-east-1). - Platform liste les buckets que les identifiants peuvent lire. Sélectionne ceux à connecter, ou saisis manuellement le nom d'un bucket si la politique ne permet pas la découverte.
- Clique sur Connect. La Platform vérifie qu'elle peut lister et lire chaque bucket sélectionné avant de sauvegarder quoi que ce soit.
Reconnecter le même utilisateur IAM plus tard ajoute de nouveaux buckets à l'intégration existante. Une clé enregistrée n'est remplacée que si son remplaçant peut toujours lire chaque bucket déjà connecté.
Une connexion lit les buckets dans la région que tu saisis. Si tes buckets sont répartis dans plusieurs régions, connecte-toi une fois par région.
Les identifiants sont chiffrés au repos avec AES-256-GCM, ne sont jamais renvoyés au navigateur, et n'entrent jamais dans les charges utiles des tâches d'entraînement. Pour révoquer l'accès, désactive la clé d'accès dans AWS IAM.
Link to this sectionCréer un jeu de données à partir d'un bucket S3#
- Clique sur New Dataset et ouvre l'onglet Cloud storage.
- Choisis un bucket connecté et navigue jusqu'au dossier contenant tes données.
- Confirme le dossier, ajuste le nom du jeu de données et crée-le.
Platform liste le dossier une fois et indexe ce qu'elle trouve :
- Images — les objets
.jpg,.jpeg,.png,.webpet.avifsont indexés avec des dimensions lues à partir de requêtes d'en-tête bornées. Les pixels sources ne sont jamais copiés en dehors de ton bucket. - Labels — les fichiers sidecar YOLO
.txtsont analysés en tant qu'annotations Platform, mis en correspondance par la disposition standardimages/→labels/ou en tant que fichiers frères dans le même dossier. - Metadata — un fichier
data.yaml/data.ymlfournit les noms des classes, le type de tâche et la forme des keypoints de pose, exactement comme pour un téléchargement d'archive. - Splits — Les noms de dossiers
train,val, ettestdans la clé d'objet attribuent automatiquement les splits.
Le dataset se comporte ensuite comme n'importe quel autre : parcours et annote-le, définis-le comme public ou privé, partage-le avec ton équipe, et entraîne-toi dessus via l'entraînement géré. Les originaux sont diffusés à la demande, et les images indexées ne consomment pas ton quota de stockage sur la Platform.
Une seule importation indexe jusqu'à 50 000 objets, et les fichiers de labels ou YAML jusqu'à 1 Mo chacun. Les buckets plus volumineux devraient être répartis sur plusieurs datasets.
Chaque image indexée est liée à son ETag d'objet S3, et Platform refuse l'opération si un objet est modifié en arrière-plan. Ajoute de nouveaux objets au lieu d'écraser ceux qui existent déjà.
Link to this sectionImportations échouées#
Si une importation échoue — dossier vide, faute de frappe dans le chemin ou permissions révoquées — le dataset affiche l'erreur sur sa page. Les éditeurs peuvent cliquer sur Retry import pour recommencer avec le bucket et le dossier enregistrés, ou créer un nouveau dataset pointant vers le chemin corrigé.
Link to this sectionEntraînement#
L'entraînement géré fonctionne via le flux d'entraînement standard. Les workers téléchargent les originaux liés dans le stockage temporaire de la tâche pour l'exécution et les suppriment lors du nettoyage de la tâche — tes identifiants AWS n'atteignent jamais le calcul.
Link to this sectionLimitations actuelles#
Les jeux de données basés sur S3 excluent actuellement les fonctionnalités qui nécessitent des copies de tes images détenues par Platform : l'annotation automatique, l'analyse de clustering, le clonage de jeux de données, et les instantanés de version immuables.
Supprimer un jeu de données basé sur S3, ou des images individuelles qu'il contient, ne supprime que les références de Platform — tes objets ne sont jamais touchés.
Consulte également les intégrations Google Cloud Storage et Azure Blob Storage.