View a markdown version of this page

Studio での Amazon EFS の作成と自動マウント - Amazon SageMaker AI

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

Studio での Amazon EFS の作成と自動マウント

Amazon SageMaker AI は、ドメインの Amazon EFS ボリュームの作成と、各ユーザーのホームディレクトリフォルダの自動マウントをサポートしています。このフォルダを使用すると、ユーザーは自分のプライベートスペース間でデータを共有できます。ただし、ユーザーはドメイン内の他のユーザーとデータを共有することはできません。ユーザーは、自分のフォルダにのみアクセスできます。

重要

2026 年 6 月 1 日以降に作成されたドメインの場合、EFS はドメインの作成中にデフォルトでは作成されません (クイックセットアップ用）。自動マウントを有効にするには、EFS の作成を有効にする必要があります。

EFS の作成と自動マウントの設定

Amazon SageMaker Studio の EFS には、連携する 2 つの設定が含まれます。

  • HomeEFSCreation – EFS ファイルシステムがドメインの SageMaker AI によって作成および管理されるかどうかを制御します。

    クイックセットアップで作成された新しいドメインのデフォルト: 無効

    有効にした場合: このドメインの SageMaker AI によって管理される新しい EFS ファイルシステムを作成します。

  • AutoMountHomeEFS – EFS ストレージをユーザーに自動的にマウントするかどうかを制御します。

    デフォルト: 有効 ( HomeEFSCreation が有効になっている場合)

    説明: ノートブック、データ、コードをプライベートスペース間で共有するために、各ユーザーのホームディレクトリを自動マウントします。

    この設定は、 HomeEFSCreationが有効になっている場合にのみ編集できます。

    ユーザープロファイルレベルでは、この値はデフォルトで DefaultAsDomain (ドメインレベルの設定を継承) になります。

主な動作:

  • に値が設定されていない場合AutoMountHomeEFS、自動マウント EFS はデフォルトで有効になっています。

  • 既存のスペースがある場合は、スペースを再起動して EFS をマウントします。

  • 自動マウント EFS はプライベートスペースでのみ使用できます。

EFS の作成と自動マウントを有効にする

ドメイン作成後 (クイックセットアップ):

  1. SageMaker AI コンソールを開きます。

  2. 左側のナビゲーションペインの管理者設定で、ドメインを選択します。

  3. ドメインを選択し、ドメイン設定タブを選択します。

  4. ストレージ設定セクションで、編集を選択します。

  5. EFS ストレージと暗号化で、オンHomeEFSCreationに切り替えます。これにより、このドメインの SageMaker AI によって管理される新しい EFS ファイルシステムが作成されます。

  6. AutoMountHomeEFS がオンになっていることを確認します ( がオンの場合、デフォルトで有効HomeEFSCreationになっています）。これにより、各ユーザーがノートブック、データ、コードをプライベートスペース間で共有するためのホームディレクトリが自動マウントされます。

  7. [Submit] を選択してください。

  8. 既存のスペースがある場合は、それらを再起動して EFS データにアクセスします。

カスタムセットアップでは、EFS の作成と自動マウントがデフォルトで有効になっています。

ユーザーのフォルダには、user-default-efs という名前のフォルダからアクセスできます。このフォルダは Studio アプリケーションの $HOME ディレクトリにあります。

Amazon EFS 自動マウントのオプトアウトについては、「Amazon EFS 自動マウントをオプトアウトする」を参照してください。

Amazon EFS 自動マウントは、Studio Classic から Studio へのデータ移行も容易になります。詳細については、「(オプション) Studio Classic から Studio にデータを移行する」を参照してください。

アクセスポイント情報

自動マウントがアクティブ化されると、SageMaker AI は Amazon EFS アクセスポイントを使用して Amazon EFS ボリューム内のデータへのアクセスを容易にします。アクセスポイントの詳細については、「Working with Amazon EFS access points」を参照してください。SageMaker AI は、ユーザープロファイルの作成時または既存のユーザープロファイルのアプリケーション作成時に、ドメイン内の各ユーザープロファイルに一意のアクセスポイントを作成します。アクセスポイントの POSIX ユーザー値は、SageMaker AI がアクセスポイントを作成するユーザープロファイルの HomeEfsFileSystemUid 値と一致します。ユーザーの値を取得するには、「DescribeUserProfile」を参照してください。ルートディレクトリパスも POSIX ユーザー値と同じ値に設定されます。 

SageMaker AI は、新しいディレクトリのアクセス許可を次の値に設定します。

  • 所有者ユーザー ID: POSIX user value

  • 所有者グループ ID: 0

  • アクセス許可 700

Amazon EFS ボリュームにアクセスするには、アクセスポイントが必要です。そのため、Amazon EFS ボリュームへのアクセスを失うことなく、アクセスポイントを削除または更新することはできません。

エラーの解決

アプリケーションの作成中、Amazon EFS ユーザーフォルダの自動マウント時に SageMaker AI で問題が発生した場合でも、アプリケーションは引き続き作成されます。ただし、この場合、SageMaker AI は Amazon EFS フォルダをマウントする代わりに error.txt という名前のファイルを作成します。このファイルには、発生したエラーと、それを解決する手順について記載されています。SageMaker AI は、アプリケーションの $HOME ディレクトリにある user-default-efs フォルダに、error.txt ファイルを作成します。