4.3. Ceph File System サブボリューム

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。

手順

• CephFS サブボリュームを作成します。

  構文

  ceph fs subvolume create VOLUME_NAME SUBVOLUME_NAME [--size SIZE_IN_BYTES --group_name SUBVOLUME_GROUP_NAME --pool_layout DATA_POOL_NAME --uid _UID --gid GID --mode OCTAL_MODE] [--namespace-isolated]

  例

  [root@mon ~]# ceph fs subvolume create cephfs sub0 --group_name subgroup0 --namespace-isolated

  subvolume がすでに存在している場合でも、コマンドは成功します。

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。
• CephFS サブボリューム。

手順

• CephFS サブボリュームをリスト表示します。

  構文

  ceph fs subvolume ls VOLUME_NAME [--group_name SUBVOLUME_GROUP_NAME]

  例

  [root@mon ~]# ceph fs subvolume ls cephfs --group_name subgroup0

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。
• CephFS サブボリューム。

手順

• CephFS サブボリュームのサイズを変更します。

  構文

  ceph fs subvolume resize VOLUME_NAME SUBVOLUME_NAME NEW_SIZE [--group_name SUBVOLUME_GROUP_NAME] [--no_shrink]

  例

  [root@mon ~]# ceph fs subvolume resize cephfs sub0 1024000000 --group_name subgroup0 --no_shrink

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。
• CephFS サブボリューム。

手順

• CephFS サブボリュームの絶対パスを取得します。

  構文

  ceph fs subvolume getpath VOLUME_NAME SUBVOLUME_NAME [--group_name _SUBVOLUME_GROUP_NAME]

  例

  [root@mon ~]# ceph fs subvolume getpath cephfs sub0 --group_name subgroup0

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。
• CephFS サブボリューム。

手順

• CephFS サブボリュームのメタデータを取得します。

  構文

  ceph fs subvolume info VOLUME_NAME SUBVOLUME_NAME [--group_name SUBVOLUME_GROUP_NAME]

  例

  [root@mon ~]# ceph fs subvolume info cephfs sub0 --group_name subgroup0

  出力例

  # ceph fs subvolume info cephfs sub0
  {
      "atime": "2023-07-14 08:52:46",
      "bytes_pcent": "0.00",
      "bytes_quota": 1024000000,
      "bytes_used": 0,
      "created_at": "2023-07-14 08:52:46",
      "ctime": "2023-07-14 08:53:54",
      "data_pool": "cephfs.cephfs.data",
      "features": [
          "snapshot-clone",
          "snapshot-autoprotect",
          "snapshot-retention"
      ],
      "flavor": "2",
      "gid": 0,
      "mode": 16877,
      "mon_addrs": [
          "10.0.208.172:6789",
          "10.0.211.197:6789",
          "10.0.209.212:6789"
      ],
      "mtime": "2023-07-14 08:52:46",
      "path": "/volumes/_nogroup/sub0/834c5cbc-f5db-4481-80a3-aca92ff0e7f3",
      "pool_namespace": "",
      "state": "complete",
      "type": "subvolume",
      "uid": 0
  }

• atime: "YYYY-MM-DD HH:MM:SS" 形式のサブボリュームパスのアクセス時間。
• bytes_pcent: クォータが設定されている場合に使用するクォータ。それ以外の場合は "undefined" を表示します。
• bytes_quota: クォータが設定されている場合のクォータサイズ (バイト単位)。それ以外の場合は "infinite" を表示します。
• bytes_used: サブボリュームの現在の使用サイズ (バイト単位)。
• created_at: サブボリュームを作成する時間 ("YYYY-MM-DD HH:MM:SS" 形式)。
• ctime: サブボリュームの時間を "YYYY-MM-DD HH:MM:SS" 形式で変更します。
• data_pool: サブボリュームが属するデータプール。
• features: snapshot-clone"、"snapshot-autoprotect"、"snapshot-retention" などのサブボリュームでサポートされる機能。
• flavor: サブボリュームのバージョン。バージョン 1 の場合は 1、バージョン 2 の場合は 2 です。
• gid: サブボリュームパスのグループ ID。
• モード: サブボリュームパスのモード。
• mon_addrs: モニターアドレスのリスト。
• mtime: サブボリュームパスの変更時間 ("YYYY-MM-DD HH:MM:SS" 形式)。
• path: サブボリュームの絶対パス。
• pool_namespace: サブボリュームの RADOS 名前空間。
• state: サブボリュームの現在の状態 (例: "complete" または "snapshot-retained"d)
• type: クローンかサブボリュームかを示すサブボリュームタイプ。
• uid : サブボリュームパスのユーザー ID。

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。
• CephFS サブボリューム。
• クライアントの読み取り (r) および書き込み (w) 機能のほかに、クライアントはファイルシステム内のディレクトリーパスに s フラグも必要になります。

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。

• スナップショットの作成や書き込み機能の削除に加えて、クライアントはファイルシステム内のディレクトリーパスに s フラグが必要です。

  構文

  CLIENT_NAME
      key = AQAz7EVWygILFRAAdIcuJ12opU/JKyfFmxhuaw==
      caps mds = allow rw, allow rws path=DIRECTORY_PATH
      caps mon = allow r
      caps osd = allow rw tag cephfs data=DIRECTORY_NAME

  以下の例では、client.0 はファイルシステム cephfs_a の bar ディレクトリーにスナップショットを作成または削除することができます。

  例

  [client.0]
      key = AQAz7EVWygILFRAAdIcuJ12opU/JKyfFmxhuaw==
      caps mds = "allow rw, allow rws path=/bar"
      caps mon = "allow r"
      caps osd = "allow rw tag cephfs data=cephfs_a"

関連情報

• Red Hat Ceph Storage 管理ガイド の Ceph ユーザーの管理 セクションを参照してください。

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。
• CephFS サブボリューム。
• サブボリュームのスナップショット。

手順

• CephFS サブボリュームのスナップショットをリスト表示します。

  構文

  ceph fs subvolume snapshot ls VOLUME_NAME SUBVOLUME_NAME [--group_name SUBVOLUME_GROUP_NAME]

  例

  [root@mon ~]# ceph fs subvolume snapshot ls cephfs sub0 --group_name subgroup0

前提条件

• CephFS がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。
• CephFS サブボリューム。
• サブボリュームのスナップショット。

• created_at: スナップショットの作成時間 ("YYYY-MM-DD HH:MM:SS:ffffff" 形式)。
• data_pool: スナップショットが属するデータプール。
• has_pending_clones: スナップショットの選択が進行中の場合は "yes" そうでなければ "no"。
• サイズ: スナップショットサイズ (バイト単位)。

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。
• CephFS サブボリューム。

前提条件

• Ceph File System がデプロイされている稼働中の Red Hat Ceph Storage クラスター。
• Ceph Monitor での少なくとも読み取りアクセス。
• Ceph Manager ノードの読み取りおよび書き込み機能。
• Ceph File System ボリューム。
• サブボリュームグループのスナップショット。

手順

• CephFS サブボリュームのスナップショットを削除します。

  構文

  ceph fs subvolume snapshot rm VOLUME_NAME SUBVOLUME_NAME SNAP_NAME [--group_name GROUP_NAME --force]

  例

  [root@mon ~]# ceph fs subvolume snapshot rm cephfs sub0 snap0 --group_name subgroup0 --force