本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
将您的文件系统关联到 S3 存储桶
您可以将适用于 Lustre 的 Amazon FSx 文件系统链接到亚马逊 S3 中的数据存储库。可以在创建文件系统时创建链接,也可以在创建文件系统之后的任何时候创建链接。
文件系统上的目录与 S3 存储桶或前缀之间的链接称为数据存储库关联 (DRA)。在 FSx for Lustre 文件系统上,您最多可以配置 8 个数据存储库关联。最多可以排队 8 个 DRA 请求,但对于文件系统,一次只能处理一个请求。每个 DRA 都必须有一个唯一的 FSx for Lustre 文件系统目录以及与之关联的唯一的 S3 存储桶或前缀。
注意
FSx for Lustre 2.10 文件系统不支持数据存储库关联、自动导出和对多个数据存储库的支持或Scratch 1
文件系统。
要将 S3 数据存储库中的对象作为文件系统上的文件和目录进行访问,必须将文件和目录元数据加载到文件系统中。您可以在创建 DRA 时从链接的数据存储库加载元数据,或者稍后使用导入数据存储库任务加载要使用 FSx for Lustre 文件系统访问的批量文件和目录的元数据,或者使用自动导出在数据存储库中添加对象、更改对象或从数据存储库中删除对象时自动加载元数据。
您可以将 DRA 配置为仅用于自动导入、仅用于自动导出或两者兼而有之。配置了自动导入和自动导出的数据存储库关联可在文件系统和链接的 S3 存储桶之间双向传播数据。当您更改 S3 数据存储库中的数据时,FSx for Lustre 会检测到更改,然后自动将更改导入您的文件系统。在您创建、修改或删除文件时,FSx for Lustre 会在应用程序完成文件修改后自动将更改异步导出到 Amazon S3。
重要
如果您修改文件系统和 S3 存储桶中的同一个文件,则应确保应用程序级别的协调以防止冲突。FSx for Lustre 无法防止在多个位置发生冲突的写入。
创建数据存储库关联时,可以配置以下属性:
-
文件系统路径— 在文件系统上输入指向目录的本地路径(例如
/ns1/
) 或子目录(例如/ns1/subdir/
) 将被映射 one-to-one 指定的数据存储库路径如下。名称中的前导正斜杠必填。两个数据存储库关联不能具有重叠的文件系统路径。例如,如果数据存储库与文件系统路径/ns1
相关联,则您无法将另一个数据存储库与文件系统路径/ns1/ns2
相关联。注意
如果您仅指定正斜杠 (
/
) 作为文件系统路径,则只能将一个数据存储库链接到文件系统。您只能将“/”指定为与文件系统相关联的第一个数据存储库的文件系统路径。 -
数据存储库路径— 输入 S3 数据存储库中的路径。该路径可以是 S3 存储桶或格式
s3://myBucket/myPrefix/
的前缀。此属性指定文件将从 S3 数据存储库中的哪个位置导入或导出到。如果您不提供尾随的 “/”,FSx for Lustre 将在您的数据存储库路径后面追加一个 “/”。例如,如果您提供的数据存储库路径为s3://myBucket/myPrefix
,FSx for Lustre 会将其解释为s3://myBucket/myPrefix/
。两个数据存储库关联不能有重叠的数据存储库路径。例如,如果一个带路径的数据存储库
s3://myBucket/myPrefix/
已链接到文件系统,则无法使用数据存储库路径创建其他数据存储库关联s3://myBucket/myPrefix/mySubPrefix
。 -
从存储库导入元数据— 您可以选择此选项,在创建数据存储库关联后立即从整个数据存储库导入元数据。或者,您可以在创建数据存储库关联后随时运行导入数据存储库任务,将链接的数据存储库中的全部或部分元数据加载到文件系统中。
-
导入设置— 选择一个导入策略,该策略指定将自动从链接的 S3 存储桶导入文件系统的已更新对象的类型(新的、更改的和删除的任意组合)。从控制台添加数据存储库时,自动导入(新建、已更改、已删除)默认处于启用状态,但在使用控制台时默认处于禁用状态Amazon CLI或者亚马逊 fsX API。
-
导出设置— 选择一个导出策略,该策略指定将自动导出到 S3 存储桶的更新对象的类型(新的、更改的和删除的任意组合)。从控制台添加数据存储库时,自动导出(新建、已更改、已删除)默认处于启用状态,但在使用控制台时默认处于禁用状态Amazon CLI或者亚马逊 fsX API。
的文件系统路径和数据存储库路径设置提供了 Amazon FSx 中的路径和 S3 中的对象密钥之间的 1:1 映射。
关联的 S3 存储桶的区域和账户支持
创建指向 S3 存储桶的链接时,请记住以下区域和账户支持限制:
-
自动导出支持跨区域配置。Amazon FSx 文件系统和链接的 S3 存储桶可以位于同一个存储桶中Amazon Web Services 区域或者是不同的Amazon Web Services 区域。
-
自动导入不支持跨区域配置。Amazon FSx 文件系统和链接的 S3 存储桶必须位于同一个存储桶中Amazon Web Services 区域。
-
自动导出和自动导入都支持跨账户配置。Amazon FSx 文件系统和关联的 S3 存储桶可以属于同一个存储桶Amazon Web Services 账户或者是不同的Amazon Web Services 账户。
创建指向 S3 存储桶的链接
以下过程将引导您完成为 FSx for Lustre 文件系统创建数据存储库与现有 S3 存储桶关联的过程,使用了Amazon Web Services Management Console和Amazon Command Line Interface(Amazon CLI)。有关向 S3 存储桶添加权限以将其链接到您的文件系统的信息,请参阅在 Amazon S3 中添加使用数据存储库的权限。
注意
数据存储库不能链接到启用了文件系统备份的文件系统。在链接到数据存储库之前禁用备份。
打开亚马逊 FSx 控制台,网址为https://console.aws.amazon.com/fsx/
。 按照中描述的创建新文件系统的步骤进行操作第 1 步:创建适用于 Lustre 文件系统的亚马逊 FSx在 “入门” 部分中。
打开数据存储库导入/导出-可选的部分。默认情况下,该功能处于禁用状态。
选择从 S3 导入数据和将数据导出到 S3。
-
在数据存储库关联信息对话框中,为以下字段提供信息。
-
文件系统路径: 输入高级目录的名称(例如
/ns1
) 或子目录(例如/ns1/subdir
) 在将与 S3 数据存储库关联的 Amazon FSx 文件系统中。路径中的前斜杠为必填项。两个数据存储库关联不能具有重叠的文件系统路径。例如,如果数据存储库与文件系统路径/ns1
相关联,则您无法将另一个数据存储库与文件系统路径/ns1/ns2
相关联。的文件系统路径在文件系统的所有数据存储库关联中,设置必须是唯一的。 -
数据存储库路径:输入要与您的文件系统关联的现有 S3 存储桶或前缀的路径(例如,
s3://my-bucket/my-prefix/
)。两个数据存储库关联不能有重叠的数据存储库路径。例如,如果数据存储库的路径为s3://myBucket/myPrefix/
已链接到文件系统,则无法使用该数据存储库路径创建其他数据存储库关联s3://myBucket/myPrefix/mySubPrefix
。的数据存储库路径在文件系统的所有数据存储库关联中,设置必须是唯一的。 -
从存储库导入元数据:选择此属性可以选择运行导入数据存储库任务,以便在创建链接后立即导入元数据。
-
-
对于导入设置-可选,设置一个导入政策这决定了您在添加、更改或删除 S3 存储桶中的对象时如何保持文件和目录列表的最新状态。例如,选择全新将在 S3 存储桶中创建的新对象的元数据导入文件系统。有关导入策略的更多信息,请参阅自动从 S3 存储桶导入更新。
-
对于出口政策,设置导出策略,该策略决定当您在文件系统中添加、更改或删除对象时,如何将文件导出到链接的 S3 存储桶。例如,选择已更改导出文件系统中内容或元数据已发生更改的对象。有关导出政策的更多信息,请参阅自动将更新导出到您的 S3 存储桶。
-
继续执行文件系统创建向导的下一部分。
打开亚马逊 FSx 控制台,网址为https://console.aws.amazon.com/fsx/
。 -
在仪表板中,选择文件系统,然后选择要为其创建数据存储库关联的文件系统。
-
选择数据存储库选项卡。
-
在数据存储库关联窗格中,选择创建数据存储库关联。
-
在数据存储库关联信息对话框中,为以下字段提供信息。
-
文件系统路径: 输入高级目录的名称(例如
/ns1
) 或子目录(例如/ns1/subdir
) 在将与 S3 数据存储库关联的 Amazon FSx 文件系统中。路径中的前斜杠为必填项。两个数据存储库关联不能具有重叠的文件系统路径。例如,如果数据存储库与文件系统路径/ns1
相关联,则您无法将另一个数据存储库与文件系统路径/ns1/ns2
相关联。的文件系统路径在文件系统的所有数据存储库关联中,设置必须是唯一的。 -
数据存储库路径:输入要与您的文件系统关联的现有 S3 存储桶或前缀的路径(例如,
s3://my-bucket/my-prefix/
)。两个数据存储库关联不能有重叠的数据存储库路径。例如,如果一个带路径的数据存储库s3://myBucket/myPrefix/
已链接到文件系统,则无法使用数据存储库路径创建其他数据存储库关联s3://myBucket/myPrefix/mySubPrefix
。的数据存储库路径在文件系统的所有数据存储库关联中,设置必须是唯一的。 -
从存储库导入元数据:选择此属性可以选择运行导入数据存储库任务,以便在创建链接后立即导入元数据。
-
-
对于导入设置-可选,设置一个导入政策这决定了您在添加、更改或删除 S3 存储桶中的对象时如何保持文件和目录列表的最新状态。例如,选择全新将在 S3 存储桶中创建的新对象的元数据导入文件系统。有关导入策略的更多信息,请参阅自动从 S3 存储桶导入更新。
-
对于出口政策,设置导出策略,该策略决定当您在文件系统中添加、更改或删除对象时,如何将文件导出到链接的 S3 存储桶。例如,选择已更改导出文件系统中内容或元数据已发生更改的对象。有关导出政策的更多信息,请参阅自动将更新导出到您的 S3 存储桶。
-
选择创建。
以下示例创建了一个将 Amazon FSx 文件系统链接到 S3 存储桶的数据存储库关联,其导入策略用于将任何新文件或更改文件导入文件系统,以及将新、更改或删除的文件导出到链接的 S3 存储桶的导出策略。
-
要创建数据存储库关联,请使用 Amazon FSx CLI 命令
create-data-repository-association
,如下所示。$
aws fsx create-data-repository-association \ --file-system-id fs-0123456789abcdef0 \ --file-system-path /ns1/path1/ \ --data-repository-path s3://mybucket/myprefix/ \ --s3 "AutoImportPolicy={Events=[NEW,CHANGED,DELETED]},AutoExportPolicy={Events=[NEW,CHANGED,DELETED]}"
亚马逊 FSx 会立即返回 DRA 的 JSON 描述。DRA 是异步创建的。
即使在文件系统完成创建之前,也可以使用此命令创建数据存储库关联。请求将排队,并在文件系统可用后创建数据存储库关联。
更新数据存储库关联设置
您可以使用更新现有数据存储库关联的设置Amazon Web Services Management Console,Amazon CLI,以及亚马逊 FSx API,如以下过程所示。
注意
您无法更新File system path
要么Data repository
path
创建 DRA 之后的。如果你想改变File
system path
要么Data repository path
,则必须删除 DRA 并重新创建。
打开亚马逊 FSx 控制台,网址为https://console.aws.amazon.com/fsx/
。 -
在仪表板中,选择文件系统,然后选择要管理的文件系统。
-
选择数据存储库选项卡。
-
在数据存储库关联窗格中,选择要更改的数据存储库关联。
-
选择更新。将显示数据存储库关联的编辑对话框。
-
对于导入设置-可选,你可以更新你的导入政策。有关导入策略的更多信息,请参阅自动从 S3 存储桶导入更新。
-
对于导出设置-可选,您可以更新您的导出政策。有关出口政策的更多信息,请参阅自动将更新导出到您的 S3 存储桶。
-
选择更新。
-
要更新数据存储库关联,请使用 Amazon FSx CLI 命令
update-data-repository-association
,如下所示。$
aws fsx update-data-repository-association \ --association-id 'dra-872abab4b4503bfc2' \ --s3 "AutoImportPolicy={Events=[NEW,CHANGED,DELETED]},AutoExportPolicy={Events=[NEW,CHANGED,DELETED]}"
成功更新数据存储库关联的导入和导出策略后,Amazon FSx 以 JSON 格式返回更新后的数据存储库关联的描述。
删除与 S3 存储桶的关联
以下过程将引导您完成从现有 Amazon FSx 文件系统中删除与现有 S3 存储桶之间的数据存储库关联的过程,使用Amazon Web Services Management Console和Amazon Command Line Interface(Amazon CLI)。删除数据存储库关联会取消文件系统与 S3 存储桶的链接。
打开亚马逊 FSx 控制台,网址为https://console.aws.amazon.com/fsx/
。 -
在仪表板中,选择文件系统,然后选择要从中删除数据存储库关联的文件系统。
-
选择数据存储库选项卡。
-
在数据存储库关联窗格中,选择要删除的数据存储库关联。
-
对于行动,选择删除关联。
-
(可选)在删除对话框,你可以选择删除文件系统中的数据以物理方式删除文件系统中与数据存储库关联相对应的数据。
-
选择删除从文件系统中删除数据存储库关联。
以下示例删除将 Amazon FSx 文件系统链接到 S3 存储桶的数据存储库关联。的--association-id
参数指定要删除的数据存储库关联的 ID。
-
要删除数据存储库关联,请使用 Amazon FSx CLI 命令
delete-data-repository-association
,如下所示。$
aws fsx delete-data-repository-association \ --association-id dra-872abab4b4503bfc \ --delete-data-in-file-system false
成功删除数据存储库关联后,Amazon FSx 会将其描述返回为 JSON。
查看数据存储库关联详细信息
您可以使用 FSx for Lustre 控制台查看数据存储库关联的详细信息,Amazon CLI,还有 API。详细信息包括 DRA 的关联 ID、文件系统路径、数据存储库路径、导入设置、导出设置、状态及其关联文件系统的 ID。
-
打开亚马逊 FSx 控制台,网址为https://console.aws.amazon.com/fsx/
。 -
在仪表板中,选择文件系统,然后选择要查看其数据存储库关联详细信息的文件系统。
-
选择数据存储库选项卡。
-
在数据存储库关联窗格中,选择要查看的数据存储库关联。的摘要此时将显示页面,显示 DRA 的详细信息。
-
要查看特定数据存储库关联的详细信息,请使用 Amazon FSx CLI 命令
describe-data-repository-associations
,如下所示。$
aws fsx describe-data-repository-associations \ --association-ids dra-872abab4b4503bfc2Amazon FSx 以 JSON 格式返回对数据存储库关联的描述。
数据存储库关联生命周期状态
数据存储库关联生命周期状态提供有关特定 DRA 的状态信息。数据存储库关联可以具有以下内容生命周期状态:
-
正在创建— Amazon FSx 正在文件系统和链接的数据存储库之间创建数据存储库关联。数据存储库不可用。
-
可用— 数据存储库关联可供使用。
-
正在更新— 数据存储库关联正在进行客户启动的更新,这可能会影响其可用性。
-
正在删除— 数据存储库关联正在由客户发起的删除。
-
配置错误— 在更正数据存储库关联配置之前,Amazon FSx 无法自动从 S3 存储桶导入更新或自动将更新导出到 S3 存储桶。
-
失败了— 数据存储库关联处于无法恢复的终端状态(例如,因为其文件系统路径已删除或 S3 存储桶已删除)。
您可以使用 Amazon FSx 控制台查看数据存储库关联的生命周期状态Amazon Command Line Interface,还有亚马逊 FSx API。有关更多信息,请参阅查看数据存储库关联详细信息:
使用服务器端加密的 Amazon S3 存储桶
FSx for Lustre 支持 Amazon S3 存储桶,该存储桶使用服务器端加密和 S3 托管密钥 (SSE-S3),以及Amazon KMS keys存储在Amazon Key Management Service(SSE-KMS)。
如果您希望 Amazon FSx 在写入您的 S3 存储桶时对数据进行加密,则需要将 S3 存储桶上的默认加密设置为 SSE-S3 或 SSE-KMS。有关更多信息,请参阅配置默认加密在亚马逊 S3 用户指南。将文件写入您的 S3 存储桶时,Amazon FSx 会遵循您的 S3 存储桶的默认加密策略。
默认情况下,亚马逊 FSx 支持使用 SSE-S3 加密的 S3 存储桶。如果您想将您的 Amazon FSx 文件系统链接到使用 SSE-KMS 加密的 S3 存储桶,则需要在客户托管密钥策略中添加声明,允许 Amazon FSx 使用您的 KMS 密钥加密和解密 S3 存储桶中的对象。
以下语句允许特定的 Amazon FSx 文件系统加密和解密特定 S3 存储桶的对象,存储桶名称
。
{ "Sid": "Allow access through S3 for the FSx SLR to use the KMS key on the objects in the given S3 bucket", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::
aws_account_id
:role/aws-service-role/s3.data-source.lustre.fsx.amazonaws.com/AWSServiceRoleForFSxS3Access_fsx_file_system_id
" }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:GenerateDataKey*", "kms:DescribeKey" ], "Resource": "*", "Condition": { "StringEquals": { "kms:CallerAccount": "aws_account_id
", "kms:ViaService": "s3.bucket-region
.amazonaws.com" }, "StringLike": { "kms:EncryptionContext:aws:s3:arn": "arn:aws:s3:::bucket_name
/*" } } }
注意
如果您使用带有 CMK 的 KMS 在启用了 S3 存储桶密钥的情况下加密您的 S3 存储桶,请设置EncryptionContext
发送到存储桶 ARN,而不是对象 ARN,如以下示例所示:
"StringLike": { "kms:EncryptionContext:aws:s3:arn": "arn:aws:s3:::
bucket_name
" }
以下政策声明允许您账户中的所有 Amazon FSx 文件系统链接到特定的 S3 存储桶。
{ "Sid": "Allow access through S3 for the FSx SLR to use the KMS key on the objects in the given S3 bucket", "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:GenerateDataKey*", "kms:DescribeKey" ], "Resource": "*", "Condition": { "StringEquals": { "kms:CallerAccount": "
aws_account_id
", "kms:ViaService": "s3.bucket-region
.amazonaws.com" }, "StringLike": { "aws:userid": "*:FSx", "kms:EncryptionContext:aws:s3:arn": "arn:aws:s3:::bucket_name
/*" } } }
通过其他方式访问服务器端加密的 Amazon S3 存储桶Amazon Web Services 账户
在创建链接到加密的 Amazon S3 存储桶的 FSx for Lustre 文件系统后,您必须授予AWSServiceRoleForFSxS3Access_
在从链接的 S3 存储桶读取或写入数据之前,服务关联角色 (SLR) 访问用于加密 S3 存储桶的 KMS 密钥。您可以使用已拥有 KMS 密钥权限的 IAM 角色。fs-01234567890
注意
此 IAM 角色必须位于创建 FSx for Lustre 文件系统的账户中(与 S3 SLR 的账户相同),而不是 KMS 密钥/S3 存储桶所属的账户中。
您可以使用 IAM 角色调用以下内容Amazon KMS用于为 S3 SLR 创建授权的 API,以便 SLR 获得对 S3 对象的权限。要查找与您的 SLR 关联的 ARN,请使用您的文件系统 ID 作为搜索字符串搜索您的 IAM 角色。
$
aws kms create-grant --regionfs_account_region
\ --key-id arn:aws:kms:s3_bucket_account_region
:s3_bucket_account
:key/key_id
\ --grantee-principal arn:aws:iam::fs_account_id
:role/aws-service-role/s3.data-source.lustre.fsx.amazonaws.com/AWSServiceRoleForFSxS3Access_file-system-id
\ --operations "Decrypt" "Encrypt" "GenerateDataKey" "GenerateDataKeyWithoutPlaintext" "CreateGrant" "DescribeKey" "ReEncryptFrom" "ReEncryptTo"
有关服务相关角色的更多信息,请参阅 为适用于 Lustre 的亚马逊 FsX 使用服务相关角色。