Language:
Format:

5.4. Ansible を使用した双方向ミラーリングの設定

この手順では、ceph-ansible を使用して双方向のレプリケーションを設定し、イメージを site-a と site-b と呼ばれる 2 つのクラスター間でミラーリングできるようにします。以下の例では、data はミラーリングされるイメージが含まれるプールの名前です。

注記

双方向ミラーリングでは、どちらのクラスターにおいても、同じイメージへの同時書き込みはできません。イメージは一方のクラスターでプロモートされ、他方のクラスターではデモートされます。ステータスに応じて、それらは一方向または反対方向でミラリングされます。

前提条件

Red Hat Ceph Storage クラスターを実行する 2 つ。
各クラスターにクライアントノードがある。
同じ名前のプールが両方のクラスターに存在する。
ジャーナルベースのミラーリングでは、プール内のイメージで排他的ロックとジャーナリングを有効にする必要があります。

手順

イメージの元のクラスターで、イメージの排他的ロックおよびジャーナリング機能を有効にします。
1. 新規イメージの場合は、--image-feature オプションを使用します。
  構文
```
rbd create IMAGE_NAME --size MEGABYTES --pool POOL_NAME --image-feature FEATURE[,FEATURE]
```
  例
```
[root@rbd-client ~]# rbd create image1 --size 1024 --pool data --image-feature exclusive-lock,journaling
```
2. 既存のイメージ の場合は、rbd feature enable コマンドを使用します。
  構文
```
rbd feature enable POOL_NAME/IMAGE_NAME FEATURE_NAME
```
  例
```
[root@rbd-client ~]# rbd feature enable data/image1 exclusive-lock,journaling
```
3. デフォルトですべての新規イメージの排他的ロックおよびジャーナリングを有効にするには、以下の設定を Ceph 設定ファイルに追加します。
```
rbd_default_features = 125
```

site-a クラスターで、以下の手順を実行します。

モニターノードで、rbd-mirror デーモンがクラスターへの接続に使用するユーザーを作成します。この例では、site-a ユーザーを作成し、そのキーを site-a.client.site-a.keyring という名前のファイルに出力します。Ceph 設定ファイルは /etc/ceph/site-a.conf です。

構文

ceph auth get-or-create client.PRIMARY_CLUSTER_NAME mon 'profile rbd' osd 'profile rbd pool=data' -o /etc/ceph/PRIMARY_CLUSTER_NAME.client.USER_NAME.keyring -c /etc/ceph/PRIMARY_CLUSTER_NAME.conf

例

[root@mon ~]# ceph auth get-or-create client.site-a mon 'profile rbd' osd 'profile rbd pool=data' -o /etc/ceph/site-a.client.site-a.keyring -c /etc/ceph/site-a.conf

キーリングは site-b クラスターにコピーします。rbd-daemon が実行される site-b クラスターのクライアントノードにファイルをコピーします。このファイルを /etc/ceph/site-a.client.site-a.keyring に保存します。
構文
```
scp /etc/ceph/PRIMARY_CLUSTER_NAME.client.USER_NAME.keyring root@SECONDARY_CLIENT_NODE_NAME:/etc/ceph/PRIMARY_CLUSTER_NAME.client.USER_NAME.keyring
```
例
```
[root@mon ~]# scp /etc/ceph/site-a.client.site-a.keyring root@client.site-b:/etc/ceph/site-a.client.site-a.keyring
```

Ceph 設定ファイルをモニターノードから site-b モニターノードおよびクライアントノードにコピーします。この例の Ceph 設定ファイルは /etc/ceph/site-a.conf です。

構文

scp /etc/ceph/PRIMARY_CLUSTER_NAME.conf root@SECONDARY_MONITOR_NODE_NAME:/etc/ceph/PRIMARY_CLUSTER_NAME.conf
scp /etc/ceph/PRIMARY_CLUSTER_NAME.conf user@SECONDARY_CLIENT_NODE_NAME:/etc/ceph/PRIMARY_CLUSTER_NAME.conf

例

[root@mon ~]# scp /etc/ceph/site-a.conf root@mon.site-b:/etc/ceph/site-a.conf
[root@mon ~]# scp /etc/ceph/site-a.conf user@client.site-b:/etc/ceph/site-a.conf

site-b クラスターで、以下の手順を実行します。
1. site-a から site-b へのミラーリングを設定します。Ansible 管理ノードで、rbdmirrors グループを Ansible インベントリーファイル (通常は /usr/share/ceph-ansible/hosts) に追加します。
2. [rbdmirrors] グループの下に、rbd-mirror デーモンが実行される site-b クライアントノードの名前を追加します。このデーモンは、イメージの変更を site-a から site-b にプルします。
  例
```
[rbdmirrors]
client.site-b
```
3. /usr/share/ceph-ansible ディレクトリーに移動します。
```
[root@admin ~]$ cd /usr/share/ceph-ansible
```
4. group_vars/rbdmirrors.yml.sample から group_vars/rbdmirrors.yml にコピーして、新しい rbdmirrors.yml ファイルを作成します。
```
[root@admin ceph-ansible]# cp group_vars/rbdmirrors.yml.sample group_vars/rbdmirrors.yml
```
5. group_vars/rbdmirrors.yml ファイルを開いて編集します。
6. ceph_rbd_mirror_configure を true に設定し、ceph_rbd_mirror_pool をイメージをミラーリングするプールに設定します。この例では、data はプールの名前です。
```
ceph_rbd_mirror_configure: true
ceph_rbd_mirror_pool: "data"
```
7. デフォルトでは、ceph-ansible はプール内の全イメージをミラーリングするプールモードを使用してミラーリングを設定します。ミラーリングが明示的に有効になっているイメージのみがミラーリングされるイメージモードを有効にします。イメージモードを有効にするには、ceph_rbd_mirror_mode を image に設定します。
```
ceph_rbd_mirror_mode: image
```
8. group_vars/rbdmirrors.yml ファイルに rbd-mirror のクラスターの名前を設定します。以下の例では、他のクラスターは site-a です。
```
ceph_rbd_mirror_remote_cluster: "site-a"
```
9. Ansible 管理ノードで、group_vars/rbdmirrors.yml ファイルの ceph_rbd_mirror_remote_user を使用してキーのユーザー名を設定します。キーの作成時に使用した同じ名前を使用します。この例では、ユーザーの名前は client.site-a です。
```
ceph_rbd_mirror_remote_user: "client.site-a"
```
10. ansible ユーザーとして、Ansible Playbook を実行します。
  - ベアメタルデプロイメント
    [user@admin ceph-ansible]$ ansible-playbook site.yml --limit rbdmirrors -i hosts
  - コンテナーデプロイメント
    [user@admin ceph-ansible]$ ansible-playbook site-container.yml --limit rbdmirrors -i hosts

ミラーリングのステータスを確認します。site-b クラスターで、Ceph Monitor ノードから以下のコマンドを実行します。

例

ジャーナルベースのミラーリング

[root@mon ~]# rbd mirror image status data/image1
image1:
  global_id:   7d486c3f-d5a1-4bee-ae53-6c4f1e0c8eac
  state:       up+replaying 1
  description: replaying, master_position=[object_number=3, tag_tid=1, entry_tid=3], mirror_position=[object_number=3, tag_tid=1, entry_tid=3], entries_behind_master=0
  last_update: 2021-04-22 13:19:27

スナップショットベースのミラーリング

[root@mon ~]# rbd mirror image status data/image1
image1:
  global_id:   06acc9e6-a63d-4aa1-bd0d-4f3a79b0ae33
  state:       up+replaying 1
  description: replaying, {"bytes_per_second":0.0,"bytes_per_snapshot":0.0,"local_snapshot_timestamp":1642689843,"remote_snapshot_timestamp":1642689843,"replay_state":"idle"}
  service:     admin on ceph-rbd2-vasi-43-5hwia4-node2
  last_update: 2022-01-20 12:41:57

1 1: イメージが up+replaying の場合には、ミラーリングが正常に機能します。

注記

サイト間の接続によって、ミラーリングでイメージの同期に時間がかかる場合があります。

site-b クラスターで、以下の手順を実行します。手順は上記とほぼ同じです。

モニターノードで、rbd-mirror デーモンがクラスターへの接続に使用するユーザーを作成します。この例では、site-b ユーザーを作成し、そのキーを site-b.client.site-b.keyring という名前のファイルに出力します。Ceph 設定ファイルは /etc/ceph/site-b.conf です。

構文

ceph auth get-or-create client.SECONDARY_CLUSTER_NAME mon 'profile rbd' osd 'profile rbd pool=data' -o /etc/ceph/SECONDARY_CLUSTER_NAME.client.USER_NAME.keyring -c /etc/ceph/SECONDARY_CLUSTER_NAME.conf

例

[root@mon ~]# ceph auth get-or-create client.site-b mon 'profile rbd' osd 'profile rbd pool=data' -o /etc/ceph/site-b.client.site-b.keyring -c /etc/ceph/site-b.conf

キーリングを site-a クラスターにコピーします。rbd-daemon が実行される site-a クラスターのクライアントノードにファイルをコピーします。ファイルを /etc/ceph/site-b.client.site-b.keyring に保存します。
構文
```
scp /etc/ceph/SECONDARY_CLUSTER_NAME.client.USER_NAME.keyring root@PRIMARY_CLIENT_NODE_NAME:/etc/ceph/SECONDARY_CLUSTER_NAME.client.USER_NAME.keyring
```
例
```
[root@mon ~]# scp /etc/ceph/site-b.client.site-b.keyring root@client.site-a:/etc/ceph/site-b.client.site-b.keyring
```

Ceph 設定ファイルをモニターノードから site-a モニターノードおよびクライアントノードにコピーします。この例の Ceph 設定ファイルは /etc/ceph/site-b.conf です。

構文

scp /etc/ceph/SECONDARY_CLUSTER_NAME.conf root@PRIMARY_MONITOR_NODE_NAME:/etc/ceph/SECONDARY_CLUSTER_NAME.conf
scp /etc/ceph/SECONDARY_CLUSTER_NAME.conf user@PRIMARY_CLIENT_NODE_NAME:/etc/ceph/SECONDARY_CLUSTER_NAME.conf

例

[root@mon ~]# scp /etc/ceph/site-b.conf root@mon.site-a:/etc/ceph/site-b.conf
[root@mon ~]# scp /etc/ceph/site-b.conf user@client.site-a:/etc/ceph/site-b.conf

site-a クラスターで、以下の手順を実行します。
1. site-b から site-a へのミラーリングを設定します。Ansible 管理ノードで、rbdmirrors グループを Ansible インベントリーファイル (通常は /usr/share/ceph-ansible/hosts) に追加します。
2. [rbdmirrors] グループの下に、rbd-mirror デーモンが実行される site-a クライアントノードの名前を追加します。このデーモンは、イメージの変更を site-b から site-a にプルします。
  例
```
[rbdmirrors]
client.site-a
```
3. /usr/share/ceph-ansible ディレクトリーに移動します。
```
[root@admin ~]# cd /usr/share/ceph-ansible
```
4. group_vars/rbdmirrors.yml.sample から group_vars/rbdmirrors.yml にコピーして、新しい rbdmirrors.yml ファイルを作成します。
```
[root@admin ceph-ansible]# cp group_vars/rbdmirrors.yml.sample group_vars/rbdmirrors.yml
```
5. group_vars/rbdmirrors.yml ファイルを開いて編集します。
6. ceph_rbd_mirror_configure を true に設定し、ceph_rbd_mirror_pool をイメージをミラーリングするプールに設定します。この例では、data はプールの名前です。
```
ceph_rbd_mirror_configure: true
ceph_rbd_mirror_pool: "data"
```
7. オプション: デフォルトでは、ceph-ansible はプール内の全イメージをミラーリングするプールモードを使用してミラーリングを設定します。ミラーリングが明示的に有効になっているイメージのみがミラーリングされるイメージモードを有効にします。イメージモードを有効にするには、ceph_rbd_mirror_mode を image に設定します。
```
ceph_rbd_mirror_mode: image
```
8. Ansible 管理ノードで、group_vars/rbdmirrors.yml ファイルに rbd-mirror クラスターの名前を設定します。例に従い、その他のクラスターの名前は site-b とします。
```
ceph_rbd_mirror_remote_cluster: "site-b"
```
9. Ansible 管理ノードで、group_vars/rbdmirrors.yml ファイルの ceph_rbd_mirror_remote_user を使用してキーのユーザー名を設定します。この例では、ユーザーの名前は client.site-b です。
```
ceph_rbd_mirror_remote_user: "client.site-b"
```
10. 管理ノードで Ansible ユーザーとして、Ansible Playbook を実行します。
  - ベアメタルデプロイメント
    [user@admin ceph-ansible]$ ansible-playbook site.yml --limit rbdmirrors -i hosts
  - コンテナーデプロイメント
    [user@admin ceph-ansible]$ ansible-playbook site-container.yml --limit rbdmirrors -i hosts
site-a クラスターと site-b クラスターの両方で、必要なイメージのミラーリングを明示的に有効にします。
構文
ジャーナルベースのミラーリング
```
rbd mirror image enable POOL/IMAGE
```
スナップショットベースのミラーリング
```
rbd mirror image enable POOL/IMAGE snapshot
```
例
```
[root@mon ~]# rbd mirror image enable data/image1
[root@mon ~]# rbd mirror image enable data/image1 snapshot
```
注記
新規イメージをピアクラスターにミラーリングする場合は常にこの手順を繰り返します。

ミラーリングのステータスを確認します。site-a クラスターのクライアントノードから以下のコマンドを実行します。

例

ジャーナルベースのミラーリング

[root@mon ~]# rbd mirror image status data/image1
image1:
  global_id:   08027096-d267-47f8-b52e-59de1353a034
  state:       up+stopped 1
  description: local image is primary
  last_update: 2021-04-16 15:45:31

スナップショットベースのミラーリング

[root@mon ~]# rbd mirror image status data/image1
image1:
  global_id:   47fd1aae-5f19-4193-a5df-562b5c644ea7
  state:       up+stopped 1
  description: local image is primary
  service:     admin on ceph-rbd1-vasi-43-5hwia4-node2
  last_update: 2022-01-20 12:42:54
  peer_sites:
    name: rbd-mirror.site-b
    state: up+replaying
    description: replaying, {"bytes_per_second":0.0,"bytes_per_snapshot":0.0,"local_snapshot_timestamp":1642693094,"remote_snapshot_timestamp":1642693094,"replay_state":"idle"}
    last_update: 2022-01-20 12:42:59
  snapshots:
    5 .mirror.primary.47fd1aae-5f19-4193-a5df-562b5c644ea7.dda146c6-5f21-4e75-ba93-660f6e57e301 (peer_uuids:[bfd09289-c9c9-40c8-b2d3-ead9b6a99a45])

1 1: イメージは up+stopped 状態である必要があります。ここでは、up は rbd-mirror デーモンが実行中で、stopped は、イメージが別のクラスターからのレプリケーション先ではないことを意味します。これは、イメージがこのクラスターのプライマリーであるためです。

Select Your Language

5.4. Ansible を使用した双方向ミラーリングの設定

Quick Links

Help

Site Info

Related Sites

About

Red Hat legal and privacy links

Red Hat legal and privacy links

Language and Page Formatting Options

5.4. Ansible を使用した双方向ミラーリングの設定

Quick Links

Help

Site Info

Related Sites

Systems Status

About

Red Hat legal and privacy links

Red Hat legal and privacy links