(storage-ceph)=
# Ceph RBD - `ceph`

<!-- Include start Ceph intro -->
[Ceph](https://ceph.io/en/) はオープンソースのストレージプラットフォームで、データを {abbr}`RADOS (Reliable Autonomic Distributed Object Store)` に基づいたストレージクラスタ内に保管します。
非常にスケーラブルで、単一障害点がない分散システムであり非常に信頼性が高いです。

Ceph はブロックストレージ用とファイルシステム用に異なるコンポーネントを提供します。
<!-- Include end Ceph intro -->

Ceph {abbr}`RBD (RADOS Block Device)` はデータとワークロードを Ceph クラスタに分散する Ceph のブロックストレージコンポーネントです。
これは Thin provisioning を使用し、リソースをオーバーコミットできることを意味します。

## 用語

<!-- Include start Ceph terminology -->
Ceph は保管するデータに *オブジェクト* という用語を使用します。
データを保存と管理する責任を持つデーモンは *Ceph {abbr}`OSD (Object Storage Daemon)`* です。
Ceph のストレージは *プール* に分割されます。これはオブジェクトを保管する論理的なパーティションです。
これらは *データプール*, *ストレージプール*, *OSD プール* とも呼ばれます。
<!-- Include end Ceph terminology -->

Ceph ブロックデバイスは *RBD イメージ* とも呼ばれ、これらの RBD イメージの *スナップショット* と *クローン* を作成できます。

## Incus の `ceph` ドライバー

```{note}
Ceph RBD ドライバを使用するには `ceph` と指定する必要があります。
これは少し誤解を招く恐れがあります。 Ceph の全ての機能ではなく Ceph RBD（ブロックストレージ）の機能しか使わないからです。
コンテントタイプ `filesystem`（イメージ、コンテナとカスタムファイルシステムボリューム）のストレージボリュームには `ceph` ドライバは Ceph RDB イメージをその上にファイルシステムがある状態で使用します（[`block.filesystem`](storage-ceph-vol-config) 参照）。

別の方法として、コンテントタイプ `filesystem` でストレージボリュームを作成するのに {ref}`CephFS <storage-cephfs>` を使用することもできます。
```

<!-- Include start Ceph driver cluster -->
他のストレージドライバーとは異なり、このドライバーはストレージシステムをセットアップはせず、既に Ceph クラスタをインストール済みであると想定します。
<!-- Include end Ceph driver cluster -->

<!-- Include start Ceph driver remote -->
このドライバーはリモートのストレージを提供するという意味でも他のドライバーとは異なる振る舞いをします。
結果として、内部ネットワークに依存し、ストレージへのアクセスはローカルのストレージより少し遅くなるかもしれません。
一方で、リモートのストレージを使うことはクラスタ構成では大きな利点があります。これはストレージプールを同期する必要なしに、すべてのクラスタメンバーが同じ内容を持つ同じストレージプールにアクセスできるからです。
<!-- Include end Ceph driver remote -->

Incus 内の `ceph` ドライバーはイメージ、スナップショットに RBD イメージを使用し、インスタンスとスナップショットを作成するのにクローンを使用します。

<!-- Include start Ceph driver control -->
Incus は OSD ストレージプールに対して完全制御できることを想定します。
このため、 Incus OSD ストレージプール内に Incus が所有しないファイルシステムエンティティは Incus が消してしまうかもしれないので決して置くべきではありません。
<!-- Include end Ceph driver control -->

Ceph RBD 内で copy-on-write が動作する方法のため、親の RBD イメージはすべての子がいなくなるまで削除できません。
結果として Incus は削除されたがまだ参照されているオブジェクトを自動的にリネームします。
そのようなオブジェクトはすべての参照がいなくなりオブジェクトが安全に削除できるようになるまで `zombie_` 接頭辞をつけて維持されます。

### 制限

`ceph` ドライバーには以下の制限があります。

インスタンス間でのカスタムボリュームの共有
: {ref}`コンテントタイプ <storage-content-types>` `filesystem` のカスタムストレージボリュームは異なるクラスタメンバーの複数のインスタンス間で通常は共有できます。
  しかし、 Ceph RBD ドライバーは RBD イメージ上にファイルシステムを置くことでコンテントタイプ `filesystem` のボリュームを「シミュレート」しているため、カスタムストレージボリュームは一度に 1 つのインスタンスにしか割り当てできません。
  コンテントタイプ `filesystem` のカスタムボリュームを共有する必要がある場合は代わりに {ref}`storage-cephfs` ドライバーを使用してください。

複数インストールされた Incus 間で OSD ストレージプールの共有
: 複数インストールされた Incus 間で同じ OSD ストレージプールを共有することはサポートされていません。

タイプ "erasure" の OSD プールの使用
: タイプ "erasure" の OSD プールを使用するには事前に OSD プールを作成する必要があります。
  さらにタイプ "replicated" の別の OSD プールを作成する必要もあります。これはメタデータを保管するのに使用されます。
  これは Ceph RBD が `omap` をサポートしないために必要となります。
  どのプールが "erasure coded" であるかを指定するために [`ceph.osd.data_pool_name`](storage-ceph-pool-config) 設定オプションをイレージャーコーディングされたプールの名前に設定し [`source`](storage-ceph-pool-config) 設定オプションをリプリケートされたプールの名前に設定します。

## 設定オプション

`ceph` ドライバーを使うストレージプールとこれらのプール内のストレージボリュームには以下の設定オプションが利用できます。

(storage-ceph-pool-config)=
### ストレージプール設定

% Include content from [config_options.txt](../config_options.txt)
```{include} ../config_options.txt
    :start-after: <!-- config group storage_ceph-common start -->
    :end-before: <!-- config group storage_ceph-common end -->
```

{{volume_configuration}}

(storage-ceph-vol-config)=
### ストレージボリューム設定

% Include content from [config_options.txt](../config_options.txt)
```{include} ../config_options.txt
    :start-after: <!-- config group storage_volume_ceph-common start -->
    :end-before: <!-- config group storage_volume_ceph-common end -->
```

[^*]: {{snapshot_pattern_detail}}