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, pour que tu puisses parcourir, annoter et entraîner des modèles YOLO sans en téléverser de copie.

Créer un utilisateur IAM en lecture seule#

Platform ne fait que lire les données de ton stockage — elle n’écrit, ne modifie ni ne supprime jamais tes objets. Utilise un utilisateur IAM dédié disposant uniquement d’un accès en lecture et de l’autorisation de lister les objets — n’utilise jamais les identifiants du compte root :

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

2. Associe une politique qui accorde uniquement des droits de lecture et de listage sur les compartiments 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é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’ID de la clé d’accès et la clé d’accès secrète.

Se connecter à Platform#

1. Va dans 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 compartiment (par exemple us-east-1).
3. Clique sur Find available buckets, puis sélectionne les compartiments à connecter. Si la politique n’autorise pas leur détection, saisis manuellement le nom d’un compartiment connu.
4. Clique sur Connecter. Avant d’enregistrer quoi que ce soit, Platform vérifie qu’elle peut lister et lire chaque bucket sélectionné.

Tu dois avoir le rôle d’administrateur ou de propriétaire de l’espace de travail pour connecter un stockage cloud. Une connexion peut inclure jusqu’à 50 compartiments, et la détection en répertorie jusqu’à 300 parmi ceux auxquels la clé donne accès.

Reconnecter ultérieurement le même utilisateur IAM ajoute de nouveaux compartiments à l’intégration existante. Un identifiant enregistré n’est remplacé que lorsque son remplaçant peut toujours lire tous les compartiments que tu as déjà connectés.

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é, puis accède au dossier contenant tes données.
3. Confirme le dossier, modifie le nom du jeu de données si nécessaire, puis crée le jeu de données.

Platform liste le contenu du dossier une seule fois et indexe les éléments trouvés :

• Images — Les objets .jpg, .jpeg, .png, .webp et .avif sont indexés, et leurs dimensions sont lues au moyen de requêtes limitées. Platform ne conserve pas de seconde copie de l’image source.
• Étiquettes — Les fichiers annexes YOLO .txt sont analysés pour créer des annotations dans Platform, selon l’organisation 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 forme des points clés de pose, comme pour un téléversement d’archive. Les fichiers data.yaml et data.yml sont prioritaires si 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 d’après la forme de leurs étiquettes, et non selon la tâche choisie dans la boîte de dialogue.
• Sous-ensembles — les noms de dossiers 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, l’annoter, le rendre public ou privé, le partager avec ton équipe et l’utiliser pour l’entraînement géré. Les originaux sont transférés à la demande, et les images indexées ne consomment pas ton quota de stockage Platform.

Échecs d’importation#

Si une importation échoue — dossier vide, erreur 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 bucket et le dossier enregistrés, ou créer un nouveau jeu de données pointant vers le chemin corrigé.

Une nouvelle tentative reliste 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 ne s’y trouvent plus sont retirés du jeu de données.

Entraînement#

L’entraînement géré suit le flux d’entraînement habituel. Pendant toute la durée de l’exécution, l’entraînement utilise les propres copies de Platform des images associé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, étiquettes et 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é.

Utilise l’API REST avec l’ID 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 directement à la source, désactive ou supprime plutôt la clé d’accès dans AWS IAM.

Limites actuelles#

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

La suppression d’un jeu de données adossé à S3, ou d’images individuelles qu’il contient, supprime uniquement les références de Platform — tes objets ne sont jamais modifiés.

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

FAQ#