备份 v1.1.1 自定义资源定义

规范架构

BackupSpec 定义了 Backup 的期望状态。

backupPlanRef: string
dbclusterRef: string
manual:
  physicalbackupSpec:
    backuptype: string
  type: boolean
physicalbackupSpec: string

字段 类型 必填或可选	说明
backupPlanRef
string 必填	用于创建此备份的 BackupPlan 的名称。
dbclusterRef
string 必填	此备份所属的 DBCluster 名称。
manual
boolean 可选	指示此备份是定期备份还是手动备份。如果未指定，则默认为 false（安排的备份）。
manual.physicalbackupSpec
object 可选	包含实体备份的规范，允许将备份类型指定为 {"full","diff","incr"} 中的枚举。如果未指定，则默认为完整。
manual.physicalbackupSpec.backuptype
string 可选	要创建的备份类型。它是 {"full","diff","incr"} 中的枚举。如果未指定，则默认为完整。

状态架构

BackupStatus 定义了 Backup 的观察状态。

completeTime: string
conditions:
- lastTransitionTime: string
  message: string
  observedGeneration: integer
  reason: string
  status: string
  type: string
createTime: 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
observedGeneration: integer
phase: string
physicalbackupStatus:
  backupID: string
  priorBackup: string
reconciled: boolean
retainexpireTime: string

字段 类型 必填或可选	说明
completeTime
string 可选	备份的完成时间。
conditions[]
object 可选	表示实体当前状态的最新可用观察结果。
conditions[].lastTransitionTime
string 必填	条件上次从一种状态转换到另一种状态的时间。此时间应为底层条件发生变化的时间。如果时间未知，则可以使用 API 字段更改的时间。
conditions[].message
string 必填	人类可读的消息，指示有关转换的详细信息。此值可以是空字符串。
conditions[].observedGeneration
integer 可选	表示设置条件所基于的 .metadata.generation。 例如，如果 .metadata.generation 目前为 12，但 .status.conditions[x].observedGeneration 为 9，则表示相应条件对于实例的当前状态已过时。
conditions[].reason
string 必填	包含一个程序化标识符，用于指明条件上次转换的原因。特定条件类型的生产者可以定义此字段的预期值和含义，以及这些值是否被视为保证 API。该值应为驼峰式字符串。 此字段不得为空。
conditions[].status
string 必填	条件的状态，为 True、False、Unknown 之一。
conditions[].type
string 必填	条件类型，采用驼峰命名法或 foo.example.com/CamelCase 格式。 许多 .condition.type 值在资源（例如“可用”）之间是一致的，但由于任意条件可能很有用（请参阅 .node.status.conditions），因此能够解析冲突非常重要。 它匹配的正则表达式为 (dns1123SubdomainFmt/)?(qualifiedNameFmt)。
createTime
string 可选	备份的创建时间。
criticalIncidents[]
object 必填	CriticalIncidents 是所有有效严重事故的平面列表。
criticalIncidents[].code
string 必填	此特定错误的错误代码。错误代码为 DBSE+数字字符串，例如“DBSE1012”。
criticalIncidents[].createTime
string 必填	在来源中创建此服务工单时的时间戳。
criticalIncidents[].message
string 可选	Message 用于描述发生的事故/错误。
criticalIncidents[].messageTemplateParams
object 可选	包含在界面中生成简单易用的数据驱动型“信息”版本所需的键值对。
criticalIncidents[].resource
object 必填	包含有关报告了突发事件的数据库服务组件以及 K8s 资源的信息。
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 可选	如果存在，则表示在指定时间之前应将问题视为暂时性问题。
observedGeneration
integer 可选	内部：控制器观察到的生成。
phase
string 可选	BackupPhase 是备份的阶段。
phase.physicalBackupStatus
object 可选	PhysicalBackupStatus 包含特定于物理备份的状态信息。
phase.physicalBackupStatus.backupID
string 可选	pgbackrest 跟踪的物理备份的唯一 ID。
phase.physicalBackupStatus.priorBackup
string 可选	PriorBackup 是此备份依赖的上一个备份。
reconciled
boolean 可选	内部：资源是否已由控制器协调。
retainExpireTime
string 可选	RetainExpireTime 用于定义备份的删除时间。这是一个仅限输出的字段，根据 create_time + retain_days 计算得出，并会在备份的 retain_days 字段更新时相应更新。