복제의 개념

복제는 새로 만든 개체와 개체 업데이트를 소스 버킷에서 대상 버킷으로 복사합니다.

• 새 개체 또는 기존 개체의 새 버전(복제 규칙이 버킷에 추가된 후에 생성된)만 대상 버킷에 복사됩니다. 기존 개체를 복사하여 복제된 새 버전을 만들어 복제할 수 있습니다.
• 소스 개체의 메타데이터가 복제된 개체에 적용됩니다.
• 두 버킷 간의 양방향 복제를 사용하려면 두 버킷 모두에서 규칙이 활성화되어 있어야 합니다.
• 필터(접두사 및/또는 태그로 구성)를 사용하여 개체의 하위 집합에만 적용되도록 복제 규칙의 범위를 지정할 수 있습니다. 단일 정책에 여러 규칙을 정의할 수 있으며 이러한 규칙은 서로 다른 대상을 지정할 수 있습니다. 이러한 방식으로 동일한 버킷에 있는 여러 개체를 다른 대상에 복제할 수 있습니다.

왜 복제를 사용하나요?

• 데이터 사본을 다른 지리적 위치의 버킷에 보관하세요.
• 허용된 위치에만 복제본을 저장하는 복제 규칙을 정의하여 데이터 주권에 대한 규정 준수 규정을 충족하세요.
• 복제는 마지막 수정 시간, 버전 ID 등과 같은 개체 메타데이터를 유지하므로 프로덕션 데이터와 테스트 데이터를 동기화 상태로 유지합니다.
• 대상 버킷에 대해 다른 스토리지 클래스 및/또는 수명 주기 규칙을 정의하여 소스와 독립적으로 복제된 개체에 대한 스토리지 클래스 및 수명 주기 정책을 관리합니다. 마찬가지로 별도의 서비스 인스턴스 또는 IBM Cloud 계정의 버킷에 복제본을 저장하고 복제본에 대한 액세스를 독립적으로 제어할 수도 있습니다.

복제 시작하기

시작하기 위해 충족해야 하는 몇 가지 전제 조건은 다음과 같습니다:

• 소스 버킷에서 Writer 또는 Manager 플랫폼 역할을 설정하거나 적절한 복제 작업(예: cloud-object-storage.bucket.put_replication)이 할당된 사용자 지정 역할을 설정합니다.
• 대상 버킷에 액세스할 필요는 없지만 소스 버킷이 대상 버킷에 쓸 수 있도록 허용하는 새 IAM 정책을 만들 수 있는 충분한 플랫폼 역할이 있어야 합니다.
• 대상 버킷에는 레거시 버킷 방화벽이 사용 설정되어 있지 않아야 하지만 컨텍스트 기반 제한을 사용할 수 있습니다.
• SSE-C를 사용하여 암호화된 개체는 복제할 수 없지만, Key Protect 같은 관리형 암호화(SSE-KMS )는 복제와 완벽하게 호환됩니다.
• 보관된 상태의 개체는 복제할 수 없습니다.
• 소스 버킷과 대상 버킷이 서로 다른 IBM 계정에 있는 경우, 각 계정에서 버킷을 만들어야 합니다.
• 소스 버킷과 대상 버킷 모두에서 버전 관리를 사용 설정합니다.

버전 관리가 복제를 위한 요구 사항이므로 불변 Object Storage 정책 로 구성된 버킷의 오브젝트는 복제할 수 없습니다.

하나의 IBM 계정 사용

동일한 IBM 계정의 버킷 간에 개체를 복제하려면 다음과 같이 하세요:

1. 선택한 소스 버킷으로 이동한 후 구성 탭을 클릭합니다.
2. 버킷 복제를 찾아서 복제 설정 버튼을 클릭합니다.
3. 복제 소스를 선택하고 ‘다음’을 클릭합니다.
4. 드롭다운 메뉴에서 인스턴스와 버킷을 선택합니다. 또는 라디오 버튼을 아니요로 전환하고 대상 버킷의 CRN에 붙여넣습니다.
5. 권한 확인 버튼을 클릭합니다.

이제 소스 버킷 Writer 에 대상 버킷에 대한 권한을 부여해야 합니다. 이를 수행하는 방법에는 여러 가지가 있지만 가장 쉬운 방법은 IBM Cloud Shell 및 IBM Cloud CLI를 사용하는 것입니다.

1. IBM Cloud Shell 새 창 또는 탭에서 열기를 클릭합니다.
2. 개체 스토리지 콘솔에 표시된 IBM Cloud CLI 명령을 복사하여 새 셸에 붙여넣습니다.
3. 버킷 구성 창 또는 탭으로 돌아가서 권한 확인 버튼을 다시 클릭합니다.

이제 복제 규칙을 만들겠습니다.

1. 규칙 상태 라디오 버튼이 사용으로 설정되어 있는지 확인합니다.
2. 규칙의 이름과 우선순위, 그리고 복제 규칙의 적용을 받는 개체를 제한할 접두사 또는 태그 필터를 지정합니다.
3. 완료를 클릭하십시오.

다른 IBM 계정 사용

서로 다른 IBM 계정의 버킷 간에 개체를 복제하려면 다음과 같이 하세요:

1. 대상 IBM 계정에 IAM 정책을 설정합니다. IAM 정책 만들기에 대한 자세한 내용은 IAM 정책이란 무엇이며 누가 정책을 할당할 수 있는지 참조하세요.
2. 버킷 구성 페이지에서 CRN 형식의 계정 ID와 서비스 인스턴스 ID를 찾습니다.
3. 대상 계정의 IBM Cloud UI에서 관리>접속**(IAM)을** 클릭합니다.
4. 왼쪽 패널에서 인증을 클릭합니다.
5. '생성'을 클릭하여 새로운 IAM 정책을 생성합니다.
6. 서비스 권한 부여 페이지 구성을 부여합니다. 새 IAM 정책을 만든 후 이 페이지로 이동하게 됩니다.
7. 다른 계정을 선택하고 소스 계정의 계정 ID를 입력합니다.
8. 서비스 액세스 권한을 Cloud Object Storage.
9. 액세스 범위에서 특정 리소스를 선택합니다.
10. 소스 서비스 인스턴스를 선택하고 소스 버킷의 서비스 인스턴스 ID를 입력합니다.
11. Target에서 소스 버킷 액세스를 위해 Cloud Object Storage 을 선택하여 소스 버킷 액세스를 선택합니다.
12. 대상 범위에서 특정 리소스> 서비스** 인스턴스를 선택합니다.
13. 드롭다운 메뉴에서 대상 계정의 서비스 인스턴스 ID를 선택합니다.
14. 필요에 따라 객체 작성자 또는 작성자 역할을 선택합니다.

개체 작성자 역할은 복제를 활성화하는 데 충분합니다.

용어

소스 버킷: 복제 정책이 구성된 버킷입니다. 복제된 객체의 소스입니다.

대상 버킷: 대상 버킷: 소스 버킷 복제 정책에서 대상으로 정의된 버킷입니다. 복제된 객체의 대상입니다. '목적지' 버킷이라고도 합니다.

복제본: 복제: 소스 버킷에 대한 요청으로 인해 대상 버킷에 생성된 새 개체입니다.

복제란 무엇인가요?

CopyObject, PutObject 또는 CompleteMultipartUpload 를 통해 생성된 새 개체는 소스 버킷에서 대상 버킷으로 리플리케이트됩니다. 복제된 객체는 소스 객체에서 다음 메타데이터 필드를 상속합니다: Etag, Last Modified Time, Version ID, user-attributes, 및 Tags.

복제 정책에 의해 구성된 경우 삭제 마커가 복제됩니다.

버전 태그에 대한 업데이트는 소스 버킷에서 대상 버킷으로 리플리케이트됩니다.

다음은 복제되지 않습니다:

• 수명 주기 이벤트에 의해 시작된 작업
• 아카이브에 직접 기록된 개체
• 아카이브 계층에서 복원된 개체
• SSE-C를 통해 암호화된 개체
• 오브젝트 ACL

비즈니스 연속성 및 재해 복구를 위한 복제 활용

복제는 장애 발생 시 서비스 연속성을 제공하는 데 사용할 수 있습니다:

• 소스 버킷과 대상 버킷이 서로 다른 위치에 있는지 확인하세요.
• 두 버킷 간에 최신 버전의 개체가 동기화되어 있는지 확인합니다. 다음과 같은 도구를 사용하면 Rclone ( rclone check 명령어)와 같은 도구는 명령줄에서 동기화를 확인하는 데 유용할 수 있습니다.
• 서비스 중단이 발생하면 애플리케이션의 트래픽을 대상 버킷으로 리디렉션할 수 있습니다.

일관성 및 데이터 무결성

IBM Cloud Object Storage 은 모든 데이터 IO 작업에 대해 강력한 일관성을 제공하지만, 버킷 구성은 결국 일관성을 유지합니다. 버킷에서 처음으로 복제 규칙을 활성화한 후, 구성이 시스템 전체에 전파되고 새 개체가 복제되기 시작하려면 잠시 시간이 걸릴 수 있습니다.

오류 처리

복제 실패는 버킷 설정 오류, 서비스 중단, 대상 버킷에 대한 사용자의 조작 등(이에 국한되지 않음) 여러 가지 이유로 발생할 수 있습니다.

COS에는 복제 오류를 처리할 수 있는 내결함성이 내장되어 있습니다. 오류가 발생하면 COS는 최대 30일 동안 재시도할 수 있습니다. 재시도 빈도는 오류의 유형에 따라 달라질 수 있습니다. 예를 들어, 드물게 발생하는 I/O 오류로 인한 오류는 몇 시간 내에 재시도될 수 있는 반면, 사용자 버킷의 잘못된 구성으로 인한 오류는 하루에 한 번만 재시도될 수 있습니다. 오류가 30일 이내에 해결되지 않으면, 시스템에서 더 이상 자동으로 재시도하지 않습니다. 모든 장기 오류는 다음을 통해 나열할 수 있습니다. ListBucketReplicationFailures 를 통해 나열할 수 있습니다.

30일 이상 경과한 “오래된” 오류에 대해 재시도를 원할 경우, PutBucketReplicationFailureReattempt 를 사용하여 재시도를 트리거할 수 있습니다.

IAM 조치

복제와 관련된 새로운 IAM 작업이 있습니다.

Activity Tracker 이벤트

복제는 추가 이벤트를 생성합니다.

cloud-object-storage.bucket-replication.create 이벤트의 경우 다음 필드는 추가 정보를 제공합니다.

복제가 활성화되면 오브젝트에 대한 조작이 다음과 같은 추가 정보를 생성할 수 있습니다.

오브젝트가 소스에 기록될 때부터 대상에 기록될 때까지 오브젝트를 추적할 수 있습니다. 오브젝트 쓰기와 연관된 요청 ID를 검색하면 세 개의 이벤트가 표시됩니다.

• 원래 PUT.
• 소스의 동기화 요청입니다.
• 대상의 PUT 요청입니다.

이 세 개의 누락 중 하나가 실패를 표시합니다.

사용량 및 계정

모든 복제본은 오브젝트 자체이며 다른 데이터와 마찬가지로 사용에 기여 합니다. 복제 프로세스에서 사용되는 대역폭은 청구되지 않지만 복제에 성공하면 청구 가능한 PUT, GET 및 HEAD 요청이 발생합니다.

복제는 IBM Cloud Monitoring 에 사용할 추가 메트릭을 생성합니다:

• ibm_cos_bucket_replication_sync_requests_issued
• ibm_cos_bucket_replication_sync_requests_received

상호작용

기존 오브젝트 복제

복제 규칙은 규칙이 구성되어 버킷에 적용된 후에 작성된 오브젝트에 대해서만 작동할 수 있습니다. 복제해야 하는 버킷에 기존 오브젝트가 있는 경우 복제 프로세스는 오브젝트의 존재를 인식해야 합니다. 이는 PUT copy 조작을 사용하여 오브젝트를 자신에게 복사함으로써 쉽게 수행할 수 있습니다.

이 프로세스는 작성 시간소인을 포함하여 일부 오브젝트 메타데이터를 재설정합니다. 이는 라이프사이클 정책 및 작성 또는 수정 시간소인을 사용하는 기타 서비스 (예: 컨텐츠 전달 네트워크) 에 영향을 줍니다. 오브젝트 메타데이터 재설정으로 인해 발생할 수 있는 중단이 적절하게 처리되는지 확인하십시오.

프로세스에는 다음이 포함됩니다.

1. 복제 규칙을 따라야 하는 버킷의 모든 오브젝트 목록 작성
2. 해당 목록을 반복하여 소스가 요청의 대상과 동일한 각 오브젝트에서 PUT copy 조작을 수행합니다.

이 예는 PUT copy 요청으로 작성된 오브젝트의 새 버전만 복제합니다. 오브젝트의 모든 버전을 복제하려면 각 개별 버전도 복사해야 합니다.

다음 예제는 Python으로 작성되었지만 모든 프로그래밍 언어 또는 컨텍스트에서 알고리즘을 적용할 수 있습니다.

import os
import sys
import ibm_boto3
from ibm_botocore.config import Config

# Create client connection
cos = ibm_boto3.client("s3",
                       ibm_api_key_id=os.environ.get('IBMCLOUD_API_KEY'),
                       ibm_service_instance_id=os.environ['SERVICE_INSTANCE_ID'],
                       config=Config(signature_version="oauth"),
                       endpoint_url=os.environ['US_GEO']
                       )

# Define the bucket with existing objects for replication
bucket = os.environ['BUCKET']

def copy_in_place(BUCKET_NAME):
    print("Priming existing objects in " + bucket + " for replication...")

    paginator = cos.get_paginator('list_objects_v2')
    pages = paginator.paginate(Bucket=bucket)

    for page in pages:
        for obj in page['Contents']:
            key = obj['Key']
            print("  * Copying " + key + " in place...")
            try:
                headers = cos.head_object(
                    Bucket=bucket,
                    Key=key
                    )
                md = headers["Metadata"]
                cos.copy_object(
                    CopySource={
                        'Bucket': bucket,
                        'Key': key
                        },
                    Bucket=bucket,
                    Key=key,
                    TaggingDirective='COPY',
                    MetadataDirective='REPLACE',
                    Metadata=md
                    )
                print("    Success!")
            except Exception as e:
                print("    Unable to copy object: {0}".format(e))
    print("Existing objects in " + bucket + " are now subject to replication rules.")

copy_in_place(bucket)

REST API 예제

다음 예제는 사용하기 쉽도록 cURL 을 사용하여 표시됩니다. 환경 변수는 $BUCKET, $TOKEN 및 $REGION 와 같은 사용자 특정 요소를 표시하는 데 사용됩니다. $REGION 에는 모든 네트워크 유형 스펙도 포함되므로 사설 네트워크를 사용하여 us-south 의 버킷에 요청을 전송하려면 변수를 private.us-south 로 설정해야 합니다.

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: exuBoz2kFBykNwqu64JZuA==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
            <Rule>
              <ID>SimpleReplication</ID>
              <Priority>1</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Disabled</Status>
              </DeleteMarkerReplication>
              <Filter/>
              <Destination>
                <Bucket>$DESTINATION_CRN</Bucket>
              </Destination>
          	</Rule>
          </ReplicationConfiguration>'

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: exuBoz2kFBykNwqu64JZuA==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
            <Rule>
              <ID>ProjectA</ID>
              <Priority>10</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Enabled</Status>
              </DeleteMarkerReplication>
              <Filter>
                <Prefix>project_a/</prefix>
              </Filter>
              <Destination>
                <Bucket>$DESTINATION_CRN_A</Bucket>
              </Destination>
          	</Rule>
            <Rule>
              <ID>ProjectB</ID>
              <Priority>5</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Enabled</Status>
              </DeleteMarkerReplication>
              <Filter>
                <Prefix>project_b/</prefix>
              </Filter>
              <Destination>
                <Bucket>$DESTINATION_CRN_B</Bucket>
              </Destination>
          	</Rule>
            <Rule>
              <ID>AcmeCorp</ID>
              <Priority>20</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Enabled</Status>
              </DeleteMarkerReplication>
              <Filter>
                <Tag>
                  <Key>Client</Key>
                  <Value>ACME</Value>
                </Tag>
              </Filter>
              <Destination>
                <Bucket>$DESTINATION_CRN_C</Bucket>
              </Destination>
          	</Rule>
          </ReplicationConfiguration>'

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN'

<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Rule>
    <ID>SimpleReplication</ID>
    <Status>ENABLED</Status>
    <DeleteMarkerReplication>
      <Status>DISABLED</Status>
    </DeleteMarkerReplication>
    <Destination>
      <Bucket>crn:v1:bluemix:public:cloud-object-storage:global:a/9978e07eXXXXXXXX66c89c428028654:ef1c725e-XXXX-4967-bcc1-734c03a2b846:bucket:replication-destination</Bucket>
    </Destination>
    <Priority>1</Priority>
    <Filter/>
  </Rule>
</ReplicationConfiguration>

curl -X "DELETE" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN'

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?ibm-replication-failures" \
     -H 'Authorization: bearer $TOKEN'

<ListReplicationFailureResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Name>example</Name>
    <FirstSyncAttemptedBefore>2025-12-15T00:00:00.000Z</FirstSyncAttemptedBefore>
    <MaxKeys>10</MaxKeys>
    <IsTruncated>false</IsTruncated>
    <EncodingType>false</EncodingType>
    <KeyCount>2</KeyCount>
    <Contents>
        <Key>test-obj+*1765434016787</Key>
        <VersionId>00000000-0000-0000-0000-019b0c114413</VersionId>
        <SyncType>Content</SyncType>
        <FirstSyncAttempted>2025-12-11T06:20:16.787Z</FirstSyncAttempted>
        <LastSyncAttempted>2025-12-11T06:20:16.787Z</LastSyncAttempted>
        <SyncFailureCause>Versioning disabled on destination bucket</SyncFailureCause>
    </Contents>
    <Contents>
        <Key>test-obj+*1765434016786</Key>
        <VersionId>00000000-0000-0000-0000-019b0c114412</VersionId>
        <SyncType>Content</SyncType>
        <FirstSyncAttempted>2025-12-11T06:20:16.786Z</FirstSyncAttempted>
        <LastSyncAttempted>2025-12-11T06:20:16.786Z</LastSyncAttempted>
        <SyncFailureCause>Replication operation not authorized on target bucket</SyncFailureCause>
    </Contents>
</ListReplicationFailureResult>

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?ibm-replication-reattempt" \
     -H 'Authorization: bearer $TOKEN'

HTTP/1.1 204 No Content
Connection: close
...
x-ibm-replication-reattempt-scheduled-time: Fri, 12 Dec 2025 00:00:00 GMT

SDK 예제

다음 예제에서는 오브젝트 버전화의 구현이 사용자 정의 엔드포인트의 설정을 허용하는 S3-compatible 라이브러리 또는 도구와 완전히 호환 가능해야 하지만 Python 및 Node.js용 IBM COS SDK를 사용합니다. 써드파티 도구를 사용하려면 AWS V4 서명을 계산하기 위한 HMAC 신임 정보가 필요합니다. HMAC 신임 정보에 대한 자세한 정보는 문서를 참조하십시오.

#!/usr/bin/env python3

import ibm_boto3
from ibm_botocore.config import Config
from ibm_botocore.exceptions import ClientError

# Define constants
API_KEY = os.environ.get('IBMCLOUD_API_KEY')
SERVICE_INSTANCE = os.environ.get('SERVICE_INSTANCE_ID')
ENDPOINT = os.environ.get('ENDPOINT')

BUCKET = "my-replication-bucket" # The bucket that will enable replication.

# Create resource client with configuration info pulled from environment variables.
cosClient = ibm_boto3.client("s3",
                         ibm_api_key_id=API_KEY,
                         ibm_service_instance_id=SERVICE_INSTANCE,
                         config=Config(signature_version="oauth"),
                         endpoint_url=ENDPOINT
                         )

response = cosClient.put_bucket_versioning(
    Bucket=BUCKET,
    ReplicationConfiguration={
        'Rules': [
            {
                'ID': 'string',
                'Priority': 123,
                'Filter': {
                    'Prefix': 'string',
                    'Tag': {
                        'Key': 'string',
                        'Value': 'string'
                    },
                    'And': {
                        'Prefix': 'string',
                        'Tags': [
                            {
                                'Key': 'string',
                                'Value': 'string'
                            },
                        ]
                    }
                },
                'Status': 'Enabled'|'Disabled',
                'Destination': {
                    'Bucket': 'string',
                },
                'DeleteMarkerReplication': {
                    'Status': 'Enabled'|'Disabled'
                }
            },
        ]
    }
)

resp = cosClient.list_object_versions(Prefix='some-prefix', Bucket=BUCKET)

const IBM = require('ibm-cos-sdk');

var config = {
    endpoint: '<endpoint>',
    apiKeyId: '<api-key>',
    serviceInstanceId: '<resource-instance-id>',
};

var cos = new IBM.S3(config);

var params = {
  Bucket: 'STRING_VALUE', /* required */
  ReplicationConfiguration: { /* required */
    Role: 'STRING_VALUE', /* required */
    Rules: [ /* required */
      {
        Destination: { /* required */
          Bucket: 'STRING_VALUE', /* required */
        },
        Status: Enabled | Disabled, /* required */
        Filter: {
          And: {
            Prefix: 'STRING_VALUE',
            Tags: [
              {
                Key: 'STRING_VALUE', /* required */
                Value: 'STRING_VALUE' /* required */
              },
              /* more items */
            ]
          },
          Prefix: 'STRING_VALUE',
          Tag: {
            Key: 'STRING_VALUE', /* required */
            Value: 'STRING_VALUE' /* required */
          }
        },
        ID: 'STRING_VALUE',
        Prefix: 'STRING_VALUE',
        Priority: 'NUMBER_VALUE',
        }
      }
    ]
  },
  ContentMD5: 'STRING_VALUE',
};
cos.putBucketReplication(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});