メインコンテンツへスキップ
W&B Sandboxes は招待制のプライベートプレビューです。登録をリクエストするには、サポート または担当の AISE にお問い合わせください。
ファイル操作を使用すると、ローカル環境とサンドボックスの間でデータを共有できます。サンドボックスからファイルを読み取ったり、サンドボックスにファイルを書き込んだり、ローカルのファイルやディレクトリをサンドボックスにマウントしたりできます。 たとえば、Python スクリプトをサンドボックスに書き込んで実行し、出力ファイルをローカル環境に読み戻すことができます。また、機械学習ジョブ用のトレーニングデータ ディレクトリをサンドボックスにマウントすることもできます。
適切なファイルアクセス方法を選択してくださいコピーせずにサンドボックスからローカル データにアクセスする必要がある場合は、ファイルまたはディレクトリをマウントします。ローカル環境とサンドボックスの間で小さなファイルを転送する場合や、サンドボックスの出力をローカルに保存する場合は、ファイルの読み取りと書き込みを使用します。

​
サンドボックスにファイルを書き込む

Sandbox.write_file() メソッドを使用して、ローカル環境からサンドボックスへファイルを転送します。 
from pathlib import Path
from wandb.sandbox import Sandbox

# サンドボックスに書き込むローカルファイルのパス
text_file = Path("hello.txt")

with Sandbox.run() as sandbox:
    # サンドボックスにファイルを書き込む
    sandbox.write_file("hello.txt", text_file.read_bytes()).result()
Sandbox クラスのリファレンスドキュメントで、Sandbox.write_file() のパラメーターとオプションの完全な一覧を参照してください。

​
サンドボックス内のファイルを読み込む

Sandbox.read_file() メソッドを使用して、サンドボックスからローカル環境へファイルを保存します。 
from pathlib import Path
from wandb.sandbox import Sandbox

with Sandbox.run() as sandbox:
    # デモ: 読み返すためのファイルをサンドボックス内に作成する
    sandbox.exec(["sh", "-c", "echo 'Hello, world.' > hello.txt"]).result()

    # ローカルマシンにファイルを保存する（サンドボックス外）
    content = sandbox.read_file("hello.txt").result()  # b"Hello, world.\n"
    Path("hello.txt").write_bytes(content)
パラメーターとオプションの一覧については、Sandbox.read_file() の Sandbox クラスのリファレンスドキュメントを参照してください。

​
ファイルまたはディレクトリをマウントする

マウントしたファイルを使用すると、作成時にローカルファイルをサンドボックスに渡せます。実行中のサンドボックスにファイルを転送する Sandbox.write_file() とは異なり、マウントしたファイルはサンドボックスの起動直後から利用できます。マウントしたファイルは、指定したパスでサンドボックス内から利用できます。
マウントしたファイルは、サンドボックス内では読み取り専用です。サンドボックス内でファイルを変更する必要がある場合は、代わりに Sandbox.write_file() を使用してください。
次のコードスニペットでは、ローカルファイルの train.py と requirements.txt をサンドボックスのルートディレクトリにマウントしています。サンドボックスは requirements.txt から依存関係をインストールし、その後 train.py を実行します。 
from pathlib import Path
from wandb.sandbox import Sandbox, NetworkOptions

mounted_files = [
    {"mount_path": "requirements.txt", "file_content": Path("requirements.txt").read_bytes()},
    {"mount_path": "train.py", "file_content": Path("train.py").read_bytes()},
        ]

print("Starting sandbox...")
with Sandbox.run(mounted_files=mounted_files) as sandbox:

    # マウントされたファイルは、指定されたマウントパスでサンドボックス内で利用可能です
    print("Installing dependencies...")
    result = sandbox.exec(["pip", "install", "-r", "requirements.txt"], check=True).result()
    print(result.stdout)

    print("Running script...")
    result = sandbox.exec(["python", "train.py"]).result()
    print(result.stdout)