이 페이지에서는 Google Distributed Cloud (GDC) 에어 갭 환경 내에서 스토리지 버킷의 보관 기간을 설정하는 방법을 안내합니다. GDC 콘솔과 명령줄 인터페이스 (CLI)를 모두 사용하여 스토리지 버킷 내에 데이터를 보관해야 하는 기간을 정의하기 위한 사전 요구사항과 단계를 다룹니다. 이 정보는 규제 및 데이터 관리 요구사항을 충족하는 데 도움이 됩니다.
이 페이지는 GDC 에어 갭 환경에서 스토리지 버킷 설정을 구성하고 관리하는 인프라 운영자 그룹의 IT 관리자 또는 애플리케이션 운영자 그룹의 개발자와 같은 대상을 위한 것입니다. 자세한 내용은 GDC 에어 갭 문서의 대상을 참고하세요.
시작하기 전에
스토리지 버킷은 특정 프로젝트의 범위가 지정된 리소스입니다. 프로젝트는 컨테이너 역할을 하며 버킷을 그룹화하고 Management API 서버를 통해 버킷을 관리할 수 있도록 합니다. 이 페이지에서 작업을 수행하려면 새 프로젝트를 만들거나 충분한 권한이 있는 기존 프로젝트를 선택해야 합니다.
필요한 IAM 역할
IAM 프로젝트 관리자에게 문의하여 프로젝트 네임스페이스에서 다음 역할을 요청하세요.
- 프로젝트 버킷 관리자 (
project-bucket-admin): 스토리지 버킷을 만들고, 업데이트하고, 삭제합니다. - 프로젝트 버킷 객체 뷰어 (
project-bucket-object-viewer): 스토리지 버킷 및 객체의 세부정보를 보고 확인합니다.
자세한 내용은 버킷 액세스 권한 부여를 참고하세요.
개발 환경 준비
관리 API 서버 또는 전역 API 서버에 대해 명령어를 실행하려면 다음 단계를 따르세요.
- 로그인하고 생성합니다. 영역 관리 API 서버의 kubeconfig 파일이 없는 경우 kubeconfig 파일을 생성합니다.
- 이중 영역 버킷의 경우 다음 단계를 따르세요.
- 인프라 운영자 (IO)에게 페어링된 영역에
BucketLocationConfig커스텀 리소스가 생성되었는지 확인합니다. - 전역 API 서버의 kubeconfig 파일을 생성합니다.
- 인프라 운영자 (IO)에게 페어링된 영역에
버킷 보관 기간 설정
콘솔
- 탐색 메뉴에서 객체 스토리지 를 클릭합니다.
- 업데이트할 버킷의 이름을 클릭합니다.
- 구성 탭을 클릭합니다.
- 보안 섹션에서 보관 정책 필드 옆에 있는 수정 을 클릭합니다.
- 기존 일수보다 큰 값으로 일수를 수정하고 저장 을 클릭합니다.
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 버킷 섹션을 참고하세요.