스토리지 버킷 보관 기간 설정

이 페이지에서는 Google Distributed Cloud (GDC) 에어 갭 환경 내에서 스토리지 버킷의 보관 기간을 설정하는 방법을 안내합니다. GDC 콘솔과 명령줄 인터페이스 (CLI)를 모두 사용하여 스토리지 버킷 내에 데이터를 보관해야 하는 기간을 정의하기 위한 사전 요구사항과 단계를 다룹니다. 이 정보는 규제 및 데이터 관리 요구사항을 충족하는 데 도움이 됩니다.

이 페이지는 GDC 에어 갭 환경에서 스토리지 버킷 설정을 구성하고 관리하는 인프라 운영자 그룹의 IT 관리자 또는 애플리케이션 운영자 그룹의 개발자와 같은 대상을 위한 것입니다. 자세한 내용은 GDC 에어 갭 문서의 대상을 참고하세요.

시작하기 전에

스토리지 버킷은 특정 프로젝트의 범위가 지정된 리소스입니다. 프로젝트는 컨테이너 역할을 하며 버킷을 그룹화하고 Management API 서버를 통해 버킷을 관리할 수 있도록 합니다. 이 페이지에서 작업을 수행하려면 새 프로젝트를 만들거나 충분한 권한이 있는 기존 프로젝트를 선택해야 합니다.

필요한 IAM 역할

IAM 프로젝트 관리자에게 문의하여 프로젝트 네임스페이스에서 다음 역할을 요청하세요.

  • 프로젝트 버킷 관리자 (project-bucket-admin): 스토리지 버킷을 만들고, 업데이트하고, 삭제합니다.
  • 프로젝트 버킷 객체 뷰어 (project-bucket-object-viewer): 스토리지 버킷 및 객체의 세부정보를 보고 확인합니다.

자세한 내용은 버킷 액세스 권한 부여를 참고하세요.

개발 환경 준비

관리 API 서버 또는 전역 API 서버에 대해 명령어를 실행하려면 다음 단계를 따르세요.

  1. 로그인하고 생성합니다. 영역 관리 API 서버의 kubeconfig 파일이 없는 경우 kubeconfig 파일을 생성합니다.
  2. 이중 영역 버킷의 경우 다음 단계를 따르세요.

버킷 보관 기간 설정

콘솔

  1. 탐색 메뉴에서 객체 스토리지 를 클릭합니다.
  2. 업데이트할 버킷의 이름을 클릭합니다.
  3. 구성 탭을 클릭합니다.
  4. 보안 섹션에서 보관 정책 필드 옆에 있는 수정 을 클릭합니다.
  5. 기존 일수보다 큰 값으로 일수를 수정하고 저장 을 클릭합니다.

API

기본적으로 언제든지 객체를 삭제할 수 있습니다. 보관 기간으로 객체 잠금을 사용 설정하면 지정된 일수 동안 버킷의 모든 객체가 삭제되지 않도록 할 수 있습니다. 보관 기간이 지난 후 모든 객체를 삭제할 때까지 버킷을 삭제할 수 없습니다.

버킷을 만들 때 객체 잠금을 사용 설정해야 합니다. 버킷을 만든 후에는 객체 잠금을 사용 설정하거나 중지할 수 없습니다. 하지만 기본 객체 보관 기간은 수정할 수 있습니다.

객체 잠금을 사용 설정하거나 사용 설정하지 않고 버킷을 만들 수 있습니다. 객체 잠금을 사용 설정한 경우 기본 보관 기간을 지정하는 것은 선택사항입니다.

보관 기간을 수정하려면 Bucket.spec.bucketPolicy.lockingPolicy.defaultObjectRetentionDays 필드를 버킷 리소스에서 업데이트합니다.

다음은 버킷 리소스에서 필드를 업데이트하는 예시입니다.

apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
  name: BUCKET_NAME
  namespace: NAMESPACE_NAME
spec:
  description: "This bucket has a default retention period specified."
  storageClass: Standard
  bucketPolicy:
    lockingPolicy:
      defaultObjectRetentionDays: RETENTION_DAY_COUNT
----------
apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
  name: BUCKET_NAME
  namespace: NAMESPACE_NAME
spec:
  description: "This would enable object locking but not specify a default retention period."
  storageClass: Standard
  bucketPolicy:
    lockingPolicy:
----------
apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
  name: BUCKET_NAME
  namespace: NAMESPACE_NAME
spec:
  description: "This bucket does not have locking or retention enabled."
  storageClass: Standard

보관 기간에 대한 업데이트는 업데이트 후 버킷에서 생성된 객체에 적용됩니다. 기존 객체의 경우 보관 기간이 변경되지 않습니다.

객체 잠금을 사용 설정한 경우 객체를 덮어쓰려고 하면 객체의 새 버전이 추가됩니다. 두 객체 버전을 모두 가져올 수 있습니다. 객체 버전을 가져오려면 스토리지 객체 나열을 참고하세요.

일회성 쓰기, 다중 읽기 (WORM) 버킷을 만들려면 WORM 버킷 섹션을 참고하세요.