IBM Cloud Docs
ファイル共有スナップショットからのデータ復元

ファイル共有スナップショットからのデータ復元

スナップショットからデータをリストアすると、完全にプロビジョニングされた新しい共有が作成されます。 共有は、手動またはバックアップポリシーによって作成されたスナップショットからリストアすることができます。 スナップショットからの共有は、コンソール、CLI、API、Terraformで作成できます。 スナップショットを使用して作成する共有には、スナップショットと同じファイル共有プロファイルが必要です。 ファイル共有のスナップショットから単一ファイルを復元することもできます。

共有は、スナップショットのオリジン共有と同じアベイラビリティゾーンでのみ作成できます。 新しい共有が作成されると、元の共有へのポインタだけが含まれ、データのコピー処理が始まる。 データがコピーされている間、共有は_保留_状態にある。 新しい共有は_保留_状態で読み取り/書き込みのためにマウントできるが、レプリカの作成やスナップショットのようないくつかの操作は許可されない。 データコピー操作が完了すると、新しいシェアは親シェアから分割されて独立し、初期化プロセスが完了する。 初期化プロセスが完了すると、共有は_安定_状態に移行し、他の共有と同様に使用できる。

新しい共有が作成されるときに、顧客が管理する暗号化キーを変更することが可能です。 このプロセスにより、新しい共有が新しい鍵とともに鍵管理サービスに登録される。 新しい鍵は新しいShareの暗号化に使われる。

制限

スナップショットから共有を復元する場合、以下の制限が適用されます。

  • 共有をリストアするには、スナップショットが_安定した_ _利用可能な_状態でなければなりません。
  • 初期化が完了しない限り、共有の復元元のスナップショットを削除することはできません。
  • スナップショットがカスタマ管理暗号化で保護されていて、別のルートキーCRNを指定しない場合、復元された共有はスナップショットの暗号化キーで暗号化されます。 暗号化は後から変更できない。 新しい共有の初期化中に親共有の暗号鍵が削除されると、初期化プロセスが中断され、失敗する。

コンソールでスナップショットから共有をリストアする

IBM Cloud コンソールの様々なページから共有を作成できます。

コンソールでスナップショットから共有を作成する

File Storage for VPC のスナップショットの一覧から、 File Storage for VPC の共有を作成できます。 新しい共有は File Storage for VPC 共有リスト に追加されます。

  1. File Storage for VPC スナップショットのリストへ。 IBM Cloud コンソール で、 ナビゲーションメニュー アイコン メニューアイコン > インフラストラクチャー VPCアイコン > ストレージ > ファイルストレージ共有 をクリックする。

  2. 別の共有を作成するために使用したいデータがある共有を選択します。

  3. 共有の詳細ページのスナップショットタブで、使用するスナップショットを見つけます。 stable 状態でなければなりません。

  4. Actionsメニューの Actionsアイコン Actionsから Restore を選択します。

  5. プロビジョニングページでは、スナップショットの詳細が表示されます。 ゾーンや暗号化タイプなど、一部のファイル共有設定はスナップショットから継承され、変更できません。

  6. 必要な共有の詳細を入力してください。

    共有オプションを作成する。
    フィールド 説明
    シェアの詳細 新しいシェアを定義する。
    名前 新しい共有の名前を入力します。
    リソース・グループ デフォルトを使用するか、リストから選択する。
    ユーザー・タグ リソースを整理し、 バックアップポリシー で使用するための ユーザータグ を指定します
    アクセス管理タグ IAMで作成した アクセス管理タグ を指定し、共有へのアクセス管理に役立てる。
    プロファイル デフォルトは dp2。 新しい共有のプロファイルは、スナップショットのプロファイルと一致していなければなりません。
    サイズ プロファイルで許可されている共有サイズを入力します。 スナップショットのサイズより大きいか等しくなければならない。
    IOPS 共有プロファイルが許可する範囲内のIOPSを選択します。
    マウント・ターゲット マウントターゲットの作成は任意ですが、仮想サーバーインスタンスからファイル共有に接続する場合はマウントターゲットが必要です。
    暗号化 スナップショットから継承されます。
  7. 完了したら、 Createをクリックする。 新しいシェアが作成される。

CLIからスナップショットから共有をリストアする

CLIからスナップショットから File Storage for VPC 共有を作成できます。 共有が作成されたら、マウントターゲットを作成し、後でインスタンスに共有をマウントすることができます。

開始前に

CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。 詳しくは、CLI の前提条件を参照してください。

  1. ログイン IBM Cloud®.

    ibmcloud login --sso -a cloud.ibm.com
    

    このコマンドを実行すると、URL が返され、パスコードの入力を求めるプロンプトが表示されます。 ブラウザーでその URL にアクセスしてログインします。 成功すると、ワンタイム・パスコードが表示されます。 そのパスコードをコピーし、プロンプトに応答として貼り付けます。 認証に成功すると、アカウントを選択するプロンプトが表示されます。 複数のアカウントにアクセスできる場合は、ログインするアカウントを選択します。 残りのプロンプトにすべて応答して、ログインを完了します。

  2. 共有の復元に使用するスナップショットに関する情報を収集します。

    1. CLIを使用して、 特定の共有のすべてのスナップショットを一覧表示 し、出力から1つを選択することができます。
    2. 次に、 ibmcloud is share-snapshot SHARE SNAPSHOT コマンドを使用して、選択したスナップショットの詳細を一覧表示します。

CLIでスナップショットから共有を作成する

ibmcloud is share-create コマンドを実行し、 --snapshot パラメータとスナップショットの ID または CRN を指定します。

$ ibmcloud is share-create --name my-file-share-from-snapshot --snapshot cli-share-snapshot --share my-file-share --zone us-south-1 --profile dp2 --size 100 --iops 2000  --user-tags env:test
Creating file share my-file-share-from-snapshot under account Test Account as user test.user@ibm.com...

ID                                 r134-c956e095-afb1-408c-a589-887e77afab20   
Name                               my-file-share-from-snapshot   
CRN                                crn:v1:staging:public:is:us-south-1:a/a1234567::share:r134-c956e095-afb1-408c-a589-887e77afab20   
Lifecycle state                    pending   
Access control mode                security_group   
Accessor binding role              none   
Allowed transit encryption modes   user_managed,none   
Zone                               us-south-1   
Profile                            dp2   
Size(GB)                           100   
IOPS                               2000  
User Tags                          env:test   
Encryption                         provider_managed   
Mount Targets                      ID                          Name      
                                   No mounted targets found.      

Resource group                     ID                                 Name      
                                   11caaa983d9c4beb82690daab08717e9   Default      

Created                            2024-12-17T11:21:57+05:30   
Replication role                   none   
Replication status                 none   
Replication status reasons         Status code   Status message      
                                   -             -   

次の例では、スナップショットのCRNを使用してスナップショットから共有を作成します。 新しい共有の名前を入力しないと、名前が自動生成されます。 サイズとIOPSの値はスナップショットから継承され、共有の作成後に変更できます。

$ ibmcloud is share-create --profile dp2 --snapshot crn:v1:staging:public:is:us-south-1:a/a1234567::share-snapshot:r134-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 --user-tags dev:tags
Creating file share  under account Test Account as user test.user@ibm.com...

ID                                 r134-5fb2d6aa-544d-4469-8e59-36e0fc21d0fa   
Name                               portion-unsafe-itinerary-oppressor   
CRN                                crn:v1:staging:public:is:us-south-1:a/a123456::share:r134-5fb2d6aa-544d-4469-8e59-36e0fc21d0fa   
Lifecycle state                    pending   
Access control mode                security_group   
Accessor binding role              none   
Allowed transit encryption modes   user_managed,none   
Zone                               us-south-1   
Profile                            dp2   
Size(GB)                           40   
IOPS                               100   
User Tags                          dev:tags   
Encryption                         provider_managed   
Mount Targets                      ID                          Name      
                                   No mounted targets found.      

Resource group                     ID                                 Name      
                                   11caaa983d9c4beb82690daab08717e9   Default      

Created                            2024-12-17T11:23:15+05:30   
Replication role                   none   
Replication status                 none   
Replication status reasons         Status code   Status message      
                                   -             -      

使用可能なコマンドオプションの詳細については ibmcloud is share-create.

APIを使用してスナップショットから共有を復元する

VPC API/shares メソッドを呼び出すことで、プログラムで共有を復元できます。

開始する前に、共有の復元に使用するスナップショットに関する情報を収集します。

APIを使ってスナップショットから共有を作成する

スナップショットから共有を復元するには、 POST /shares 要求を行い、 source_snapshot プロパティにスナップショットの ID または CRN を指定します。 リストアされる共有容量(GB単位)は、スナップショットのminimum_capacity以上でなければなりません。

次のリクエスト例は、ソーススナップショット r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4 に基づいて100GBの共有を作成します。

curl -X POST \
"$vpc_api_endpoint/v1/shares/?version=2024-12-10&generation=2" \
-H "Authorization: $iam_token" \
-H "Content-Type: application/json" \
-d '{
     "name": "my-share-from-snapshot",
     "capacity": 100,
     "iops": 2000,
     "source_snapshot:" {"id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4"},
     "profile": {"name": "dp2"},
     "zone": {"name": "us-south-1"},
     "encryption_key":{"crn":"crn:[...]"},
     "mount_targets": [
        {"virtual_network_interface": {"subnet": {"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5"}},
        {"vpc": {"id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}],
     "allowed_transit_encryption_modes": ["none","user_managed"],
     "resource_group": {},
     "user_tags": ["env:test"]
   }`

Terraformでスナップショットから共有をリストアする

Terraformを使うには、Terraform CLIをダウンロードし、 IBM Cloudを設定する。Provider プラグインを設定する。 詳しくは Terraformを始める を参照。

VPCインフラ・サービスは特定の地域エンドポイントを使用し、デフォルトでは us-south。 VPCが他のリージョンに作成されている場合は、 provider.tf ファイル内のプロバイダ・ブロックで適切なリージョンをターゲットにしていることを確認してください。

デフォルトの us-south 以外の地域をターゲットとする次の例を参照。

provider "ibm" {
  region = "eu-de"
}

Terraformでスナップショットから共有を作成する

スナップショットから共有を作成するには、 ibm_is_share リソースを使用します。 以下の例では、 dp2 プロファイルでスナップショットから共有を作成しています。

resource "ibm_is_share" "storage" {
  name            = "restore-share-new"
  profile         = "dp2"
  zone            = "us-south-1"
  source_snapshot = "ibm_is_snapshot.example.crn"
}

引数と属性の詳細については、 ibm_is_share を参照のこと。

スナップショットからファイルを復元する

単一ファイルの復元を実行するには、OSのネイティブ関数を使用することができます。 共有の NFS マウントターゲットをブラウズして、隠れた /.snapshot ディレクトリを開き、共有の各スナップショットに含まれるデータにアクセスできます。 次に、選択したファイルを別の場所にコピーすることができます。

スナップショット・ディレクトリは隠されていますが、 cd .snapshotls .snapshot/ のようなコマンドで直接指定するとアクセス可能になり、見ることができます。 共有に存在するすべてのスナップショットは、その隠された /.snapshot ディレクトリ内のサブディレクトリとして表示され、各スナップショットディレクトリは、コンソール、CLIから、またはAPIで表示されるスナップショットのフィンガープリントで命名されます。 以下の例を参照してください。

[root@server .snapshot]# ls -lah
total 34K
drwxr-xr-x  3 root root  3 May 10 08:28 .
drwxr-xr-x 22 root root 56 May 10 08:28 ..
drwxr-xr-x  2 root root  2 May 10 08:28 c2c2439c-cbeb-4f12-8d9d-6059a3b85502

これらのサブディレクトリは、スナップショットが取られた時点の共有の状態を表します。 サブディレクトリは読み取り専用である。 これらのスナップショットから NFSの方法でデータを削除することはできない。 同様に、新しいサブディレクトリを作成することも禁止されている。 このビューは、単一ファイルのリストアやデータのポイントインタイム検査を行う際の利便性のためだけのものである。

次のステップ

さらにスナップショットを 作成 したり、既存のスナップショットを 管理 することができます。