파일 공유 스냅샷에서 데이터 복원하기

스냅샷을 사용하여 새 공유를 생성함으로써 파일 공유 데이터를 복원합니다. 복원된 공유 항목은 스냅샷과 동일한 프로필 및 위치를 사용합니다. 전체 복구 및 단일 파일 복구를 지원합니다.

공유는 스냅샷의 원본 공유와 동일한 위치에서만 만들 수 있습니다. 새 공유가 생성되면 원래 공유에 대한 포인터만 포함되며 데이터 복사 프로세스가 시작됩니다. 데이터가 복사되는 동안 공유는 보류 중 상태가 됩니다. 새 공유는 보류 중 상태에서 읽기/쓰기를 위해 마운트할 수 있지만 복제본 또는 스냅샷 만들기와 같은 몇 가지 작업은 허용되지 않습니다. 데이터 복사 작업이 완료되면 새 공유가 부모 공유에서 분리되어 독립된 상태가 되어 초기화 프로세스가 완료됩니다. 초기화 프로세스가 완료되면 공유는 안정된 상태로 이동하여 다른 공유처럼 사용할 수 있습니다.

새 영역 파일 공유를 만들 때 고객이 관리하는 암호화 키를 변경할 수 있습니다. 이 프로세스는 새 키를 사용하여 키 관리 서비스에 새 공유를 등록합니다. 새 키는 새 공유를 암호화하는 데 사용됩니다.

사용 가능 여부 선택 이번 지역 파일 공유 릴리스에서는 새 지역 파일 공유를 만들 때 고객이 관리하는 암호화 키를 변경할 수 없습니다.

제한사항

스냅샷에서 공유 항목을 복원할 때는 다음과 같은 제한 사항이 적용됩니다.

  • 공유를 복원하려면 스냅샷이 안정적이고 사용 가능한 상태여야 합니다.
  • 초기화가 완료되지 않으면 공유가 복원된 스냅샷을 삭제할 수 없습니다.
  • 스냅샷이 고객 관리 암호화로 보호되고 다른 루트 키 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. 작업 메뉴 작업 아이콘 복원을 선택합니다.

  5. 프로비저닝 페이지에 스냅샷의 세부 정보가 표시됩니다. 영역 및 암호화 유형과 같은 일부 파일 공유 구성은 스냅샷에서 상속되므로 변경할 수 없습니다.

  6. 필요한 공유 세부 정보를 입력합니다.

    공유 옵션을 만듭니다.
    필드 설명
    공유 세부사항 새 공유를 정의합니다.
    이름 새 공유 폴더의 이름을 입력하십시오.
    리소스 그룹 기본값을 사용하거나 목록에서 선택합니다.
    사용자 태그 리소스를 구성하고 백업 정책에서 사용할 사용자 태그를 지정하세요
    액세스 관리 태그 IAM에서 만든 액세스 관리 태그를 지정하여 공유에 대한 액세스를 관리할 수 있습니다.
    프로파일 기본값은 영역 공유의 경우 dp2, 지역 공유의 경우 rfs 입니다. 새 공유의 프로필 및 스토리지 생성 값은 스냅샷의 프로필 및 스토리지 생성 값과 일치해야 합니다.
    크기 프로필에서 허용하는 공유 크기를 입력합니다. 스냅샷의 크기보다 크거나 같아야 합니다.
    IOPS 공유 프로필이 허용하는 범위 내의 IOPS를 선택합니다.
    마운트 대상 마운트 대상 생성은 선택 사항이지만 가상 서버 인스턴스에서 파일 공유에 연결하려면 마운트 대상이 있어야 합니다.
    암호화 스냅샷에서 상속됩니다.
  7. 작업이 끝나면 ‘생성’을 클릭하세요. 새로운 주식이 생성되었습니다.

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를 사용하여 특정 공유의 모든 스냅샷을 나열하고 출력에서 하나를 선택할 수 있습니다.
    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 r006-de41f19f-204c-4d4c-a630-1971ba85ed1d  --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                                 r006-ef44c3ac-2cc3-49bd-8c4f-27f46936644d
Name                               my-file-share-from-snapshot
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-ef44c3ac-2cc3-49bd-8c4f-27f46936644d
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   none,user_managed
Zone                               us-south-2
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
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                            2025-09-17T12:35:03-05:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -

Snapshot count                     0
Snapshot size                      0
Source snapshot                    ID                                          Name
                                   r006-de41f19f-204c-4d4c-a630-1971ba85ed1d   my-test-snap
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

다음 예는 스냅샷의 CRN을 사용하여 스냅샷에서 공유를 만드는 예제입니다. 새 공유 폴더의 이름을 지정하지 않으면 이름이 자동으로 생성됩니다. 크기와 IOPS 값은 스냅샷에서 상속되며, 공유가 생성된 후 변경할 수 있습니다.

ibmcloud is share-create --profile dp2 --snapshot crn:v1:bluemix:public:is:us-south-2:a/a1234567::share-snapshot:r006-ed78dc15-048f-4077-b7a2-88c213d53463/r006-de41f19f-204c-4d4c-a630-1971ba85ed1d
Creating file share  under account Test Account as user test.user@ibm.com...

ID                                 r006-683e075d-30b6-429c-aba6-1eeb44d06dc2
Name                               giggling-maturing-remnant-unworldly
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-683e075d-30b6-429c-aba6-1eeb44d06dc2
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   user_managed,none
Zone                               us-south-2
Profile                            dp2
Size(GB)                           10
IOPS                               100
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.

Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                            2025-09-17T12:37:01-05:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -

Snapshot count                     0
Snapshot size                      0
Source snapshot                    ID                                          Name
                                   r006-de41f19f-204c-4d4c-a630-1971ba85ed1d   my-test-snap
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

정의된 성능 프로필 제품군의 1세대 및 2세대 파일 공유 프로필은 서로 호환되지 않습니다. 2세대 스냅샷을 사용하여 영역별 파일 공유를 만들 수 없습니다. 마찬가지로 1세대 파일 공유의 스냅샷을 사용하여 rfs 프로필로 공유를 만들 수 없습니다.

사용 가능한 명령 옵션에 대한 자세한 내용은 ibmcloud is share-create.

API를 사용하여 스냅샷에서 공유 폴더 복원하기

VPC API에서 /shares 메서드를 호출하여 프로그래밍 방식으로 공유를 복원할 수 있습니다.

시작하기 전에 공유를 복원하는 데 사용할 스냅샷에 대한 정보를 수집하세요.

API를 사용하여 스냅샷에서 공유 항목 만들기

스냅샷에서 공유를 복원하려면 POST /shares 요청을 하고 source_snapshot 속성에서 스냅샷의 ID 또는 CRN을 지정합니다. 복원된 공유 용량(GB 단위)은 스냅샷의 minimum_capacity 이상이어야 합니다.

다음 예제 요청은 소스 스냅샷을 기반으로 하는 100GB 공유를 생성합니다 r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4.

curl -X POST \
"$vpc_api_endpoint/v1/shares/?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $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"},
     "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"]
   }`

정의된 성능 프로필 제품군의 1세대 및 2세대 파일 공유 프로필은 서로 호환되지 않습니다. 2세대 스냅샷을 사용하여 영역별 파일 공유를 만들 수 없습니다. 마찬가지로 1세대 파일 공유의 스냅샷을 사용하여 rfs 프로필로 공유를 만들 수 없습니다.

Terraform으로 스냅샷에서 공유 복원하기

Terraform을 사용하려면 Terraform CLI를 다운로드하고 IBM Cloud 공급자 플러그인을 구성하세요. 자세한 내용은 테라폼 시작하기를 참조하세요.

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 또는 .snap 로 명명됨)를 열 수 있습니다. 이 디렉터리 안에는 공유의 각 스냅샷을 나타내는 하위 디렉터리가 있습니다. 파일을 열어 위치를 찾은 다음 선택한 파일을 다른 위치로 복사할 수 있습니다.

스냅샷 디렉터리는 숨겨져 있지만 cd .snapshot 또는 ls .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 방식을 통해 삭제할 수 없습니다. 마찬가지로 새 하위 디렉터리를 만드는 것도 금지됩니다. 이 보기는 단일 파일 복원 및 데이터의 특정 시점 검사를 수행할 때만 편리하게 사용할 수 있습니다.

다음 단계

더 많은 스냅샷을 만들거나 기존 스냅샷을 관리할 수 있습니다.