Ubuntu 26.04 Ceph クライアント共通設定

Ubuntu 26.04 から CephFS や RBD を利用するには、クライアント側に ceph-common、ceph.conf、client keyring を配置する必要があります。これは Ceph クラスタ本体を作る記事ではなく、既存の Ceph クラスタを Ubuntu 26.04 から利用するための共通設定です。

この記事では、Ceph クライアント共通設定を整理します。CephFS や RBD の提供側設定とは分けて、クライアントが MON へ接続し、指定された client profile の keyring を使える状態を作ることに絞ります。

1. 1
   ceph-common を導入する

   Ceph CLI とクライアント機能を使えるようにします。
2. 2
   クラスタ別ディレクトリを作る

   /etc/ceph/main のようにクラスタ名ごとに分けます。
3. 3
   ceph.conf を配置する

   FSID、MON host、client keyring path を書きます。
4. 4
   keyring を配置する

   利用する client profile の鍵を置きます。
5. 5
   疎通確認する

   CephFS / RBD を使う前に Ceph コマンドで確認します。

Ceph common はクライアント側の設定である

ceph-common は Ceph クラスタ本体ではありません。Ubuntu 26.04 ホストを Ceph クライアントとして使うための共通パッケージです。CephFS を mount する場合も、RBD image を扱う場合も、まずこの共通設定が必要になります。

ceph-common をインストールする

sudo apt update
sudo apt install -y ceph-common

ceph --version

クラスタ別ディレクトリを作成する

複数クラスタや用途別 profile を扱う可能性を考えると、/etc/ceph/main のようにクラスタ名ごとのディレクトリを作ると整理しやすくなります。

sudo install -d -o root -g root -m 0755 /etc/ceph/main

ceph.conf を配置する

ceph.conf には、クラスタ FSID、MON の接続先、client keyring の場所を書きます。MON は複数ある場合、カンマ区切りで指定します。

sudo tee /etc/ceph/main/ceph.conf >/dev/null <<'EOF'
[global]
fsid = 00000000-0000-0000-0000-000000000000
mon_host = 10.0.10.50:6789

[client.cephfs-main]
keyring = /etc/ceph/main/ceph.client.cephfs-main.keyring

[client.rbd-main]
keyring = /etc/ceph/main/ceph.client.rbd-main.keyring
EOF

sudo chmod 0644 /etc/ceph/main/ceph.conf

client keyring を配置する

CephFS や RBD 用に作成した client keyring を配置します。keyring は秘密情報なので、権限を 0600 にします。

sudo tee /etc/ceph/main/ceph.client.cephfs-main.keyring >/dev/null <<'EOF'
[client.cephfs-main]
key = CHANGE_ME_CEPHFS_CLIENT_KEY
EOF

sudo tee /etc/ceph/main/ceph.client.rbd-main.keyring >/dev/null <<'EOF'
[client.rbd-main]
key = CHANGE_ME_RBD_CLIENT_KEY
EOF

sudo chmod 0600 /etc/ceph/main/ceph.client.*.keyring
sudo chown root:root /etc/ceph/main/ceph.client.*.keyring

既定の ceph.conf として使う場合

ツールによっては /etc/ceph/ceph.conf を既定で見ます。単一クラスタだけを扱うホストでは、クラスタ別設定へ symlink しておくと扱いやすいです。

sudo ln -sfn /etc/ceph/main/ceph.conf /etc/ceph/ceph.conf
ls -l /etc/ceph/ceph.conf

Ceph への疎通を確認する

設定後、client 名を明示して疎通を確認します。CephFS 用 profile と RBD 用 profile では権限が違うため、用途に応じた client を指定します。

ceph -c /etc/ceph/main/ceph.conf --name client.cephfs-main status
rbd -c /etc/ceph/main/ceph.conf --name client.rbd-main ls --pool rbd-main

CephFS / RBD との関係

まとめ

Ceph クライアント共通設定は、Ceph クラスタを利用する Ubuntu 26.04 側の土台です。ceph-common を入れ、ceph.conf と client keyring を正しい権限で配置して、CephFS や RBD を使う準備を整えます。

ここを Ceph クラスタ本体や CephFS / RBD の作成と混ぜると、どこで何を設定しているのか分かりにくくなります。提供側と利用側を分けて整理すると、ストレージ設計全体がかなり見通しやすくなります。

Related posts:

Ubuntu 26.04 Ceph RBD の基本設定 Ubuntu 26.04 Ceph クラスタの基本設計と構築 3 ノード Ceph で起きた OSD 障害と復旧プロセス Ubuntu 22.04 CentOS と Ubuntu の違い Ubuntu 20.04 OSインストール VMware Workstation Ubuntu 20.04 autoinstallation Ubuntu 20.04 MicroK8s の初期設定と DNS addon の確認 Ubuntu 22.04 BIND 外部 DNS – 公開ゾーンと権威 DNS の設計 Ubuntu 22.04 389 Directory Server #3 – ベースエントリーの登録 Ubuntu 22.04 NFS サーバー構築 – NFSv4 と exports の基本 Ubuntu 22.04 Dovecot IMAP サーバー – Maildir と Postfix 連携 Ubuntu 22.04 Podman 基本的な使い方