翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ドメインへのカスタムファイルシステムの追加
ドメインを作成すると、Amazon SageMaker AI はドメインにデフォルト Amazon Elastic File System (Amazon EFS) ボリュームを追加します。SageMaker AI によってこのボリュームが作成されます。作成したカスタム Amazon EFS またはカスタム Amazon FSx for Lustre ファイルシステムを追加することもできます。追加したファイルシステムは、ドメインに属するユーザーが使用できるようになります。ユーザーは、Amazon SageMaker Studio を使用する際に、追加したファイルシステムにアクセスできます。ファイルシステムは、以下のサポートされているアプリケーション用に作成するスペースにアタッチできます。
-
JupyterLab
-
コードエディタ
スペースを実行してアプリケーションを起動すると、ユーザーはファイルシステムに含まれるデータ、コード、またはその他のアーティファクトにアクセスできます。
ユーザーは、以下の方法でファイルシステムにアクセスできます。
-
共有スペース経由 – 共有スペースは、ドメインに属するすべてのユーザーが作成できます。作成された共有スペースは、ドメインに属するすべてのユーザーが利用できます。
-
プライベートスペース経由 – プライベートスペースは、ドメインに属するすべてのユーザーが作成できます。作成されたプライベートスペースは、作成したユーザーのみが使用できます。
-
個別のユーザー専用 – すべてのユーザーがファイルシステムにアクセスできるようにする必要がない場合は、特定のユーザーのみがファイルシステムにアクセスできるように指定できます。このように指定すると、ファイルシステムは、特定のユーザーが作成したプライベートスペースでのみ使用できます。
Amazon SageMaker API、 AWS SDKs、または を使用して、カスタムファイルシステムを追加できます AWS CLI。SageMaker AI コンソールを使用してカスタムファイルシステムを追加することはできません。
前提条件
ドメインにカスタムファイルシステムを追加する前に、次の要件を満たす必要があります。
-
SageMaker AI にドメインがある。ファイルシステムを追加する前に、ドメイン ID が必要です。SageMaker AI コンソールを使用して ID を検索できます。 AWS CLIで
list-domains
コマンドを実行することもできます。 -
に Amazon EFS または FSx for Lustre ファイルシステムがあります AWS アカウント。
を使用してドメインにカスタムファイルシステムを追加する AWS CLI
を使用してドメインまたはユーザープロファイルにカスタムファイルシステムを追加するには AWS CLI、次のいずれかのコマンドを使用するときにCustomFileSystemConfigs
定義を渡します。
次の例は、既存のドメインまたはユーザープロファイルにファイルシステムを追加する方法について説明しています。
共有スペースでアクセスできるファイルシステムを追加するには
-
ドメインのデフォルトのスペース設定を更新します。次の例では、ファイルシステム設定をデフォルトのスペース設定に追加します。
aws sagemaker update-domain --domain-id
domain-id
\ --default-space-settings file://file-system-settings.jsonこの例では、ファイルシステム設定を JSON ファイルとして渡します。このファイルについては、後の例で説明します。
プライベートスペースでアクセスできるファイルシステムを追加するには
-
ドメインのデフォルトのユーザー設定を更新します。次の例では、ファイルシステム設定をデフォルトのユーザー設定に追加します。
aws sagemaker update-domain --domain-id
domain-id
\ --default-user-settings file://file-system-settings.jsonこの例では、ファイルシステム設定を JSON ファイルとして渡します。このファイルについては、後の例で説明します。
個別のユーザーのみがアクセスできるファイルシステムを追加するには
-
該当するユーザーのユーザープロファイルを更新します。次の例では、ファイルシステム設定をユーザープロファイルに追加します。
aws sagemaker update-user-profile --domain-id
domain-id
\ --user-profile-nameuser-profile-name
\ --user-settings file://file-system-settings.jsonこの例では、ファイルシステム設定を JSON ファイルとして渡します。このファイルについては、次の例で説明します。
例 ファイルシステム設定ファイル
上記の例のファイルである file-system-settings.json
には、次の設定があります。
ファイルシステムをドメインのデフォルトスペース設定に割り当てる場合は、設定に実行ロールも含める必要があります。
{ "ExecutionRole": "
execution-role-arn
" }
この例の設定では、以下のキーを使用しています。
ExecutionRole
-
ドメインのユーザーのデフォルトの実行ロールです。
ファイルシステムに POSIX アクセス許可を適用する場合は、以下の設定を create-domain
コマンドまたは create-user-profile
コマンドに渡すこともできます。
{ "CustomPosixUserConfig": { "Uid":
UID
, "Gid":GID
} }
この例の設定では、以下のキーを使用しています。
CustomPosixUserConfig
-
ファイルシステムのオペレーションに使用されるデフォルトの POSIX ID です。このような設定を使用して、カスタムファイルシステムにアクセスするユーザープロファイルに既存の POSIX アクセス許可構造を適用できます。POSIX アクセス許可レベルでは、ファイルシステムにアクセスできるユーザーや、ユーザーがアクセスできるファイルまたはデータを制御できます。
create-user-profile
コマンドを使用してユーザープロファイルを作成する際に、CustomPosixUserConfig
設定を適用することもできます。ユーザープロファイルに適用する設定は、関連付けられたドメインに適用される設定よりも優先されます。注記
create-domain
コマンドやcreate-user-profile
コマンドを使用する際に、CustomPosixUserConfig
設定を適用できます。ただし、以下を実行する場合は、このような設定を適用できません。-
既に任意のユーザープロファイルに関連付けられているドメインに対して
update-domain
コマンドを使用する場合。これらの設定は、ユーザープロファイルがないドメインにのみ適用できます。 -
update-user-profile
コマンドを使用します。これらの設定を既に作成したプロファイルに適用するには、プロファイルを削除して、更新した設定を持つ新しいプロファイルを作成します。
-
Uid
-
POSIX ユーザー ID です。デフォルトは 200001 です。
Gid
-
POSIX グループ ID です。デフォルトは 1001 です。
AWS CLIを使用したスペースへのカスタムファイルシステムのアタッチ
ドメインにカスタムファイルシステムを追加すると、ドメインユーザーは作成したスペースにファイルシステムをアタッチできます。例えば、Studio または AWS CLIの create-space コマンドを使用する際にファイルシステムをアタッチできます。
カスタムファイルシステムをスペースにアタッチするには
-
ファイルシステム設定をスペース設定に追加します。次のコマンド例では、ファイルシステムを新しいスペースにアタッチします。
aws sagemaker create-space \ --space-name
space-name
\ --domain-iddomain-id
\ --ownership-settings "OwnerUserProfileName=user-profile-name
" \ --space-sharing-settings "SharingType=Private" \ --space-settings file://space-settings.jsonこの例のファイル
space-settings.json
には、FileSystemId
キーを使用したCustomFileSystems
設定など、次のとおりの設定があります。SageMaker AI は、次のパスにシンボリックリンクを作成します:
/home/sagemaker-user/custom-file-systems/
。これにより、ドメインユーザーはホームディレクトリのfile-system-type
/file-system-id
/home/sagemaker-user
内からカスタムファイルシステムに移動できます。