1.2. VolSync の永続ボリューム複製サービス

宛先クラスターで次のコマンドを実行して、ネームスペースを作成します。

oc create ns <destination-ns>

destination-ns をレプリケーション先が配置されている namespace に置き換えます。

replication_destination という名前の新しい YAML ファイルを作成し、次の内容をコピーします。

apiVersion: volsync.backube/v1alpha1
kind: ReplicationDestination
metadata:
  name: <destination>
  namespace: <destination-ns>
spec:
  rsyncTLS:
    serviceType: LoadBalancer 

    copyMethod: Snapshot
    capacity: 2Gi 

    accessModes: [ReadWriteOnce]
    storageClassName: gp2-csi
    volumeSnapshotClassName: csi-aws-vsc

任意: 環境のデフォルト値とは異なるストレージクラス名とボリュームスナップショットクラス名を使用している場合は、storageClassName パラメーターと volumeSnapshotClassName パラメーターの値を指定します。

宛先クラスターで以下のコマンドを実行し、replicationdestination リソースを作成します。

oc create -n <destination-ns> -f replication_destination.yaml

destination-ns は、宛先の namespace の名前に置き換えます。

replicationdestination リソースが作成されると、以下のパラメーターおよび値がリソースに追加されます。

以下のコマンドを実行して、ソースクラスターで使用する .status.rsyncTLS.address の値をコピーします。destination は、レプリケーション先のカスタムリソースの名前に置き換えます。destination-ns は、宛先の namespace の名前に置き換えます。

ADDRESS=`oc get replicationdestination <destination> -n <destination-ns> --template={{.status.rsyncTLS.address}}`
echo $ADDRESS

出力は次のようになります。これは Amazon Web Services 環境のものです。

a831264645yhrjrjyer6f9e4a02eb2-5592c0b3d94dd376.elb.us-east-1.amazonaws.com

次のコマンドを実行して、シークレットの名前をコピーします。

KEYSECRET=`oc get replicationdestination <destination> -n <destination-ns> --template={{.status.rsyncTLS.keySecret}}`
echo $KEYSECRET

destination は、レプリケーション先のカスタムリソースの名前に置き換えます。

destination-ns は、宛先の namespace の名前に置き換えます。

ソースの設定時に、ソースクラスターで入力する必要があります。出力は、SSH キーシークレットファイルの名前である必要があります。これは、次の名前のようになります。

volsync-rsync-tls-destination-name

宛先クラスター宛先クラスターに対して次のコマンドを入力して、宛先クラスターからキーシークレットをコピーします。

oc get secret -n <destination-ns> $KEYSECRET -o yaml > /tmp/secret.yaml

destination-ns をレプリケーション先が配置されている namespace に置き換えます。

以下のコマンドを入力して、vi エディターでシークレットファイルを開きます。

vi /tmp/secret.yaml

宛先クラスターのオープンシークレットファイルで、次の変更を行います。

ソースクラスターで、ソースクラスターで次のコマンドを入力してシークレットファイルを作成します。

oc create -f /tmp/secret.yaml

ソースクラスター上に replication_source という名前の新しい YAML ファイルを作成し、次の内容をコピーします。

apiVersion: volsync.backube/v1alpha1
kind: ReplicationSource
metadata:
  name: <source> 

  namespace: <source-ns> 

spec:
  sourcePVC: <persistent_volume_claim> 

  trigger:
    schedule: "*/3 * * * *" #/*
  rsyncTLS:
    keySecret: <mykeysecret> 

    address: <my.host.com> 

    copyMethod: Snapshot
    storageClassName: gp2-csi
    volumeSnapshotClassName: csi-aws-vsc

ストレージドライバーがクローン作成をサポートする場合は、copyMethod の値に Clone を使用すると、レプリケーションのより効率的なプロセスになる可能性があります。

任意: 環境のデフォルト値とは異なるストレージクラス名とボリュームスナップショットクラス名を使用している場合は、storageClassName パラメーターと volumeSnapshotClassName パラメーターの値を指定します。

永続ボリュームの同期方法を設定できるようになりました。

ソースクラスターで、以下のコマンドを入力して ReplicationSource オブジェクトの address および keySecret の値を、宛先クラスターから書き留めた値に置き換えて replication_source.yaml ファイルを変更します。

sed -i "s/<my.host.com>/$ADDRESS/g" replication_source.yaml
sed -i "s/<mykeysecret>/$KEYSECRET/g" replication_source.yaml
oc create -n <source> -f replication_source.yaml

my.host.com は、設定時に ReplicationDestination の .status.rsyncTLS.address フィールドからコピーしたホストアドレスに置き換えます。

keySecret を設定時に ReplicationDestination の .status.rsyncTLS.keySecret フィールドからコピーしたキーに置き換えます。

source を、ソースが置かれている永続ボリューム要求の名前に置き換えます。

注記: 複製する永続ボリューム要求と同じ namespace にファイルを作成する必要があります。

ReplicationSource オブジェクトで以下のコマンドを実行して、レプリケーションが完了したことを確認します。

oc describe ReplicationSource -n <source-ns> <source>

source-ns をソースが置かれている永続ボリューム要求の namespace に置き換えます。

source は、レプリケーションソースのカスタムリソースの名前に置き換えます。

レプリケーションが成功した場合、出力は次の例のようになります。

Status:
  Conditions:
    Last Transition Time:  2021-10-14T20:48:00Z
    Message:               Synchronization in-progress
    Reason:                SyncInProgress
    Status:                True
    Type:                  Synchronizing
    Last Transition Time:  2021-10-14T20:41:41Z
    Message:               Reconcile complete
    Reason:                ReconcileComplete
    Status:                True
    Type:                  Reconciled
  Last Sync Duration:      5m20.764642395s
  Last Sync Time:          2021-10-14T20:47:01Z
  Next Sync Time:          2021-10-14T20:48:00Z

Last Sync Time に時間がリストされていない場合は、レプリケーションが完了していません。

宛先クラスターで次のコマンドを実行して、ネームスペースを作成します。

oc create ns <destination-ns>

destination-ns を、オンサイトのボリューム要求ごとに宛先が含まれる namespace の名前に置き換えます。

以下の YAML コンテンツをコピーし、replication_destination.yaml という名前の新規ファイルを作成します。

apiVersion: volsync.backube/v1alpha1
kind: ReplicationDestination
metadata:
  name: <destination>
  namespace: <destination-ns>
spec:
  rsync:
    serviceType: LoadBalancer
    copyMethod: Snapshot
    capacity: 2Gi
    accessModes: [ReadWriteOnce]
    storageClassName: gp2-csi
    volumeSnapshotClassName: csi-aws-vsc

注記: capacity の値は、レプリケートされる永続ボリューム要求の容量と一致する必要があります。

destination は、宛先 CR の名前に置き換えます。

destination-ns は、宛先の namespace の名前に置き換えます。

この例では、LoadBalancer の ServiceType 値が使用されます。ロードバランサーサービスはソースクラスターによって作成され、ソースマネージドクラスターが別の宛先マネージドクラスターに情報を転送できるようにします。ソースと宛先が同じクラスター上にある場合、または Submariner ネットワークサービスが設定されている場合は、サービスタイプとして ClusterIP を使用できます。ソースクラスターを設定するときに参照するシークレットのアドレスと名前をメモします。

storageClassName および volumeSnapshotClassName は任意のパラメーターです。特に、環境のデフォルト値とは異なるストレージクラスおよびボリュームスナップショットクラス名を使用している場合は、環境の値を指定してください。

宛先クラスターで以下のコマンドを実行し、replicationdestination リソースを作成します。

oc create -n <destination-ns> -f replication_destination.yaml

destination-ns は、宛先の namespace の名前に置き換えます。

replicationdestination リソースが作成されると、以下のパラメーターおよび値がリソースに追加されます。

以下のコマンドを実行して、ソースクラスターで使用する .status.rsync.address の値をコピーします。

ADDRESS=`oc get replicationdestination <destination> -n <destination-ns> --template={{.status.rsync.address}}`
echo $ADDRESS

destination は、レプリケーション先のカスタムリソースの名前に置き換えます。

destination-ns は、宛先の namespace の名前に置き換えます。

出力は、Amazon Web Services 環境の次の出力のように表示されます。

a831264645yhrjrjyer6f9e4a02eb2-5592c0b3d94dd376.elb.us-east-1.amazonaws.com

次のコマンドを実行して、シークレットの名前をコピーします。

SSHKEYS=`oc get replicationdestination <destination> -n <destination-ns> --template={{.status.rsync.sshKeys}}`
echo $SSHKEYS

destination は、レプリケーション先のカスタムリソースの名前に置き換えます。

destination-ns は、宛先の namespace の名前に置き換えます。

ソースの設定時に、ソースクラスターで入力する必要があります。出力は、SSH キーシークレットファイルの名前である必要があります。これは、次の名前のようになります。

volsync-rsync-dst-src-destination-name

宛先クラスターに対して次のコマンドを入力して、宛先クラスターから SSH シークレットをコピーします。

oc get secret -n <destination-ns> $SSHKEYS -o yaml > /tmp/secret.yaml

destination-ns を、宛先が置かれている永続ボリューム要求の namespace に置き換えます。

以下のコマンドを入力して、vi エディターでシークレットファイルを開きます。

vi /tmp/secret.yaml

宛先クラスターのオープンシークレットファイルで、次の変更を行います。

ソースクラスターで、ソースクラスターで次のコマンドを入力してシークレットファイルを作成します。

oc create -f /tmp/secret.yaml

以下の YAML コンテンツをコピーして、ソースクラスターに replication_source.yaml という名前の新規ファイルを作成します。

apiVersion: volsync.backube/v1alpha1
kind: ReplicationSource
metadata:
  name: <source>
  namespace: <source-ns>
spec:
  sourcePVC: <persistent_volume_claim>
  trigger:
    schedule: "*/3 * * * *" #/*
  rsync:
    sshKeys: <mysshkeys>
    address: <my.host.com>
    copyMethod: Snapshot
    storageClassName: gp2-csi
    volumeSnapshotClassName: csi-aws-vsc

source は、レプリケーションソースカスタムリソースの名前に置き換えます。これを自動的に置き換える方法は、この手順のステップ 3-vi を参照してください。

source-ns をソースが置かれている永続ボリューム要求の namespace に置き換えます。これを自動的に置き換える方法は、この手順のステップ 3-vi を参照してください。

persistent_volume_claim は、ソース永続ボリューム要求の名前に置き換えます。

mysshkeys は、設定時に ReplicationDestination の .status.rsync.sshKeys フィールドからコピーしたキーに置き換えます。

my.host.com は、設定時に ReplicationDestination の .status.rsync.address フィールドからコピーしたホストアドレスに置き換えます。

ストレージドライバーがクローン作成をサポートする場合は、copyMethod の値に Clone を使用すると、レプリケーションのより効率的なプロセスになる可能性があります。

StorageClassName および volumeSnapshotClassName はオプションのパラメーターです。ご使用の環境のデフォルトとは異なるストレージクラスおよびボリュームスナップショットクラス名を使用している場合は、それらの値を指定してください。

永続ボリュームの同期方法を設定できるようになりました。

ソースクラスターで、以下のコマンドを入力して ReplicationSource オブジェクトの address および sshKeys の値を、宛先クラスターから書き留めた値に置き換えて replication_source.yaml ファイルを変更します。

sed -i "s/<my.host.com>/$ADDRESS/g" replication_source.yaml
sed -i "s/<mysshkeys>/$SSHKEYS/g" replication_source.yaml
oc create -n <source> -f replication_source.yaml

my.host.com は、設定時に ReplicationDestination の .status.rsync.address フィールドからコピーしたホストアドレスに置き換えます。

mysshkeys は、設定時に ReplicationDestination の .status.rsync.sshKeys フィールドからコピーしたキーに置き換えます。

source を、ソースが置かれている永続ボリューム要求の名前に置き換えます。

注記: 複製する永続ボリューム要求と同じ namespace にファイルを作成する必要があります。

ReplicationSource オブジェクトで以下のコマンドを実行して、レプリケーションが完了したことを確認します。

oc describe ReplicationSource -n <source-ns> <source>

source-ns をソースが置かれている永続ボリューム要求の namespace に置き換えます。

source は、レプリケーションソースのカスタムリソースの名前に置き換えます。

レプリケーションが成功した場合、出力は次の例のようになります。

Status:
  Conditions:
    Last Transition Time:  2021-10-14T20:48:00Z
    Message:               Synchronization in-progress
    Reason:                SyncInProgress
    Status:                True
    Type:                  Synchronizing
    Last Transition Time:  2021-10-14T20:41:41Z
    Message:               Reconcile complete
    Reason:                ReconcileComplete
    Status:                True
    Type:                  Reconciled
  Last Sync Duration:      5m20.764642395s
  Last Sync Time:          2021-10-14T20:47:01Z
  Next Sync Time:          2021-10-14T20:48:00Z

Last Sync Time に時間がリストされていない場合は、レプリケーションが完了していません。