BackupPlan v1.1.1 커스텀 리소스 정의

사양 스키마

BackupPlanSpec은 BackupPlan의 원하는 상태를 정의합니다.

backupLocation:
  gcsOptions:
    bucket: string
    key: string
    secretRef:
      name: string
      namespace: string
  type: string
backupRetainDays: integer
backupSchedules:
  differential: string
  full: string
  incremental: string
dbclusterRef: string
paused: boolean

필드 유형 필수 또는 선택사항	설명
backupLocation
object 선택사항	BackupLocation은 백업을 저장할 원격 객체 스토리지 위치를 지정합니다. 예를 들어 Cloud Storage 버킷의 사양이 있습니다. 이 필드는 선택사항입니다. 기본적으로 백업은 백업 디스크에 저장됩니다.
backupLocation.gcsOptions
object 선택사항	gcsOptions는 Cloud Storage 종속 옵션에 대한 참조입니다.
backupLocation.gcsOptions.bucket
string 필수	버킷은 필수 입력란입니다(예: dbs-dump-bucket). 사용자는 Operator 내에서 저장소 버킷에 대한 적절한 쓰기 액세스 권한을 보장해야 합니다.
backupLocation.gcsOptions.key
string 필수	덤프 파일의 객체 키입니다. (예: ods-dump/scottschema.dmp).
backupLocation.gcsOptions.secretRef
object 선택사항	SecretRef는 GCS 액세스 정보를 저장하는 보안 비밀에 대한 참조입니다.
backupLocation.gcsOptions.secretRef.name
string 선택사항	이름은 보안 비밀 리소스를 참조하는 네임스페이스 내에서 고유합니다.
backupLocation.gcsOptions.secretRef.namespace
string 선택사항	네임스페이스는 보안 비밀 이름이 고유해야 하는 공간을 정의합니다.
backupLocation.type
string 필수	유효한 값: GCS, S3. 저장소 유형 (Amazon S3의 경우 S3, Google Cloud Storage의 경우 GCS)으로, 에이전트에게 사용할 저장소 시스템/API를 알려줍니다.
backupRetainDays
integer 선택사항	기본값: 14, 최솟값: 1, 최대값: 90 서비스에서 백업을 삭제하는 경과 일수입니다. 지정된 경우 이 BackupPlan에 따라 생성된 백업은 경과 시간이 create_time + backup_retain_days에 도달하면 자동으로 삭제됩니다. 유효한 값은 1~90일입니다. 지정하지 않으면 기본값은 보관 기간 14일입니다.
backupSchedules
object 선택사항	다양한 유형의 백업에 대한 일정을 정의합니다. 전체, 차등, 증분 백업 유형이 지원됩니다. https://pgbackrest.org/user-guide.html#concept/backup 이 필드는 선택사항입니다. 기본적으로 매일 자정에 전체 백업을 1회 수행합니다.
backupSchedules.differential
string 선택사항	차등 pgBackRest 백업의 크론 일정을 정의합니다. 표준 Cron 일정 문법을 따릅니다(https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax).
backupSchedules.full
string 선택사항	전체 pgBackRest 백업의 크론 일정을 정의합니다. 표준 Cron 일정 문법을 따릅니다(https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax).
backupSchedules.incremental
string 선택사항	전체 pgBackRest 백업의 크론 일정을 정의합니다. 표준 Cron 일정 문법을 따릅니다(https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax).
dbclusterRef
string 선택사항	이 백업 계획에서 구성하는 DBCluster 이름입니다. 이 필드는 필수이며 변경할 수 없습니다.
paused
boolean 선택사항	기본값: false. 이 BackupPlan에 따른 백업 생성이 일시중지되었는지 나타내는 플래그입니다. true로 설정하면 서비스는 이 BackupPlan에 따라 새 백업의 예약을 일시중지합니다. 기본값은 false입니다.

상태 스키마

BackupPlanStatus는 BackupPlan의 관찰된 상태를 정의합니다.

conditions:
- lastTransactionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
criticalIncidents:
- code: string
  createTime: string
  message: string
  messageTemplateParams: object
  resource:
    component: string
    location:
      cluster: string
      group: string
      kind: string
      name: string
      namespace: string
      version: string
  stackTrace:
  - component: string
    message: string
  transientUntil: string
lastBackupTime: string
nextBackupTime: string
observedGeneration: integer
phase: string
reconciled: boolean
recoveryWindow:
  begin: string
  end: string

필드 유형 필수 또는 선택사항	설명
conditions
list (object) 선택사항	조건은 항목의 현재 상태에 대한 최근 관찰 결과를 나타냅니다.
conditions[]
object 선택사항	조건에는 현재
conditions[].lastTransactionTime
string 필수	조건이 특정 상태에서 다른 상태로 전환된 마지막 시간입니다. 이는 기본 조건이 변경된 시점입니다. 이 시간을 알 수 없는 경우에는 API 필드가 변경된 시간을 사용해도 됩니다.
conditions[].message
string 필수	전환에 대한 세부정보를 나타내는 인간이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.
conditions[].observedGeneration
integer 선택사항	조건이 설정된 기준인 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 12이지만 .status.conditions[x].observedGeneration이 9이면 인스턴스의 현재 상태와 관련하여 조건이 최신이 아닙니다.
conditions[].reason
string 필수	최대 길이: 1,024, 최소 길이: 1 조건의 마지막 전환 이유를 나타내는 프로그래매틱 식별자가 포함됩니다. 특정 조건 유형의 생산자는 이 필드의 예상 값과 의미, 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 입력란은 비워 둘 수 없습니다.
conditions[].status
string 필수	조건 상태(True, False, 알 수 없음 중 하나)입니다.
conditions[].type
string 필수	최대 길이: 316 CamelCase 또는 foo.example.com/CamelCase 형식의 조건 유형입니다.
criticalIncidents
object 필수	모든 활성 중대한 이슈의 플랫 목록입니다. CriticalIncident에는 진행 중인 심각한 이슈에 관한 모든 정보가 포함됩니다.
criticalIncidents[].code
string 필수	이 특정 오류의 오류 코드입니다. 오류 코드는 'DBSE1012'와 같은 DBSE+숫자 문자열입니다.
criticalIncidents[].createTime
string 필수	이 Incident가 출처에서 생성된 타임스탬프입니다.
criticalIncidents[].message
string 선택사항	발생한 문제/오류
criticalIncidents[].messageTemplateParams
object 선택사항	사용자 인터페이스에서 사용자 친화적인 데이터 기반 버전의 메시지를 생성하는 데 필요한 키-값 쌍을 포함합니다.
criticalIncidents[].resource
object 필수	이슈를 신고한 데이터베이스 서비스 구성요소와 Kubernetes 리소스에 관한 정보를 포함합니다.
criticalIncidents[].resource.component
string 필수	문제를 신고한 데이터베이스 서비스 하위 시스템의 내부 식별자입니다.
criticalIncidents[].resource.location
object 선택사항	위치
criticalIncidents[].resource.location.cluster
string 선택사항	영향을 받는 Kubernetes 리소스의 클러스터 이름입니다.
criticalIncidents[].resource.location.group
string 선택사항	Kubernetes 리소스의 그룹 이름입니다.
criticalIncidents[].resource.location.kind
string 선택사항	Kubernetes 리소스의 종류입니다.
criticalIncidents[].resource.location.name
string 선택사항	영향을 받는 Kubernetes 리소스의 이름입니다.
criticalIncidents[].resource.location.namespace
string 선택사항	영향을 받은 Kubernetes 리소스의 네임스페이스입니다.
criticalIncidents[].resource.location.version
string 선택사항	Kubernetes 리소스의 버전입니다.
criticalIncidents[].stackTrace
object 선택사항	스택 트레이스의 메시지 목록(구조화되지 않음)
criticalIncidents[].stackTrace.component
string 선택사항	메시지를 로깅한 데이터베이스 서비스 구성요소의 이름입니다.
criticalIncidents[].stackTrace.message
string 선택사항	로깅된 메시지입니다.
criticalIncidents[].transientUntil
string 선택사항	TransientUntil이 있는 경우 지정된 시간까지는 문제를 일시적인 것으로 간주해야 함을 나타냅니다.
lastBackupTime
string 선택사항	최근에 실행된 백업의 타임스탬프입니다.
nextBackupTime
string 선택사항	다음으로 예약된 백업의 타임스탬프입니다.
observedGeneration
integer 선택사항	내부: 컨트롤러에서 관찰한 생성입니다.
phase
string 선택사항	BackupPlan의 단계입니다.
reconciled
boolean 선택사항	내부: 컨트롤러에서 리소스를 조정했는지 여부입니다.
recoveryWindow
object 선택사항	현재 사용할 수 있는 복구 기간입니다.
recoveryWindow.begin
string 선택사항	시작 시간입니다.
recoveryWindow.end
string 선택사항	종료 시간입니다.