翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon S3 Files ボリューム

S3 ファイルを使用すると、Amazon Simple Storage Service (Amazon S3) バケットに保存されているデータに直接ファイルシステムにアクセスできます。を使用すると AWS Batch、ジョブ定義で S3 ファイルボリュームを定義して、コンテナが標準のファイルオペレーションを使用して Amazon S3 データを読み書きできるようにします。

S3 Files ボリュームを使用するには、コンピューティング環境と同じ VPC AWS Batch に設定された S3 ファイルシステムとマウントターゲットが必要です。バケット設定、IAM ロール、ファイルシステムの作成、マウントターゲットなどの完全なセットアップ手順については、「Amazon S3 ユーザーガイド」の「S3 Files prerequisites」および「Amazon Elastic Container Service デベロッパーガイド」の「Configuring S3 Files for Amazon ECS」を参照してください。 Amazon S3

Amazon S3 Files ボリュームに関する考慮事項

S3 Files ボリュームを使用する場合は、次の点を考慮してください。

Amazon S3 Files アクセスポイントを使用する

S3 Files アクセスポイントは、すべてのファイルシステムリクエストに POSIX ユーザー ID とルートディレクトリを適用する、ファイルシステムへのアプリケーション固有のエントリポイントです。アクセスポイントを使用してテナントを分離できるため、各ジョブは共有ファイルシステム内の独自のディレクトリにのみアクセスできます。

アクセスポイントの作成と管理の詳細については、「Amazon S3 ユーザーガイド」の「S3 ファイルシステムのアクセスポイントの作成」を参照してください。 Amazon S3 ファイルシステムポリシーを使用してアクセスポイントの分離を適用する方法の詳細については、Amazon S3 ユーザーガイドの「S3 ファイルが IAM と連携する方法」を参照してください。 Amazon S3

ジョブ定義で Amazon S3 ファイルファイルシステムを指定する

コンテナに S3 Files ボリュームを使用するには、ジョブ定義でボリュームとマウントポイントの設定を指定する必要があります。次のジョブ定義の JSON スニペットは、コンテナの [volumes] と [mountPoints] オブジェクトの構文を示します。

{
    "ecsProperties": {
        "taskProperties": [
            {
                ...,
                "taskRoleArn": "arn:aws:iam::<account>:role/<job-role-name>",
                "containers": [
                    {
                        ...,
                        "mountPoints": [
                            {
                                "sourceVolume": "myS3FilesVolume",
                                "containerPath": "/mnt/s3data",
                                "readOnly": false
                            }
                        ]
                    }
                ],
                "volumes": [
                    {
                        "name": "myS3FilesVolume",
                        "s3filesVolumeConfiguration": {
                            "fileSystemArn": "arn:aws:s3files:<region>:<account>:file-system/<fs-id>",
                            "rootDirectory": "/keypath/in/s3"
                        }
                    }
                ]
            }
        ]
    }
}

AWS Batch および Amazon EKS で S3 ファイルボリュームを使用する

Amazon EKS リソースを使用するジョブの場合、 は EKS ジョブ定義ボリューム設定の を通じて S3 ファイルボリューム AWS Batch をサポートします。 persistentVolumeClaimジョブ定義で参照する前に、Amazon EKS クラスターで永続ボリュームと永続ボリュームクレームを事前に作成する必要があります。

次のジョブ定義スニペットは、S3 Files 永続ボリュームクレームを参照する方法を示しています。

{
    "eksProperties": {
        "podProperties": {
            ...,
            "containers": [
                {
                    ...,
                    "volumeMounts": [
                        {
                            "name": "s3files-vol",
                            "mountPath": "/mnt/s3data"
                        }
                    ]
                }
            ],
            "volumes": [
                {
                    "name": "s3files-vol",
                    "persistentVolumeClaim": {
                        "claimName": "<s3files-pvc-name>"
                    }
                }
            ]
        }
    }
}

Amazon EKS で S3 ファイルを設定する方法の詳細については、「Amazon S3 ユーザーガイド」の「Amazon EKS での S3 ファイルシステムのマウント」を参照してください。 Amazon S3 フルボリュームパラメータリファレンスについては、 AWS Batch API リファレンスのEksVolume」を参照してください。