Amazon S3インテグレーション#

Amazon S3インテグレーションを使うと、S3バケットをUltralytics Platformに接続できます。画像はバケット内に保持され、Platformはその場でインデックス化するため、コピーをアップロードせずにYOLOモデルの閲覧、アノテーション、トレーニングを行えます。

読み取り専用IAMユーザーを作成する#

Platformはストレージから読み取りのみを行い、オブジェクトへの書き込み、変更、削除は一切行いません。ルート認証情報は使用せず、一覧表示と読み取りのみのアクセス権を持つ専用のIAMユーザーを使用してください。

1. AWSコンソールで IAM > Users に移動し、コンソールアクセス権のないユーザーを作成します。

2. 接続するバケットに対して、一覧表示と読み取りのみを許可するポリシーをアタッチします。

   {
       "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 は任意です。設定すると、バケット名を入力しなくてもPlatformがバケットを検出できます。

3. ユーザーの Security credentials タブを開き、access key を作成して、アクセスキーIDとシークレットアクセスキーをコピーします。

Platformに接続する#

1. Settings > Integrations に移動し、インテグレーション一覧から Amazon S3 を選択します。
2. アクセスキーID、シークレットアクセスキー、バケットのリージョン（例：us-east-1）を入力します。
3. Find available buckets をクリックし、接続するバケットを選択します。ポリシーで検出が許可されていない場合は、 既知のバケット名を手動で入力してください。
4. Connectをクリックします。Platformは設定を保存する前に、選択した各バケットの一覧取得と読み取りが可能かを確認します。

クラウドストレージを接続するには、ワークスペースの管理者またはオーナーのロールが必要です。一度に最大50個のバケットを追加でき、検出ではキーから参照できるバケットのうち最大300個が一覧表示されます。

後から同じIAMユーザーを再接続すると、既存のインテグレーションに新しいバケットが追加されます。保存済みの認証情報は、置き換え後も接続済みのすべてのバケットを読み取れる場合にのみ更新されます。読み取れないバケットがある場合は、同じIAMユーザーで以前に接続したバケットを含め、そのバケット名がエラーに表示されます。

S3バケットからデータセットを作成する#

1. New Datasetをクリックし、Cloudタブを開きます。
2. 接続済みのバケットを選択し、データを含むフォルダーを開きます。
3. フォルダーを確定し、データセット名を調整して、データセットを作成します。

Platformはフォルダーの一覧を一度取得し、見つかった内容をインデックス化します。

• 画像 — .jpg、.jpeg、.png、.webp、.avifの各オブジェクトをインデックス化し、上限付きリクエストで寸法を読み取ります。Platformはソース画像のコピーを別途保存しません。
• ラベル — YOLOの.txtサイドカーファイルを解析してPlatformのアノテーションに変換し、標準的なimages/ → labels/の構成、または同じフォルダー内のファイルとして対応付けます。
• メタデータ — YAMLファイルからクラス名とポーズのキーポイント形状を取得します。これはアーカイブのアップロードと同じです。フォルダーに複数のYAMLファイルがある場合は、data.yamlとdata.ymlが優先されます。
• タスク — ラベルファイルのサンプルからタスクを判定するため、ダイアログで選択したタスクではなく、ラベルの形状に基づいてセグメンテーション、ポーズ、OBBのフォルダーを認識します。
• 分割 — オブジェクトキー内のフォルダー名 train、val、test に基づき、データ分割が自動的に割り当てられます。

作成したデータセットは、他のデータセットと同様に利用できます。閲覧やアノテーション、公開・非公開の設定、チームとの共有、マネージドトレーニングによるトレーニングが可能です。元画像は必要に応じてストリーミングされ、インデックス化された画像はPlatformのストレージクォータを消費しません。

インポートの失敗#

空のフォルダー、パスの入力ミス、権限の取り消しなどが原因でインポートに失敗すると、データセットのページにエラーが表示されます。編集者は Retry import をクリックすると、保存済みのバケットとフォルダーを使って再試行できます。または、修正したパスを指定して新しいデータセットを作成できます。

再試行では処理を再開せず、フォルダーを再度一覧表示します。最初の試行以降に追加されたオブジェクトは取り込まれ、すでに存在しないオブジェクトはデータセットから除外されます。

トレーニング#

マネージドトレーニングは通常のトレーニングフローで実行できます。トレーニングでは実行中のみ、固定された画像のPlatform独自のコピーを使用し、AWSの認証情報がトレーニングのワークロードに公開されることはありません。

接続を解除する#

接続を解除すると、保存済みの認証情報が削除されますが、AWS上のデータには影響しません。それらのバケットから作成したデータセットは、クラス、ラベル、アノテーションとともにワークスペースに残りますが、同じIAMユーザーを再接続するまで画像の読み込み、プレビュー、トレーニングはできません。接続解除中も、データセット名の変更、ラベルの編集、データセットの削除は可能です。

接続を解除するには、Settings > Integrations に移動し、Amazon S3 を選択して、認証情報の横にある Disconnect をクリックし、確認します。そのデータセットを開くと、これらの設定へのリンクとともに Amazon S3 Disconnected と表示されます。再接続すると、データセットは自動的に再び利用可能になります。

REST APIを使って接続を解除することもできます。その際は、GET /api/integrations/buckets が返すインテグレーションIDを使用します。

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")

接続元でアクセスを取り消すには、AWS IAMでアクセスキーを無効化または削除してください。

現在の制限事項#

S3連携データセットでは、画像のPlatform所有コピーを必要とする機能（自動アノテーション、クラスタリング分析、データセットの複製、変更不可のバージョンスナップショット）は現在利用できません。

S3連携データセット、またはその個別画像を削除しても、Platformの参照情報のみが削除され、オブジェクトには一切触れません。

Google Cloud StorageおよびAzure Blob Storageのインテグレーションもご覧ください。

よくある質問#