Intégration Amazon S3#

L’intégration Amazon S3 connecte tes compartiments S3 à Ultralytics Platform. Tes images restent dans tes compartiments : Platform les indexe sur place afin que tu puisses les parcourir, les annoter et entraîner des modèles YOLO sans en importer de copie.

Créer un utilisateur IAM en lecture seule#

Platform ne fait que lire les données de ton stockage : il n’écrit, ne modifie et ne supprime jamais tes objets. Utilise un utilisateur IAM dédié avec un accès limité à l’énumération 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 stratégie qui accorde uniquement un accès à l’énumération et à la lecture pour les compartiments 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:ListAllMyBuckets est facultatif : il permet à Platform de détecter tes compartiments 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’identifiant et la clé secrète d’accès.

Se connecter à Platform#

1. Accède à Settings > Integrations et sélectionne Amazon S3 dans la liste des intégrations.
2. Saisis l’identifiant de la clé d’accès, la clé secrète d’accès et la région du compartiment (par exemple us-east-1).
3. Clique sur Find available buckets, puis sélectionne les compartiments à connecter. Si la stratégie n’autorise pas la détection, saisis manuellement le nom d’un compartiment connu.
4. Clique sur Connecter. Platform vérifie qu’elle peut afficher la liste 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. Tu peux ajouter jusqu’à 50 compartiments à la fois ; la détection répertorie jusqu’à 300 compartiments accessibles avec la clé.

Si tu reconnectes le même utilisateur IAM ultérieurement, de nouveaux compartiments sont ajoutés à l’intégration existante. Un identifiant enregistré n’est remplacé que si son remplaçant peut toujours lire tous les compartiments que tu as déjà connectés. Si un compartiment ne peut pas être lu, l’erreur indique son nom, y compris pour les compartiments connectés précédemment avec le même utilisateur IAM.

Créer un jeu de données à partir d’un compartiment S3#

1. Clique sur Nouveau jeu de données, puis 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 fois et indexe les éléments trouvés :

• Images — les objets .jpg, .jpeg, .png, .webp et .avif sont indexés ; leurs dimensions sont lues au moyen de requêtes limitées. Platform ne conserve pas de deuxième copie de l’image source.
• Labels — les fichiers annexes YOLO .txt sont analysés et convertis en annotations Platform, associées selon la structure standard images/ → labels/ ou comme fichiers frères dans le même dossier.
• Métadonnées — un fichier YAML fournit les noms de classes et la structure des points clés de pose, exactement comme lors d’un téléversement d’archive. Les fichiers data.yaml et data.yml sont prioritaires lorsque le dossier en contient plusieurs.
• Tâche — un échantillon des fichiers de labels détermine la tâche ; les dossiers de segmentation, de pose et OBB sont donc reconnus à partir de la structure de leurs labels, et non de la tâche choisie dans la boîte de dialogue.
• Sous-ensembles — Les noms de dossier train, val et test dans la clé d’objet attribuent automatiquement les sous-ensembles.

Le jeu de données fonctionne ensuite comme n’importe quel autre : tu peux le parcourir et l’annoter, le rendre public ou privé, le partager avec ton équipe et l’utiliser pour l’entraînement via l’entraînement géré. Les originaux sont transmis à la demande, et les images indexées ne consomment pas ton quota de stockage Platform.

Échecs d’importation#

Si une importation échoue — dossier vide, faute de frappe dans le chemin ou autorisations révoquées — le jeu de données affiche l’erreur sur sa page. Les éditeurs peuvent cliquer sur Réessayer l’importation pour la relancer avec le compartiment et le dossier enregistrés, ou créer un nouveau jeu de données en indiquant le chemin corrigé.

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

Entraînement#

L’entraînement géré s’effectue selon le flux d’entraînement habituel. Pendant l’exécution, l’entraînement utilise les propres copies par Platform des images épinglées, et tes identifiants AWS ne sont jamais exposés aux charges de travail d’entraînement.

Déconnecter une intégration#

La déconnexion supprime les identifiants enregistrés sans rien modifier dans AWS. Les jeux de données créés à partir de ces compartiments restent dans ton espace de travail avec leurs classes, leurs étiquettes et leurs annotations, mais leurs images ne peuvent pas être chargées, prévisualisées ni utilisées pour l’entraînement tant que le même utilisateur IAM n’est pas reconnecté. Tu peux toujours les renommer, modifier leurs étiquettes ou les supprimer lorsqu’ils sont déconnectés.

Pour te déconnecter, accède à Settings > Integrations, sélectionne Amazon S3, clique sur Disconnect à côté de l’identifiant, puis confirme. Si tu ouvres l’un de ses jeux de données, le message Amazon S3 Disconnected s’affiche, avec un lien vers ces paramètres. Le jeu de données redevient automatiquement accessible une fois la connexion rétablie.

Tu peux aussi te déconnecter avec l’API REST, en utilisant 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 l’accès à la source, désactive ou supprime plutôt la clé d’accès dans AWS IAM.

Limites actuelles#

Les jeux de données associés à S3 ne prennent actuellement pas en charge les fonctionnalités qui nécessitent des copies de tes images détenues par Platform : l’annotation automatique, l’analyse de regroupement, le clonage de jeux de données et les instantanés de version immuables.

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

Consulte aussi les intégrations Google Cloud Storage et Azure Blob Storage.

FAQ#