Inté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, afin que tu puisses les parcourir, les annoter et entraîner des modèles YOLO sans en importer une copie.

Créer un utilisateur IAM en lecture seule#

Platform ne fait que lire depuis ton stockage — il n'écrit jamais dans tes objets, ne les modifie pas et ne les supprime pas. Utilise un utilisateur IAM dédié avec un accès limité à la liste et à la lecture — n'utilise jamais les identifiants root :

1. Dans la console AWS, accède à IAM > Users et crée un utilisateur sans accès à la console.

2. Associe une policy accordant uniquement un accès à la liste et à la lecture pour les buckets que tu veux 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:ListAllMyBuckets est facultatif — il permet à Platform de découvrir tes buckets pour que tu n'aies pas à saisir leurs noms.

3. Ouvre l'onglet Security credentials de l'utilisateur, crée une access key, puis copie l'ID de la clé d'accès et la clé d'accès secrète.

Se connecter à Platform#

1. Accède à Settings > Integrations et sélectionne Amazon S3 dans la liste des intégrations.
2. 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).
3. Clique sur Find available buckets, puis sélectionne les buckets à connecter. Si la policy n'autorise pas la découverte, saisis manuellement le nom d'un bucket connu.
4. Clique sur Connect. Platform vérifie qu’il peut répertorier et lire chaque bucket sélectionné avant d’enregistrer quoi que ce soit.

Tu dois avoir le rôle d'administrateur ou de propriétaire de l'espace de travail pour connecter un stockage cloud. Une connexion prend en charge jusqu'à 50 buckets, et la découverte répertorie jusqu'à 300 des buckets visibles par la clé.

Reconnecter ultérieurement le même utilisateur IAM ajoute les nouveaux buckets à l'intégration existante. Un identifiant enregistré est remplacé uniquement lorsque son remplaçant peut toujours lire chaque bucket que tu as déjà connecté.

Créer un jeu de données à partir d'un bucket S3#

1. Clique sur New Dataset et ouvre l’onglet Cloud.
2. Choisis un bucket connecté et accède au dossier contenant tes données.
3. Confirme le dossier, ajuste le nom du jeu de données, puis crée-le.

Platform répertorie le dossier une seule fois et indexe ce qu’il trouve :

• Images — Les objets .jpg, .jpeg, .png, .webp et .avif sont indexés avec les dimensions lues au moyen de requêtes limitées. Platform ne conserve pas de seconde copie de l’image source.
• Étiquettes — Les fichiers associés YOLO .txt sont analysés pour créer des annotations dans Platform, puis associés selon la structure standard images/ → labels/ ou en tant que fichiers voisins dans le même dossier.
• Métadonnées — Un fichier YAML fournit les noms des classes et la structure des points clés de pose, exactement comme lors d’un téléversement d’archive. data.yaml et data.yml sont privilégiés lorsque le dossier en contient plusieurs.
• Tâche — Un échantillon des fichiers d’étiquettes détermine la tâche ; les dossiers de segmentation, de pose et d’OBB sont donc reconnus à partir de la structure de leurs étiquettes plutôt que de la tâche choisie dans la boîte de dialogue.
• Splits — les noms de dossiers train, val et test dans la clé d'objet attribuent automatiquement les splits.

Le jeu de données se comporte ensuite comme n’importe quel autre : parcours-le et annote-le, rends-le public ou privé, partage-le avec ton équipe et entraîne des modèles 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 Platform.

Importations échouées#

Si une importation échoue — dossier vide, erreur de saisie dans le chemin ou autorisations révoquées — le jeu de données affiche l’erreur sur sa page. Les éditeurs peuvent cliquer sur Retry import pour la redémarrer avec le bucket et le dossier enregistrés, ou créer un nouveau jeu de données pointant vers le chemin corrigé.

Une nouvelle tentative réanalyse le dossier au lieu de reprendre l’opération : les objets ajoutés depuis la première tentative sont récupérés et ceux qui n’y sont plus sont supprimés du jeu de données.

Entraînement#

L'entraînement géré fonctionne via le flux d'entraînement normal. Pendant toute la durée de l'exécution, l'entraînement utilise les propres copies Platform des images associées, et tes identifiants AWS ne sont jamais exposés aux workloads d'entraînement.

Déconnecter une connexion#

La déconnexion supprime les identifiants enregistrés sans rien modifier dans AWS. Les jeux de données créés à partir de ces buckets restent dans ton espace de travail avec leurs classes, labels et annotations, mais leurs images ne peuvent pas être chargées, prévisualisées ou utilisées pour l'entraînement tant que le même utilisateur IAM n'est pas reconnecté.

Utilise la REST API avec l’identifiant d’intégration renvoyé par GET /api/integrations/buckets :

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/integrations/buckets/INTEGRATION_ID

from ultralytics_platform import Platform

client = Platform()  # reads ULTRALYTICS_API_KEY
integrations = client.storage_integrations.list()
client.storage_integrations.delete("INTEGRATION_ID")

Pour révoquer plutôt l'accès à la source, désactive ou supprime la clé d'accès dans AWS IAM.

Limites actuelles#

Les jeux de données adossés à S3 excluent actuellement les fonctionnalités qui nécessitent des copies de tes images détenues par Platform : annotation automatique, analyse de clustering, clonage de jeux de données et instantanés de versions immuables.

La suppression d'un jeu de données adossé à S3, ou d'images individuelles qui en font partie, supprime uniquement les références de Platform — tes objets ne sont jamais modifiés.

Voir également les intégrations Google Cloud Storage et Azure Blob Storage.

FAQ#