CLI에서 복제본을 사용하여 파일 공유 작성

동일한 리전 내에 복제본이 있는 구역 기반 파일 공유를 동시에 생성할 수 있습니다. 이 방식은 복제본이 동일한 리전에 남아 있는 존 기반 공유에 대해서만 지원됩니다. 지역 간 복제본은 복제본을 초기화할 때 소스 공유가 안정적인 상태여야 하므로 별도의 단계에서 생성해야 합니다.

' ibmcloud is share-create 명령을 사용하여 공유를 만들 때 ' --replica-share-name, ' --replica-share-profile' , ' --replica-share-cron-spec' ,--replica-share-zone' 옵션의 값을 지정하여 동시에 복제본 공유를 만들 수 있습니다. Cron-spec은 복제 빈도를 지정하며, 15분 간격으로 데이터를 복제하도록 예약할 수 있습니다. 명령 옵션에 대한 자세한 내용은 ' ibmcloud is share-create 을 참조하세요.

다음 예제에서 공유 my-source-file-share 는 us-south-1 의 복제본 파일 공유 my-replica-file-share 를 사용하여 us-south-2 에 작성됩니다. 이 예에서는 소스 파일 공유에 대해 하나의 마운트 대상만 만들어집니다. --replica-share-mount-targets 옵션과 동일한 JSON 구문을 사용하여 복제본 공유에 대한 마운트 대상을 만들 수도 있습니다.

ibmcloud is share-create --name my-source-file-share --zone us-south-2 --profile dp2 --size 1500 --iops 2000  --user-tags env:dev --mount-targets '[{"name":"my-source-mount-target","virtual_network_interface": {"name":"my-source-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]' --replica-share-name my-replica-file-share --replica-share-profile dp2 --replica-share-cron-spec '55 09 * * *' --replica-share-zone us-south-1

Creating file share my-source-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
Name                               my-source-file-share
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
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)                           1500
IOPS                               2000
User Tags                          env:dev
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-67799c85-09cf-4cfe-811d-effa10c99395   my-source-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-08-01T17:25:05+00:00
Replication share                  ID                                          Name                    Resource type
                                   r006-2068a709-8c18-4844-8c1d-42b83889dfb3   my-replica-file-share   share
Replication role                   source
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

CLI를 사용하여 기존 파일 공유의 복제본 생성하기

동일한 리전 내 또는 동일한 지리적 영역 내의 다른 리전에 있는 기존 파일 공유에 대한 복제본을 생성할 수 있습니다.

1. ibmcloud is shares 명령으로 지역의 파일 공유를 나열하여 CLI에서 소스 파일 공유를 찾으십시오.

   ibmcloud is shares
   

   Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
   ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size
   r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0
   r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0
   r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0
   r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0
   r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0
   r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0
   

2. ibmcloud is share 명령을 사용하여 소스로 사용할 파일 공유의 세부사항을 보십시오. 동일한 지역에서 복제본을 작성할 때 공유의 이름 또는 ID를 사용할 수 있습니다. 다른 리젼에서 복제본을 작성하는 경우 소스 파일 공유의 CRN을 기록해 두십시오.

   ibmcloud is share my-file-share
   

   Getting file share my-file-share under account Test Account as user test.user@ibm.com...
   ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
   Name                         my-file-share
   CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
   Lifecycle state              stable
   Access control mode          security_group
   Accessor binding role        none
   Zone                         us-south-2
   Profile                      dp2
   Size(GB)                     1000
   IOPS                         1000
   User Tags                    docs:test
   Encryption                   provider_managed
   Mount Targets                ID                                          Name
                                r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
   Resource group               ID                                 Name
                                db8e8d865a83e0aae03f25a492c5b39e   Default
   Created                      2023-10-18T22:15:15+00:00
   Replication role             none
   Replication status           none
   Replication status reasons   Status code   Status message
                                -             -
   Snapshot count               0
   Snapshot size                0
   Source snapshot              -
   Allowed Access Protocols     nfs4
   Availability Mode            zonal
   Bandwidth(Mbps)              1
   Storage Generation           1
   

3. 대상 지역에서 ibmcloud is share-replica-create 명령을 실행하여 복제본 공유를 만듭니다. 올바른 지역을 타겟팅하지 않는 경우 ibmcloud target -r REGION 명령을 사용하여 타겟 지역을 전환하세요. --source-share-id 옵션을 사용하여 ID 또는 CRN별로 소스 공유를 지정합니다. 복제본 파일 공유가 만들어질 영역과 복제본 공유의 프로필을 정의하는 값을 입력합니다. --replication-cron-spec 옵션을 사용하여 cron 식을 사용하여 복제 일정을 지정합니다. 소스 파일 공유에 user_managed 암호화가 있는 경우 --encryption-key-crn 을 제공해야 합니다. --encryption-key-crn 속성은 달리 지정하지 않아야 합니다.

   ibmcloud is share-replica-create --name my-replica-share --zone us-south-3 --profile dp2 --replication-cron-spec '10 05 * * *' --source-share my-file-share
   

   Creating replica file share my-replica-share under account Test Account as user test.user@ibm.com...
   ID                               r006-6d1719da-f790-45cc-9f68-896fd5673a1a
   Name                             my-replica-share
   CRN                              crn:v1:bluemix:public:is:us-south-3:a/a1234567::share:r006-6d1719da-f790-45cc-9f68-896fd5673a1a
   Lifecycle state                  pending
   Access control mode              security_group
   Accessor binding role            origin
   Allowed transit encryption modes ipsec,none
   Zone                             us-south-3
   Profile                          dp2
   Size(GB)                         1000
   IOPS                             100
   User Tags                        docs:test
   Encryption                       provider_managed
   Mount Targets                    ID                          Name
                                    No mounted targets found.
   Resource group                   ID                                 Name
                                    db8e8d865a83e0aae03f25a492c5b39e   Default
   Created                          2024-06-25T15:13:18+00:00
   Latest job                       Job status   Job status reasons
                                    running      -
   Replication cron spec            10 05 * * *
   Replication role                 replica
   Replication status               initializing
   Replication status reasons       Status code   Status message
                                    -             -
   Source share                     ID                                          Name            Resource type
                                    r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share   share
   Snapshot count                   0
   Snapshot size                    0
   Source snapshot                  -
   Allowed Access Protocols         nfs4
   Availability Mode                zonal
   Bandwidth(Mbps)                  1
   Storage Generation               1
   

API를 사용하여 복제본으로 파일 공유 작성

동일한 리전 내에 복제본이 있는 구역 기반 파일 공유를 동시에 생성할 수 있습니다. 이 방식은 복제본이 동일한 리전에 남아 있는 존 기반 공유에 대해서만 지원됩니다. 지역 간 복제본은 복제본을 초기화할 때 소스 공유가 안정적인 상태여야 하므로 별도의 단계에서 생성해야 합니다.

파일 공유를 생성할 때, 다른 영역에 복제본 파일 공유도 함께 생성되도록 지정할 수 있습니다. POST /shares 요청을 수행하고 replica_share 특성을 지정하여 복제본 파일 공유를 정의합니다.

다음 예제는 소스 공유 source-share-001 에 대한 복제본 test-replica-001 를 작성합니다. 파일 공유를 생성할 때 선택 사항인 마운트 대상은 복제본 파일 공유와 소스 파일 공유에 대해 지정됩니다.

curl -X POST\
"$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "name": "source-share-001",
    "profile":{"name":"dp2"},
    "size":100,
    "iops": 400,
    "mount-targets":[{"vpc":{"id":"08669c86-4c8a-4bfa-8ddc-37071f955c52"}],
    "zone":{"name":"us-south-1"},
    "replica_share":{
  	   "name": "test-replica-001",
      "profile":{"name":"dp2"},
      "replication_cron_spec":"0 */5 * * *",
      "zone":{"name":"us-south-3"},
      "mount_targets": [
        {"virtual_network_interface": {"subnet": {"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5"}}},
        {"vpc": {"id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}],
      "resource_group": {},
      "allowed_transit_encryption_modes": "ipsec",
      "user_tags": ["string"]}}]
      }
    "resource_group": {},
    "allowed_transit_encryption_modes": "ipsec",
    "user_tags": ["string"]
   }'

API를 사용하여 기존 파일 공유에 대한 복제본 작성

기존 파일 공유에 복제 기능을 추가하려면, 다른 영역에 복제 공유를 생성해야 합니다. POST /shares 요청에서 복제본 공유의 이름 및 프로파일을 지정하고 이름, ID 또는 CRN으로 source_share 를 지정하십시오. 그 밖의 필수 속성으로는 zone 및 복제 일정을 지정하는 ` `replication_cron_spec이 있습니다. 15분 간격으로 데이터를 복제하도록 예약할 수 있습니다.