# ボリューム

マシンより長く残る追加ストレージ。/mnt にマウントされ、保存しているデータ量に応じて、マシン自体のディスクとは別に課金されます。

## 2 種類のストレージ

|  | マシンのディスク | ボリューム |
|---|---|---|
| サービス内容 | マシン自体のディスク（`/workspace` を含む） | 追加ストレージ（`/mnt` にマウント） |
| 費用 | GPU の料金に含まれる | 保存データ 1 GB・1 か月あたり $0.15、毎日課金 |
| 保持期間 | マシンと一緒に削除 | 削除するまで |
| 速度 | ローカルディスクで最速 | ネットワークストレージ：読み込みと保存には十分ですが、小さな読み取りを大量に行うと遅くなります |

## 作成して使う

1. **Rent** パネルの **Volume** で **New volume…** を選んで名前を付けるか、先に **Volumes** で作成します。
2. マシンはボリュームを `/mnt` にマウントした状態で起動します。データセット、重み、チェックポイントはそこに置いてください。
3. マシンは削除されるまでそのボリュームを使い続けます。1 つのボリュームを複数のマシンに同時にマウントできます。どのマシンからも同じファイルが見え、最後の書き込みが優先されます。

**Find GPUs** で **No volume** と表示されたマシンはボリュームをマウントできず、パネルにもそう表示されます。マシンにマウントされている間、ボリュームは削除できません。

## 費用

- ボリュームが保存しているデータ **1 GB・1 か月あたり $0.15**。1 日 1 回測定し、毎日残高から差し引きます。100 GB を 1 か月保存すると $15、空のボリュームは無料です。
- **読み取りは含まれます**。毎月、ボリュームが保存しているデータ量までです。100 GB を保存しているボリュームなら 100 GB の読み取りが含まれます。書き込みは常に含まれます。
- それを大きく超える読み取りには **1 GB あたり $0.10** を請求することがあります。その場合は事前にお知らせします。
- マシン自体のディスクに追加料金はかかりません。GPU の料金に含まれています。
- 残高が足りなくてもボリュームの料金は支払い義務が生じます。新しいボリュームを作るには、アカウントに残高が必要です。不要になったボリュームは削除してください。削除するまで課金されます。

## 読み取りを抑える

`/mnt` からのコピーはすべて読み取りとして数えられます。実行中に何度も読むもの（データセット、モデルの重み）は一度だけマシンのディスクにコピーし、結果ができたら `/mnt` に書き戻してください。

```sh
cp -r /mnt/datasets /workspace/
```

## CLI と API から

```sh
arrakis volumes create --name datasets
arrakis instances create --node-id <node> --volume-id <volume id> --termination-hours 4
arrakis volumes list
```

`POST /v1/volumes` でボリュームを作成し、`POST /v1/instances` の `volume_id` でマウントします。`GET /v1/gpus?volumes=true` はボリュームをマウントできるマシンだけを返します。`GET /v1/volumes` は各ボリュームの保存量、その量での月額、マウント先のマシンを表示します。

その他：[すべてのドキュメント](/ja/docs.md) · [OpenAPI](/openapi.json) · [llms.txt](/ja/llms.txt)