crd/fleet/fleet-crds.yaml (9,719 lines of code) (raw):
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: backupplans.alloydbomni.dbadmin.goog
spec:
group: alloydbomni.dbadmin.goog
names:
kind: BackupPlan
listKind: BackupPlanList
plural: backupplans
shortNames:
- aoobp
singular: backupplan
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .status.phase
name: Phase
type: string
- jsonPath: .status.lastBackupTime
name: LastBackupTime
type: string
- jsonPath: .status.nextBackupTime
name: NextBackupTime
type: string
name: v1
schema:
openAPIV3Schema:
description: BackupPlan is the Schema for the backupplans API
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
description: BackupPlanSpec defines the desired state of BackupPlan.
properties:
backupLocation:
description: BackupLocation specifies the remote object storage location
to store backups. For example, specs to a GCS buckets. This field
is optional. By default, backups are stored in the backup disk.
properties:
gcsOptions:
description: GCSOptions is a reference to GCS dependent options.
properties:
bucket:
description: 'Bucket is a required field, (ex: dbs-dump-bucket)
A user is to ensure proper write access to the storage bucket
from within the Operator.'
type: string
key:
description: 'Object key for the dump files. (ex: ods-dump/scottschema.dmp).'
type: string
secretRef:
description: SecretRef is a reference to the secret that stores
GCS access information.
properties:
name:
description: name is unique within a namespace to reference
a secret resource.
type: string
namespace:
description: namespace defines the space within which
the secret name must be unique.
type: string
type: object
x-kubernetes-map-type: atomic
required:
- bucket
- key
type: object
type:
description: 'Type of Repository (ex: S3, GCS), which tells the
agent which storage system/API to use.'
enum:
- GCS
- S3
type: string
required:
- type
type: object
backupRetainDays:
default: 14
description: Number of days after which the service will delete a
Backup. If specified, a Backup created under this BackupPlan will
be automatically deleted after its age reaches create_time + backup_retain_days.
The valid values are from 1 to 90 days. Default to 14 retain days
if not specified.
maximum: 90
minimum: 1
type: integer
backupSchedules:
description: 'Defines the schedules for different types of backups.
Full, Differential and Incremental backup types are supported: https://pgbackrest.org/user-guide.html#concept/backup
This field is optional. By default, take one full backup every day
at midnight.'
properties:
differential:
description: 'Defines the Cron schedule for a differential pgBackRest
backup. Follows the standard Cron schedule syntax: https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax'
minLength: 6
type: string
full:
description: 'Defines the Cron schedule for a full pgBackRest
backup. Follows the standard Cron schedule syntax: https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax'
minLength: 6
type: string
incremental:
description: 'Defines the Cron schedule for an incremental pgBackRest
backup. Follows the standard Cron schedule syntax: https://k8s.io/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax'
minLength: 6
type: string
type: object
dbclusterRef:
description: The DBCluster name this backupplan configures. This field
is required and immutable.
type: string
paused:
default: false
description: A flag to indicate if the backup creation under this
BackupPlan is paused. If set to true, the service will pause the
scheduling of new Backups under this BackupPlan. Default to False.
type: boolean
type: object
status:
description: BackupPlanStatus defines the observed state of BackupPlan.
properties:
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as
information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
lastBackupTime:
description: LastBackupTime is the timestamp for the most recently
executed backup.
format: date-time
type: string
nextBackupTime:
description: NextBackupTime is the timestamp for the next scheduled
backup.
format: date-time
type: string
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
phase:
description: BackupPlanPhase is the phase of a BackupPlan.
type: string
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
recoveryWindow:
description: RecoveryWindow is the currently available recovery window.
properties:
begin:
description: Begin time.
format: date-time
type: string
end:
description: End time.
format: date-time
type: string
type: object
type: object
type: object
served: true
storage: true
subresources:
status: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: backups.alloydbomni.dbadmin.goog
spec:
group: alloydbomni.dbadmin.goog
names:
kind: Backup
listKind: BackupList
plural: backups
shortNames:
- aoob
singular: backup
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .status.phase
name: Phase
type: string
- jsonPath: .status.completeTime
name: CompleteTime
type: string
- jsonPath: .spec.physicalBackupSpec.backupType
name: Type
type: string
name: v1
schema:
openAPIV3Schema:
description: Backup is the Schema for the backups API
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
description: BackupSpec defines the desired state of Backup.
properties:
backupPlanRef:
description: Name of the BackupPlan from which this backup was created.
This field is required.
type: string
dbclusterRef:
description: The DBCluster name this backup belongs to. This field
is required.
type: string
manual:
default: false
description: Indicate whether this backup is a scheduled or manual
backup. This field is optional. Default to false (scheduled backup)
if not specified.
type: boolean
physicalBackupSpec:
description: PhysicalBackupSpec contains spec for physical backups,
allowing to specify backup type as an enum in {"full","diff","incr"}.
This field is optional. Default to full if not specified.
properties:
backupType:
default: full
description: BackupType is the type of backup to be created. It's
an enum in {"full","diff","incr"}. Default to full if not specified.
enum:
- full
- diff
- incr
type: string
type: object
type: object
status:
description: BackupStatus defines the observed state of Backup.
properties:
completeTime:
description: Completion time of the Backup
format: date-time
type: string
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the
underlying condition changed is unknown, you can use the time
when the API field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
createTime:
description: Creation time of the Backup
format: date-time
type: string
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as information
about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
phase:
description: BackupPhase is the phase of a backup.
type: string
physicalBackupStatus:
description: PhysicalBackupStatus contains status info that are specific
for physical backups.
properties:
backupID:
description: BackupID is the unique id of the physical backup
tracked by pgbackrest
type: string
priorBackup:
description: PriorBackup is the prior backup this backup depends
on.
type: string
type: object
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
retainExpireTime:
description: RetainExpireTime defines the time when the Backup will
be automatically deleted. It's an output only field calculated from
`create_time` + `retain_days`, and will be updated accordingly when
the `retain_days` field of a Backup has been updated.
format: date-time
type: string
type: object
type: object
served: true
storage: true
subresources:
status: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: createstandbyjobs.alloydbomni.internal.dbadmin.goog
spec:
group: alloydbomni.internal.dbadmin.goog
names:
kind: CreateStandbyJob
listKind: CreateStandbyJobList
plural: createstandbyjobs
singular: createstandbyjob
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .spec.currentStep
name: CurrentStep
type: string
- jsonPath: .spec.attempt
name: Attempt
type: integer
- jsonPath: .spec.endTime
name: EndTime
type: string
- jsonPath: .spec.cleanup
name: Cleanup
type: boolean
- jsonPath: .spec.metadata.primaryInstance
name: Primary
type: string
- jsonPath: .spec.metadata.standbyInstance
name: Standby
type: string
name: v1
schema:
openAPIV3Schema:
description: CreateStandbyJob is an internal workflow tracking object. Users
should not directly interact with this.
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
properties:
attempt:
default: 0
description: Attempt allows the workflow to smartly retry and choose
to fail if too many retries have occurred
type: integer
cleanup:
default: false
description: Cleanup is used to mark this object as safe for deletion.
type: boolean
currentStep:
description: CurrentStep is the current step of the workflow
type: string
currentStepTime:
description: CurrentStepTime allows us to see when the current step
was initiated which allows us to time out at the step level.
format: date-time
type: string
endTime:
description: EndTime is when the workflow has reached a terminal state
format: date-time
type: string
metadata:
additionalProperties:
type: string
description: Metadata is intended to allow different workflows to
attach data needed to execute this workflow, e.g. which DBC/instance/
other resource this is attached to
type: object
requeueTime:
description: RequeueTime if set, then tells the reconciler to requeue
this job to run at the specified time
format: date-time
type: string
startTime:
description: StartTime is when the workflow began.
format: date-time
type: string
required:
- attempt
- cleanup
type: object
status:
properties:
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the
underlying condition changed is unknown, you can use the time
when the API field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as
information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
type: object
type: object
served: true
storage: true
subresources: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: dbclusters.alloydbomni.dbadmin.goog
spec:
group: alloydbomni.dbadmin.goog
names:
kind: DBCluster
listKind: DBClusterList
plural: dbclusters
shortNames:
- aood
singular: dbcluster
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .status.primary.endpoint
name: PrimaryEndpoint
type: string
- jsonPath: .status.primary.phase
name: PrimaryPhase
type: string
- jsonPath: .status.phase
name: DBClusterPhase
type: string
- jsonPath: .status.conditions[?(@.type=="HAReady")].status
name: HAReadyStatus
type: string
- jsonPath: .status.conditions[?(@.type=="HAReady")].reason
name: HAReadyReason
type: string
name: v1
schema:
openAPIV3Schema:
description: DBCluster is the Schema for the dbclusters API
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
description: DBClusterSpec defines the desired state of DBCluster
properties:
allowExternalIncomingTraffic:
default: false
type: boolean
availability:
description: Availability contains adjustable settings for DBCluster
HA features
properties:
autoFailoverTriggerThreshold:
default: 3
description: AutoFailoverTriggerThreshold is the number of consecutive
healthcheck failures on the primary instance that will trigger
an automatic failover. If set to 0, then it will use the system
default value. Use the EnableAutoFailover flag to completely
disable automatic failover.
minimum: 0
type: integer
autoHealTriggerThreshold:
default: 3
description: AutoHealTriggerThreshold is the number of consecutive
healthcheck failures on the standby instance that will trigger
automatic healing. Use the EnableAutoHeal flag to completely
disable automatic healing.
minimum: 2
type: integer
enableAutoFailover:
default: true
description: EnableAutoFailover means this DBCluster will trigger
a failover if it detects the primary instance is unhealthy and
standby instance is healthy. If set to `true`, then automatic
failover is enabled. If set to `false`, then autofailover will
not be triggered even if the system detects that the primary
instance is unhealthy. The default value is `true`. When it
is enabled, if the system detects that the primary instance
is unhealthy for the given threshold, it will trigger a failover.
This feature is only applicable if this is a HA DBCluster and
if the standby is healthy.
type: boolean
enableAutoHeal:
default: true
description: EnableAutoHeal means this DBCluster will trigger
an autoheal if it detects the standby instance is unhealthy.
If set to `true`, then autoheal is enabled. If set to `false`,
then autoheal is not triggered even if the system detects
that the standby instance is unhealthy. The default value is
`true`. When it is enabled, if the system detects that the standby
instance is unhealthy for the given threshold, it will trigger
an autoheal. This feature is only applicable if this is a HA
DBCluster.
type: boolean
enableStandbyAsReadReplica:
description: EnableStandbyAsReadReplica determine whether the
standbys can accept user queries or not. If set to true, a new
endpoint will be created to enable read-only access to the standby(s).
type: boolean
healthcheckPeriodSeconds:
default: 30
description: HealthcheckPeriodSeconds is the number of seconds
the healthcheck prober will wait before checking the health
of the primary and standby instances again and updating the
status accordingly.
maximum: 86400
minimum: 1
type: integer
numberOfStandbys:
default: 0
description: "NumberOfStandbys is the number of standbys that
should be created for this DBCluster. If set to any value greater
than `0`, then HA is enabled on the cluster and the system will
create the indicated number of standby instances. The maximum
allowed standby instances is 5. To check the current status
of HA on this DBCluster, look at the HAReady condition under
the DBCluster status. If HAReady is `true`, then setup has been
complete and ready. If set to `0`, then HA is disabled on the
cluster, and deletes any existing standby instances. Any number
between `0` and `5` inclusive is supported. The default value
is `0`. \n Additional Documentation: https://cloud.google.com/alloydb/docs/omni/kubernetes-ha"
maximum: 5
minimum: 0
type: integer
required:
- enableStandbyAsReadReplica
type: object
connectedModeSpec:
properties:
apiKeySecret:
type: string
clusterId:
type: string
displayLocation:
type: string
gcpProjectId:
type: string
gcpZone:
type: string
type: object
controlPlaneAgentsVersion:
description: "ControlPlaneAgentsVersion is the desired control plane
agents version for the cluster for example, \"0.5.2\". This field
is required. \n The `controlPlaneAgentsVersion` must be compatible
with the chosen `databaseVersion`. To know what versions are compatible,
check the list of available versions in {link}. \n This version
is applied to all instances of the database cluster. In the case
of a new database cluster, the instance is be created using the
specified version. In the case of an existing database cluster,
the operator will aptempt to upgrade or downgrade to the specified
`controlPlaneAgentsVersion`. The field `status.currentControlPlaneAgentsVersion`
indicates the current version for control plane agents. \n TODO(b/320311538):
replace link with the list of available versions."
type: string
databaseImage:
description: "DatabaseImage is the URI of a customized database image
within the container registry, for example, \"{{ .Values.image.registry}}/foo/bar/alloydbomni:15-7-2-customized\".
This field is optional. \n If `databaseImage` is specified, then
the operator uses this container image for the database instead
of the default database container image of the specified `databaseVersion`.
We recommend that the `databaseImage` container will be based on
the default database image used of the chosen `databaseVersion`.
\n For more information about using a customized database image
visit {link}. \n TODO(b/320311538): replace link with the guide
for customizing database image."
type: string
databaseVersion:
description: "DatabaseVersion is the desired database version for
the cluster for example, \"15.4.5\". This field is required. \n
This version is applied to all instances of the database cluster.
In the case of a new database cluster, the instance is created using
the specified version. In the case of an existing database cluster,
the operator aptempts to upgrade or downgrade to the specified `databaseVersion`.
The field `status.currentDatabaseVersion` indicates the current
database version. \n See the list of available versions in {link}.
\n TODO(b/320311538): replace link with the list of available versions."
type: string
isDeleted:
default: false
description: "IsDeleted indicates a request to delete the DBCluster.
This field is optional, and by default it is false. \n This fields
applies to all instances of the database cluster. When set this
to true, the control plane will attempt to release the related resources,
including network endpoints. See the status fields for indication
of success or failures, if any."
type: boolean
mode:
description: Indicate the mode of this DBCluster.
enum:
- ""
- disasterRecovery
type: string
primarySpec:
description: PrimarySpec contains the specifications of the Primary
instance of the database cluster. The primary instance contains
the compute and storage resources serving the read-write endpoint(s)
of the database cluster. This field is required.
properties:
adminUser:
description: "AdminUser represents the admin user specification.
This field is required. \n This is the initial database user
that the control plane creates. Additional database users are
managed by the end-user directly. This field can also be used
to reset the password of the initial user."
properties:
passwordRef:
description: PasswordRef is the name of the secret containing
the admin user's password. This value will be used during
initial provisioning or password reset to set the admin
user to that password. The secret must be under the same
project as the Database cluster. The name of the secret
must follow this pattern `db-pw-<dbc name>`. Additionally,
the key of the password (inside the secret) must be the
same as the database cluster name.
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
type: object
allowExternalIncomingTrafficToInstance:
default: false
description: AllowExternalIncomingTrafficToInstance will be used
to configure the external LB creation.
type: boolean
auditLogTarget:
description: AuditLogTarget configures the sink for the database
audit logs
properties:
syslog:
properties:
certsSecretRef:
description: CertsSecretRef contains the certificates
to be used for the TLS connection to syslog server
properties:
name:
description: name is unique within a namespace to
reference a secret resource.
type: string
namespace:
description: namespace defines the space within which
the secret name must be unique.
type: string
type: object
x-kubernetes-map-type: atomic
host:
description: Host is the syslog server FQDN or IP address
type: string
required:
- certsSecretRef
- host
type: object
type: object
availabilityOptions:
description: AvailabilityOptions contains adjustable settings
for HA features
properties:
healthcheckPeriodSeconds:
default: 30
description: HealthcheckPeriodSeconds is the number of seconds
the healthcheck prober will wait before checking the health
of the primary and standby instances again and updating
the status accordingly. This field is propagated down from
the DBCluster's spec.
maximum: 86400
minimum: 1
type: integer
livenessProbe:
default: Enabled
description: LivenessProbe enables or disables the liveness
probe which is used to trigger a container restart. When
set to `Enabled`, the liveness probe runs periodic health
checks on the database. It restarts the container if it
fails three consecutive health checks. LivenessProbe is
automatically disabled for HA instances. When set to `Disabled`,
the liveness probe is not running health checks on the database.
The default value is Enabled.
enum:
- Enabled
- Disabled
- OpDisabled
type: string
type: object
dbLoadBalancerOptions:
description: DBNetworkServiceOptions allows to override some details
of kubernetes Service created to expose a connection to database.
properties:
annotations:
additionalProperties:
type: string
description: Annotation provided by the customer will be added
to the service object of type loadbalancer.
type: object
gcp:
description: GCP contains Google Cloud specific attributes
for the Kubernetes LoadBalancer.
properties:
loadBalancerIP:
description: LoadBalancerIP is a static IP address, see
https://cloud.google.com/compute/docs/ip-addresses/reserve-static-external-ip-address
type: string
loadBalancerType:
description: A LoadBalancer can be internal or external.
See https://kubernetes.io/docs/concepts/services-networking/service/#internal-load-balancer
enum:
- ""
- Internal
- External
type: string
type: object
type: object
features:
description: Feature Spec
properties:
googleMLExtension:
description: Google ML Extension Spec
properties:
config:
description: Google ML Extension Config
properties:
vertexAIKeyRef:
type: string
vertexAIRegion:
type: string
type: object
enabled:
default: false
type: boolean
required:
- enabled
type: object
memoryAgent:
properties:
enabled:
default: true
description: Indicate interest to enable/disable memory
agent for database. The default is true.
type: boolean
required:
- enabled
type: object
type: object
isStopped:
description: "IsStopped stops the instance when set to true. This
field is optional and default to false. \n When stopped, the
compute resources (CPU, memory) of the instance are released.
However, the instance still keeps the storage resource and network
endpoints so that restarting is transparent to the downstream
services. See the status field for success or failures, if any."
type: boolean
mode:
description: Mode specifies how this instance will be managed
by the operator.
enum:
- ManuallySetUpStandby
- Pause
- Recovery
type: string
parameters:
additionalProperties:
type: string
description: "Parameters allows to set database parameters for
the database cluster. This field is optional. \n Parameters
will take a key/value pair corresponding to the parameter name/value
as defined by the database engine."
type: object
resources:
description: "Resource specification for the database container.
\n When any of the fields inside the resource changes, the operator
restarts the database instance with the new resource specification."
properties:
cpu:
anyOf:
- type: integer
- type: string
description: The amount of CPU allocated to the database container.
This field is required.
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
disks:
description: The specifications of the disks allocated to
the database container. This field is required.
items:
description: DiskSpec defines the desired state of a disk.
properties:
accessModes:
description: "AccessModes contains the desired access
modes for the volume. \n Refer to https://kubernetes.io/docs/concepts/storage/persistent-volumes/#access-modes
for more information."
items:
type: string
type: array
annotations:
additionalProperties:
type: string
description: "Additional annotations added to the Persistent
Volume Claim. This field is optional. \n This allows
to integrate with other tools."
type: object
name:
description: "Name of the disk. This field is required.
\n The allowed values are: \"DataDisk\", \"LogDisk\"
, \"BackupDisk\" and \"ObsDisk\"."
enum:
- DataDisk
- LogDisk
- BackupDisk
- ObsDisk
- BackupRepoDisk
type: string
selector:
description: "A label query over volumes to consider
for binding. This field is optional. \n If this field
is set, then the volume with matching labels is used
as the backing volume for the disk. \n Refer to https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1/#PersistentVolumeClaimSpec
for more information."
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are ANDed.
items:
description: A label selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: key is the label key that the
selector applies to.
type: string
operator:
description: operator represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, and DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty. If the
operator is Exists or DoesNotExist, the
values array must be empty. This array is
replaced during a strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is "In",
and the values array contains only "value". The
requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
size:
description: "Disk size in bytes for example, \"10Gi\"
for 10 Gibibytes. This field is required. \n The allowed
size unit prefixes are: \"Ki\", \"Mi\", \"Gi\", \"Ti,
\"Pi\" and \"Ei\" for 2-base. Also \"K\", \"M\", \"G\",
\"T, \"P\" and \"E\" for 10-base. See https://en.wikipedia.org/wiki/Unit_prefix."
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
type: string
storageClass:
description: "StorageClass points to a particular CSI
storage class. This field is optional. \n If the field
is not set, then the default CSI storage class for
the Kubernetes cluster is used. If there is no default
for the Kubernetes cluster, then the Persistence
Volume Claim will fail and the database cluster will
fail to provision. \n You can read more about storage
classes in https://kubernetes.io/docs/concepts/storage/storage-classes."
type: string
volumeName:
description: "VolumeName is the binding reference to
the Persistent Volume tied to this disk. This field
is optional. \n This allows to reuse an existing volume.
\n Note that if this field is specified, the value
\"storageClass\" will not take effect. You can learn
more about this in https://kubernetes.io/docs/concepts/storage/persistent-volumes/#binding."
type: string
required:
- name
- size
type: object
type: array
memory:
anyOf:
- type: integer
- type: string
description: The amount of memory allocated to the database
container. This field is required.
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
type: object
schedulingconfig:
description: "SchedulingConfig specifies how the instance should
be scheduled on Kubernetes nodes. \n When any field inside the
scheduling config changes, it can lead to rescheduling of the
Kubernetes pod onto a different node based on the config."
properties:
nodeaffinity:
description: NodeAffinity describes node affinity scheduling
rules for the instance.
properties:
preferredDuringSchedulingIgnoredDuringExecution:
description: The scheduler prefers to schedule pods
to nodes that satisfy the affinity expressions specified
by this field, but the scheduler might choose a node that violates
one or more of the expressions. The node that is most
preferred is the one with the greatest sum of weights,
which means that for each node that meets all of the scheduling
requirements (resource request, requiredDuringScheduling
affinity expressions, etc.), compute a sum by iterating
through the elements of this field and adding "weight"
to the sum, if the node matches the corresponding matchExpressions;
the node(s) with the highest sum are the most preferred.
items:
description: An empty preferred scheduling term matches
all objects with implicit weight 0 (in other words, it's a no-op).
A null preferred scheduling term matches no objects
(in other words, is also a no-op).
properties:
preference:
description: A node selector term, associated with
the corresponding weight.
properties:
matchExpressions:
description: A list of node selector requirements
by node's labels.
items:
description: A node selector requirement is
a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: The label key that the selector
applies to.
type: string
operator:
description: Represents a key's relationship
to a set of values. Valid operators
are In, NotIn, Exists, DoesNotExist.
Gt, and Lt.
type: string
values:
description: An array of string values.
If the operator is In or NotIn, the
values array must be non-empty. If the
operator is Exists or DoesNotExist,
the values array must be empty. If the
operator is Gt or Lt, the values array
must have a single element, which will
be interpreted as an integer. This array
is replaced during a strategic merge
patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchFields:
description: A list of node selector requirements
by node's fields.
items:
description: A node selector requirement is
a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: The label key that the selector
applies to.
type: string
operator:
description: Represents a key's relationship
to a set of values. Valid operators
are In, NotIn, Exists, DoesNotExist.
Gt, and Lt.
type: string
values:
description: An array of string values.
If the operator is In or NotIn, the
values array must be non-empty. If the
operator is Exists or DoesNotExist,
the values array must be empty. If the
operator is Gt or Lt, the values array
must have a single element, which will
be interpreted as an integer. This array
is replaced during a strategic merge
patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
type: object
x-kubernetes-map-type: atomic
weight:
description: Weight associated with matching the
corresponding nodeSelectorTerm, in the range 1-100.
format: int32
type: integer
required:
- preference
- weight
type: object
type: array
requiredDuringSchedulingIgnoredDuringExecution:
description: If the affinity requirements specified by
this field isn't met at scheduling time, the pod will
not be scheduled onto the node. If the affinity requirements
specified by this field aren't met at some point
during pod execution (e.g. due to an update), the system
might or might not try to eventually evict the pod from
its node.
properties:
nodeSelectorTerms:
description: Required. A list of node selector terms.
The terms are ORed.
items:
description: A null or empty node selector term
matches no objects. The requirements of them are
ANDed. The TopologySelectorTerm type implements
a subset of the NodeSelectorTerm.
properties:
matchExpressions:
description: A list of node selector requirements
by node's labels.
items:
description: A node selector requirement is
a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: The label key that the selector
applies to.
type: string
operator:
description: Represents a key's relationship
to a set of values. Valid operators
are In, NotIn, Exists, DoesNotExist.
Gt, and Lt.
type: string
values:
description: An array of string values.
If the operator is In or NotIn, the
values array must be non-empty. If the
operator is Exists or DoesNotExist,
the values array must be empty. If the
operator is Gt or Lt, the values array
must have a single element, which will
be interpreted as an integer. This array
is replaced during a strategic merge
patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchFields:
description: A list of node selector requirements
by node's fields.
items:
description: A node selector requirement is
a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: The label key that the selector
applies to.
type: string
operator:
description: Represents a key's relationship
to a set of values. Valid operators
are In, NotIn, Exists, DoesNotExist.
Gt, and Lt.
type: string
values:
description: An array of string values.
If the operator is In or NotIn, the
values array must be non-empty. If the
operator is Exists or DoesNotExist,
the values array must be empty. If the
operator is Gt or Lt, the values array
must have a single element, which will
be interpreted as an integer. This array
is replaced during a strategic merge
patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
type: object
x-kubernetes-map-type: atomic
type: array
required:
- nodeSelectorTerms
type: object
x-kubernetes-map-type: atomic
type: object
podAffinity:
description: PodAffinity describes pod affinity scheduling
rules for the instance.
properties:
preferredDuringSchedulingIgnoredDuringExecution:
description: The scheduler will prioritize nodes that meet the affinity
expressions specified in this field when scheduling pods.
The scheduler might still choose a node that doesn't fully meet the
criteria. The most preferred node is the one with the highest
total weight. This weight is calculated by adding up values
for each node that satisfies all scheduling requirements
(such as resource requests or requiredDuringScheduling affinity
expressions). For each matching podAffinityTerm, the node's weight
increases, and the node(s) with the highest total weight are
selected as the most preferred.
items:
description: The weights of all of the matched WeightedPodAffinityTerm
fields are added per-node to find the most preferred
node(s).
properties:
podAffinityTerm:
description: Required. A pod affinity term, associated
with the corresponding weight.
properties:
labelSelector:
description: A label query over a set of resources,
in this case, pods.
properties:
matchExpressions:
description: matchExpressions is a list
of label selector requirements. The requirements
are ANDed.
items:
description: A label selector requirement
is a selector that contains values,
a key, and an operator that relates
the key and values.
properties:
key:
description: key is the label key
that the selector applies to.
type: string
operator:
description: operator represents a
key's relationship to a set of values.
Valid operators are In, NotIn, Exists
and DoesNotExist.
type: string
values:
description: values is an array of
string values. If the operator is
In or NotIn, the values array must
be non-empty. If the operator is
Exists or DoesNotExist, the values
array must be empty. This array
is replaced during a strategic merge
patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator
is "In", and the values array contains
only "value". The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaceSelector:
description: A label query over the set of namespaces
that the term applies to. The term is applied
to the union of the namespaces selected by
this field and the ones listed in the namespaces
field. null selector and null or empty namespaces
list means "this pod's namespace". An empty
selector ({}) matches all namespaces.
properties:
matchExpressions:
description: matchExpressions is a list
of label selector requirements. The requirements
are ANDed.
items:
description: A label selector requirement
is a selector that contains values,
a key, and an operator that relates
the key and values.
properties:
key:
description: key is the label key
that the selector applies to.
type: string
operator:
description: operator represents a
key's relationship to a set of values.
Valid operators are In, NotIn, Exists
and DoesNotExist.
type: string
values:
description: values is an array of
string values. If the operator is
In or NotIn, the values array must
be non-empty. If the operator is
Exists or DoesNotExist, the values
array must be empty. This array
is replaced during a strategic merge
patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator
is "In", and the values array contains
only "value". The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaces:
description: namespaces specifies a static list
of namespace names that the term applies to.
The term is applied to the union of the namespaces
listed in this field and the ones selected
by namespaceSelector. null or empty namespaces
list and null namespaceSelector means "this
pod's namespace".
items:
type: string
type: array
topologyKey:
description: This pod must be co-located (affinity)
or not co-located (anti-affinity) with the
pods matching the labelSelector in the specified
namespaces. Co-located is defined as
running on a node whose value of the label
with key topologyKey matches that of any node
on which any of the selected pods is running.
Empty topologyKey is not allowed.
type: string
required:
- topologyKey
type: object
weight:
description: weight associated with matching the
corresponding podAffinityTerm, in the range 1-100.
format: int32
type: integer
required:
- podAffinityTerm
- weight
type: object
type: array
requiredDuringSchedulingIgnoredDuringExecution:
description: If the affinity requirements specified by
this field isn't met at scheduling time, the pod will
not be scheduled onto the node. If the affinity requirements
specified by this field aren't met at some point
during pod execution - for example, due to a pod label update -
the system might or might not try to eventually evict the
pod from its node. When there are multiple elements,
the lists of nodes corresponding to each podAffinityTerm
are intersected, which means that all terms must be satisfied.
items:
description: Defines a set of pods — namely, those matching
the labelSelector relative to the given namespace(s) —
that this pod must be co-located (affinity) or not
co-located (anti-affinity) with. Co-located
is defined as running on a node whose value of the
label with key <topologyKey> matches that of any node
on which a pod of the set of pods is running.
properties:
labelSelector:
description: A label query over a set of resources,
in this case, pods.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are
ANDed.
items:
description: A label selector requirement
is a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: key is the label key that
the selector applies to.
type: string
operator:
description: operator represents a key's
relationship to a set of values. Valid
operators are In, NotIn, Exists, and
DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty.
If the operator is Exists or DoesNotExist,
the values array must be empty. This
array is replaced during a strategic
merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is
"In", and the values array contains only "value".
The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaceSelector:
description: A label query over the set of namespaces
that the term applies to. The term is applied
to the union of the namespaces selected by this
field and the ones listed in the namespaces field.
null selector and null or empty namespaces list
means "this pod's namespace". An empty selector
({}) matches all namespaces.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are
ANDed.
items:
description: A label selector requirement
is a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: key is the label key that
the selector applies to.
type: string
operator:
description: operator represents a key's
relationship to a set of values. Valid
operators are In, NotIn, Exists, and
DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty.
If the operator is Exists or DoesNotExist,
the values array must be empty. This
array is replaced during a strategic
merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is
"In", and the values array contains only "value".
The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaces:
description: namespaces specifies a static list
of namespace names that the term applies to. The
term is applied to the union of the namespaces
listed in this field and the ones selected by
namespaceSelector. null or empty namespaces list
and null namespaceSelector means "this pod's namespace".
items:
type: string
type: array
topologyKey:
description: This pod must be co-located (affinity)
or not co-located (anti-affinity) with the pods
matching the labelSelector in the specified namespaces.
Co-located is defined as running on a node
whose value of the label with key topologyKey
matches that of any node on which any of the selected
pods is running. Empty topologyKey is not allowed.
type: string
required:
- topologyKey
type: object
type: array
type: object
podAntiAffinity:
description: PodAntiAffinity describes pod anti-affinity scheduling
rules for the instance.
properties:
preferredDuringSchedulingIgnoredDuringExecution:
description: The scheduler prefers to schedule pods
to nodes that satisfy the anti-affinity expressions
specified by this field, but the scheduler might choose a node that
violates one or more of the expressions. The node that
is most preferred is the one with the greatest sum of
weights, in other words, for each node that meets all of the scheduling
requirements (resource request, requiredDuringScheduling
anti-affinity expressions, etc.), compute a sum by iterating
through the elements of this field and adding "weight"
to the sum, if the node has pods which matches the corresponding
podAffinityTerm. The node(s) with the highest sum are
the most preferred.
items:
description: The weights of all of the matched WeightedPodAffinityTerm
fields are added per-node to find the most preferred
node(s).
properties:
podAffinityTerm:
description: Required. A pod affinity term, associated
with the corresponding weight.
properties:
labelSelector:
description: A label query over a set of resources,
in this case, pods.
properties:
matchExpressions:
description: matchExpressions is a list
of label selector requirements. The requirements
are ANDed.
items:
description: A label selector requirement
is a selector that contains values,
a key, and an operator that relates
the key and values.
properties:
key:
description: key is the label key
that the selector applies to.
type: string
operator:
description: operator represents a
key's relationship to a set of values.
Valid operators are In, NotIn, Exists
and DoesNotExist.
type: string
values:
description: values is an array of
string values. If the operator is
In or NotIn, the values array must
be non-empty. If the operator is
Exists or DoesNotExist, the values
array must be empty. This array
is replaced during a strategic merge
patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator
is "In", and the values array contains
only "value". The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaceSelector:
description: A label query over the set of namespaces
that the term applies to. The term is applied
to the union of the namespaces selected by
this field and the ones listed in the namespaces
field. null selector and null or empty namespaces
list means "this pod's namespace". An empty
selector ({}) matches all namespaces.
properties:
matchExpressions:
description: matchExpressions is a list
of label selector requirements. The requirements
are ANDed.
items:
description: A label selector requirement
is a selector that contains values,
a key, and an operator that relates
the key and values.
properties:
key:
description: key is the label key
that the selector applies to.
type: string
operator:
description: operator represents a
key's relationship to a set of values.
Valid operators are In, NotIn, Exists
and DoesNotExist.
type: string
values:
description: values is an array of
string values. If the operator is
In or NotIn, the values array must
be non-empty. If the operator is
Exists or DoesNotExist, the values
array must be empty. This array
is replaced during a strategic merge
patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator
is "In", and the values array contains
only "value". The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaces:
description: namespaces specifies a static list
of namespace names that the term applies to.
The term is applied to the union of the namespaces
listed in this field and the ones selected
by namespaceSelector. null or empty namespaces
list and null namespaceSelector means "this
pod's namespace".
items:
type: string
type: array
topologyKey:
description: This pod must be co-located (affinity)
or not co-located (anti-affinity) with the
pods matching the labelSelector in the specified
namespaces. Co-located is defined as
running on a node whose value of the label
with key topologyKey matches that of any node
on which any of the selected pods is running.
Empty topologyKey is not allowed.
type: string
required:
- topologyKey
type: object
weight:
description: weight associated with matching the
corresponding podAffinityTerm, in the range 1-100.
format: int32
type: integer
required:
- podAffinityTerm
- weight
type: object
type: array
requiredDuringSchedulingIgnoredDuringExecution:
description: If the anti-affinity requirements specified
by this field isn't met at scheduling time, the pod
is not scheduled onto the node. If the anti-affinity
requirements specified by this field cease to be met
at some point during pod execution (for example, due to a pod
label update), the system might or might not try to eventually
evict the pod from its node. When there are multiple
elements, the lists of nodes corresponding to each podAffinityTerm
are intersected, which means that all terms must be satisfied.
items:
description: Defines a set of pods — namely, those matching
the labelSelector relative to the given namespace(s) —
that this pod must be co-located (affinity) or not
co-located (anti-affinity) with. Co-located is defined
as running on a node whose value of the label with
key <topologyKey> matches that of any node on which
a pod of the set of pods is running.
properties:
labelSelector:
description: A label query over a set of resources,
in this case, pods.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are
ANDed.
items:
description: A label selector requirement
is a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: key is the label key that
the selector applies to.
type: string
operator:
description: operator represents a key's
relationship to a set of values. Valid
operators are In, NotIn, Exists, and
DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty.
If the operator is Exists or DoesNotExist,
the values array must be empty. This
array is replaced during a strategic
merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is
"In", and the values array contains only "value".
The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaceSelector:
description: A label query over the set of namespaces
that the term applies to. The term is applied
to the union of the namespaces selected by this
field and the ones listed in the namespaces field.
null selector and null or empty namespaces list
means "this pod's namespace". An empty selector
({}) matches all namespaces.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are
ANDed.
items:
description: A label selector requirement
is a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: key is the label key that
the selector applies to.
type: string
operator:
description: operator represents a key's
relationship to a set of values. Valid
operators are In, NotIn, Exists, and
DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty.
If the operator is Exists or DoesNotExist,
the values array must be empty. This
array is replaced during a strategic
merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is
"In", and the values array contains only "value".
The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaces:
description: namespaces specifies a static list
of namespace names that the term applies to. The
term is applied to the union of the namespaces
listed in this field and the ones selected by
namespaceSelector. null or empty namespaces list
and null namespaceSelector means "this pod's namespace".
items:
type: string
type: array
topologyKey:
description: This pod must be co-located (affinity)
or not co-located (anti-affinity) with the pods
matching the labelSelector in the specified namespaces.
Co-located is defined as running on a node whose value
of the label with key topologyKey matches that of any
node on which any of the selected pods is running. Empty
topologyKey is not allowed.
type: string
required:
- topologyKey
type: object
type: array
type: object
tolerations:
description: Tolerations to enable the management of whether
to allow or disallow scheduling an instance on a Kubernetes
node that has a specific taint applied.
items:
description: The pod this Toleration is attached to tolerates
any taint that matches the triple <key,value,effect> using
the matching operator <operator>.
properties:
effect:
description: Effect indicates the taint effect to match.
Empty means match all taint effects. When specified,
allowed values are NoSchedule, PreferNoSchedule and
NoExecute.
type: string
key:
description: Key is the taint key that the toleration
applies to. Empty means match all taint keys. If the
key is empty, operator must be Exists. This combination
means to match all values and all keys.
type: string
operator:
description: Operator represents a key's relationship
to the value. Valid operators are Exists and Equal.
Defaults to Equal. Exists is equivalent to wildcard
for value, so that a pod can tolerate all taints of
a particular category.
type: string
tolerationSeconds:
description: TolerationSeconds represents the period
of time the toleration (which must be of effect NoExecute,
otherwise this field is ignored) tolerates the taint.
By default, this field isn't set, which means tolerate the
taint forever (do not evict). Zero and negative values
are treated as 0 (evict immediately) by the system.
format: int64
type: integer
value:
description: Value is the taint value the toleration
matches to. If the operator is Exists, the value must
be empty, otherwise just a regular string.
type: string
type: object
type: array
type: object
services:
additionalProperties:
type: boolean
description: Services list the optional semi-managed services
that you can choose from.
type: object
sidecarRef:
description: SidecarRef is a reference to a sidecar Custom Resource.
If set, sidecar containers included in the sidecar Custom Resource
are injected into the database pod.
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
sourceCidrRanges:
description: Source IP CIDR ranges allowed for a client.
items:
type: string
type: array
tls:
description: TLS is the desired server certificate configuration
for the instance. This field is optional. When this field is
changed, the instance pods restart to load the specified certificate.
properties:
certSecret:
description: CertSecret contains the name of a certificate
secret within the same namespace. The secret must contain
entries ca.crt (CA certificate), tls.key (server private
key), and tls.crt (server leaf certificate). This secret
is used to set the TLS config for the database instance.
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
type: object
walArchiveSetting:
description: WalArchiveSetting specifies wal archive settings.
If set, archive_mode is enabled to archive wal logs to specified
location. Ref to https://www.postgresql.org/docs/15/continuous-archiving.html
for more information.
properties:
archiveMode:
default: "on"
description: ArchiveMode specifies archive_mode, see https://www.postgresql.org/docs/current/runtime-config-wal.html#GUC-ARCHIVE-MODE
for details.
enum:
- "on"
- always
type: string
location:
description: Location is the location where archived wal logs
are stored.
type: string
type: object
required:
- resources
type: object
tls:
description: TLS is the desired server certificate configuration for
the cluster. This field is optional. By default, this field is empty
and a new self-signed CA and leaf certificate are generated for
the cluster. When this field is changed, the database cluster pods
will restart to load the specified certificate. The field `status.certificateReference`
indicates the current CA certificate secret and key.
properties:
certSecret:
description: CertSecret references the certificate secret within
the same namespace. The secret must contain entries ca.crt (CA
certificate), tls.key (server private key), and tls.crt (server
leaf certificate). This secret is used to set the TLS config
for the database instances that a part of the database cluster.
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
type: object
type: object
status:
description: DBClusterStatus defines the observed state of DBCluster
properties:
HealthCheck:
description: HealthStatus represents the health check.
properties:
IsRegistered:
type: boolean
LastHealthCheckTime:
type: string
type: object
certificateReference:
description: "CertificateReference refers to a secret and a key of
the server CA certificate that can be used to connect to the database.
\n If `spec.TLS` is provided, this value should refer to the same
secret after the database has been configured to use the provided
server certificate."
properties:
certificateKey:
description: CertificateKey is the key used to search the secret
for the Certificate
type: string
secretRef:
description: SecretRef is a reference to the secret that contains
the Certificate
properties:
name:
description: name is unique within a namespace to reference
a secret resource.
type: string
namespace:
description: namespace defines the space within which the
secret name must be unique.
type: string
type: object
x-kubernetes-map-type: atomic
type: object
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as information
about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
latestFailoverStatus:
description: LatestFailoverStatus is the status of the most recently
updated failover for the database cluster This status is a copy
of the status of the current or most recently updated failover operation
for the database cluster. This can be used to conveniently monitor
the status of a currently running failover operation.
properties:
failoverName:
description: FailoverName is the Name of the latest failover
type: string
status:
description: Status represents status of the latest failover for
the database cluster
properties:
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect
of the current state of this API Resource. This struct
is intended for direct use as an array at the field path
.status.conditions. For example, \n type FooStatus struct{
// Represents the observations of a foo's current state.
// Known .status.conditions.type are: \"Available\", \"Progressing\",
and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\"
patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`
\n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the
condition transitioned from one status to another,
which occurs when the underlying condition changed. If
that is not known, then using the time when the API
field changed is acceptable.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This may be an empty
string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance,
if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to
the current state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier
indicating the reason for the condition's last transition.
Producers of specific condition types can define expected
values and meanings for this field, and whether the
values are considered a guaranteed API. The value
should be a CamelCase string. This field may not be
empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False,
Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across
resources like Available, but because arbitrary conditions
can be useful (see .node.status.conditions), the ability
to deconflict is important. The regex it matches is
(dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
createTime:
description: CreateTime is the time when the internal failover
workflow mechanism was created.
format: date-time
type: string
criticalIncidents:
description: CriticalIncidents is a flat list of all active
Critical Incidents.
items:
description: CriticalIncident contains all information about
an ongoing critical incident.
properties:
code:
description: Code is the error code of this particular
error. Error codes are DBSE+numeric strings, like
"DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that
occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value
pairs necessary for generating a user-friendly data-driven
version of Message in the user interface.
type: object
resource:
description: Resource contains information about the
Database Service component that reported the incident
as well as information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier
of the Database Service subsystem that reported
the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster
of the affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the
Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected
Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the
affected Kubernetes resource.
type: string
version:
description: Group is the Version of the k8s
resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list
of messages from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains
stack trace information available for the incident.
properties:
component:
description: Component is the name of a Database
Service component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that
the issue must be considered transient until the
specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
endTime:
description: EndTime is the time failover reached its final
state.
format: date-time
type: string
internal:
description: Internal is used by the system controllers. You
should not directly depend on the information in this section.
properties:
newPrimary:
description: NewPrimary is the instance that you are attempting
to failover to.
type: string
oldPrimary:
description: OldPrimary is the instance that was the primary
at the start of the failover.
type: string
phase:
description: Phase is used to keep track of the current
state of the failover.
enum:
- StopPrimary
- PromoteStandby
- ValidateNewPrimary
- UpdateOldPrimaryResources
- UpdateNewPrimaryResources
- Cleanup
- Complete
- UpdateStandbys
- Recreate
type: string
required:
- newPrimary
- oldPrimary
type: object
observedGeneration:
description: The generation observed by the controller.
format: int64
type: integer
reconciled:
description: Whether the resource was reconciled by the controller.
type: boolean
startTime:
description: StartTime is the time that the failover operation
started.
format: date-time
type: string
state:
description: State is the current state of the failover operation.
The values are `InProgress`, `Success`, `Failed_RollbackInProgress`,
`Failed_RollbackSuccess`, and `Failed_RollbackFailed`. `InProgress`
means the failover is still in progress. `Success` means
that the failover has completed. It is complete when the
new primary instance is successfully promoted. `Failed_RollbackInProgress`
means that the operator was unable to promote the new primary
instance, and that is attempting to restart the old primary instance.
`Failed_RollbackSuccess` means that the operator was unable
to promote the new primary instance, and that it successfully restarted
the old primary instance. `Failed_RollbackFailed` means
that the operator was unable to promote the new primary
instance, and that the operator wasn't able to restart the old primary instance.
The DBCluster might need to be manually repaired.
enum:
- InProgress
- Success
- Failed_RollbackInProgress
- Failed_RollbackSuccess
- Failed_RollbackFailed
type: string
type: object
type: object
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
phase:
type: string
primary:
description: Primary contains the status of the primary Instance.
properties:
allocatedResources:
description: AllocatedResources represents the current configuration
of memory/CPU/disks
properties:
cpu:
anyOf:
- type: integer
- type: string
description: The amount of CPU allocated to the database container.
This field is required.
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
disks:
description: The specifications of the disks allocated to
the database container. This field is required.
items:
description: DiskSpec defines the desired state of a disk.
properties:
accessModes:
description: "AccessModes contains the desired access
modes for the volume. \n Refer to https://kubernetes.io/docs/concepts/storage/persistent-volumes/#access-modes
for more information."
items:
type: string
type: array
annotations:
additionalProperties:
type: string
description: "Additional annotations added to the Persistent
Volume Claim. This field is optional. \n This allows
to integrate with other tools."
type: object
name:
description: "Name of the disk. This field is required.
\n The allowed values are: \"DataDisk\", \"LogDisk\"
, \"BackupDisk\" and \"ObsDisk\"."
enum:
- DataDisk
- LogDisk
- BackupDisk
- ObsDisk
- BackupRepoDisk
type: string
selector:
description: "A label query over volumes to consider
for binding. This field is optional. \n If this field
is set, then the volume with matching labels is used
as the backing volume for the disk. \n Refer to https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1/#PersistentVolumeClaimSpec
for more information."
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are ANDed.
items:
description: A label selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: key is the label key that the
selector applies to.
type: string
operator:
description: operator represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, and DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty. If the
operator is Exists or DoesNotExist, the
values array must be empty. This array is
replaced during a strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is "In",
and the values array contains only "value". The
requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
size:
description: "Disk size in bytes for example, \"10Gi\"
for 10 Gibibytes. This field is required. \n The allowed
size unit prefixes are: \"Ki\", \"Mi\", \"Gi\", \"Ti,
\"Pi\" and \"Ei\" for 2-base. Also \"K\", \"M\", \"G\",
\"T, \"P\" and \"E\" for 10-base. See https://en.wikipedia.org/wiki/Unit_prefix."
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
type: string
storageClass:
description: "StorageClass points to a particular CSI
storage class. This field is optional. \n If the field
is not set, then the default CSI storage class for
the Kubernetes cluster is used. If there is no default
for the Kubernetes cluster, then the Persistence
Volume Claim will fail and the database cluster will
fail to provision. \n You can read more about storage
classes in https://kubernetes.io/docs/concepts/storage/storage-classes."
type: string
volumeName:
description: "VolumeName is the binding reference to
the Persistent Volume tied to this disk. This field
is optional. \n This allows to reuse an existing volume.
\n Note that if this field is specified, the value
\"storageClass\" will not take effect. You can learn
more about this in https://kubernetes.io/docs/concepts/storage/persistent-volumes/#binding."
type: string
required:
- name
- size
type: object
type: array
memory:
anyOf:
- type: integer
- type: string
description: The amount of memory allocated to the database
container. This field is required.
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
type: object
conditions:
description: Conditions represents the latest available observations
of the Instance's current state.
items:
description: "Condition contains details for one aspect of the
current state of this API Resource. This struct is intended
for direct use as an array at the field path .status.conditions.
\ For example, \n type FooStatus struct{ // Represents the
observations of a foo's current state. // Known .status.conditions.type
are: \"Available\", \"Progressing\", and \"Degraded\" // +patchMergeKey=type
// +patchStrategy=merge // +listType=map // +listMapKey=type
Conditions []metav1.Condition `json:\"conditions,omitempty\"
patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`
\n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs
when the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if
.metadata.generation is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the
current state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values
and meanings for this field, and whether the values are
considered a guaranteed API. The value should be a CamelCase
string. This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False,
Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across
resources like Available, but because arbitrary conditions
can be useful (see .node.status.conditions), the ability
to deconflict is important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
currentControlPlaneAgentsVersion:
description: "CurrentControlPlaneAgentsVersion is the control
plane agents version that the primary instance is running. \n
This value should match the value of `spec.controlPlaneAgentsVersion`
after the primary instance is provisioned or the upgrade or
downgrade has concluded successfully."
type: string
currentDatabaseImage:
description: "CurrentDatabaseImage is the customized database
image that the primary instance is using. \n This value should
match the value of `spec.databaseImage` after the primary instance
is provisioned or the upgrade or downgrade has concluded successfully."
type: string
currentDatabaseVersion:
description: "CurrentDatabaseVersion is the current database version
that the primary instance is running. \n This value should match
the value of `spec.databaseVersion` after the primary instance
is provisioned or the upgrade or downgrade has concluded successfully."
type: string
currentParameters:
additionalProperties:
type: string
description: "CurrentParameters indicates the current values of
the parameters. \n CurrentParameters allows to verify that the
`spec.primarySpec.parameters` field has been applied to the
database. Only the parameters names in `spec.primarySpec.parameters`
will be included in this field."
type: object
endpoint:
description: 'Endpoint is the address that can be used to establish
database connections. Deprecated: use the Endpoints field instead.'
type: string
endpoints:
description: Endpoints contains all the endpoint through which
the users can access this instance.
items:
description: Endpoint represents a access point through which
user can access the database.
properties:
name:
description: Name contains the name of the endpoint
type: string
value:
description: Value contains the endpoint information.
type: string
required:
- name
type: object
type: array
x-kubernetes-list-map-keys:
- name
x-kubernetes-list-type: map
latestExport:
description: LatestExport represents the latest export for the
database instance
properties:
creationTimeStamp:
description: CreationTimeStamp represents the creation time
of the export for the database instance
format: date-time
type: string
exportName:
description: ExportName is the Name of the latest export
type: string
spec:
description: Spec represents the spec of the export for the
database instance
properties:
dbclusterRef:
description: DBClusterRef is the dbcluster name within
the same namespace to export from.
type: string
exportLocation:
description: ExportLocation specifies a storage location
for the export files. A user is to ensure proper write
access to the storage bucket from within the Operator.
properties:
gcsOptions:
description: GCSOptions is a reference to GCS dependent
options.
properties:
bucket:
description: 'Bucket is a required field, (ex:
dbs-dump-bucket) A user is to ensure proper
write access to the storage bucket from within
the Operator.'
type: string
key:
description: 'Object key for the dump files. (ex:
ods-dump/scottschema.dmp).'
type: string
secretRef:
description: SecretRef is a reference to the secret
that stores GCS access information.
properties:
name:
description: name is unique within a namespace
to reference a secret resource.
type: string
namespace:
description: namespace defines the space within
which the secret name must be unique.
type: string
type: object
x-kubernetes-map-type: atomic
required:
- bucket
- key
type: object
type:
description: 'Type of Repository (ex: S3, GCS), which
tells the agent which storage system/API to use.'
enum:
- GCS
- S3
type: string
required:
- type
type: object
required:
- exportLocation
type: object
status:
description: Status represents the of the latest import for
the database instance
properties:
completeTime:
description: CompleteTime is the time export completed.
format: date-time
type: string
conditions:
description: Conditions represents the latest available
observations of the Entity's current state.
items:
description: "Condition contains details for one aspect
of the current state of this API Resource. --- This
struct is intended for direct use as an array at the
field path .status.conditions. For example, \n type
FooStatus struct{ // Represents the observations of
a foo's current state. // Known .status.conditions.type
are: \"Available\", \"Progressing\", and \"Degraded\"
// +patchMergeKey=type // +patchStrategy=merge //
+listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\"
patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`
\n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time
the condition transitioned from one status to
another. This must be when the underlying condition
changed. If the time when the underlying condition
changed is unknown, you can use the time when the
API field changed.
format: date-time
type: string
message:
description: message is a human readable message
indicating details about the transition. This
may be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance,
if .metadata.generation is currently 12, but the
.status.conditions[x].observedGeneration is 9,
the condition is out of date with respect to the
current state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier
indicating the reason for the condition's last
transition. Producers of specific condition types
may define expected values and meanings for this
field, and whether the values are considered a
guaranteed API. The value should be a CamelCase
string. This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True,
False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in
foo.example.com/CamelCase. Many .condition.type
values are consistent across resources like Available,
but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to
deconflict is important. The regex it matches
is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
criticalIncidents:
description: CriticalIncidents is a flat list of all active
Critical Incidents.
items:
description: CriticalIncident contains all information
about an ongoing critical incident.
properties:
code:
description: Code is the error code of this particular
error. Error codes are DBSE+numeric strings, like
"DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this
Incident was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error
that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value
pairs necessary for generating a user-friendly
data-driven version of Message in the user interface.
type: object
resource:
description: Resource contains information about
the Database Service component that reported the
incident, as well as information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier
of the Database Service subsystem that reported
the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the
cluster of the affected Kubernetes resource.
type: string
group:
description: Group is the Group name of
the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the k8s
resource.
type: string
name:
description: Name is the name of the affected
Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace
of the affected Kubernetes resource.
type: string
version:
description: Group is the Version of the
Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured
list of messages from the stack trace.
items:
description: CriticalIncidentStackTraceMessage
contains stack trace information available for
the incident.
properties:
component:
description: Component is the name of a Database
Service component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates
that the issue must be considered transient
until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
exportSubDirectory:
description: ExportSubDirectory is the subdirectory appended
to ExportLocation to store exported files.
type: string
observedGeneration:
description: 'Internal: The generation observed by the
controller.'
format: int64
type: integer
phase:
description: Phase is a summary of current state of the
export.
type: string
reconciled:
description: 'Internal: Whether the resource was reconciled
by the controller.'
type: boolean
startTime:
description: StartTime is the time export started.
format: date-time
type: string
type: object
type: object
latestImport:
description: LatestImport represents the latest import for the
database instance
properties:
creationTimeStamp:
description: CreationTimeStamp represents the creation time
of the import for the database instance
format: date-time
type: string
importName:
description: ImportName is the Name of the latest import
type: string
spec:
description: Spec represents the spec of the import for the
database instance
properties:
databaseName:
description: DatabaseName is the database resource name
within Instance to import into.
type: string
dbclusterRef:
description: DBClusterRef is the dbcluster name within
the same namespace to import into.
type: string
downloadOnly:
default: false
description: DownloadOnly when set to true means dump
file will be downloaded but not imported into DB. Default
is false.
type: boolean
dumpStorage:
description: DumpStorage specifies a storage location
for the import dump files. A user is to ensure proper
read access to the storage bucket from within the Operator.
properties:
gcsOptions:
description: GCSOptions is a reference to GCS dependent
options.
properties:
bucket:
description: 'Bucket is a required field, (ex:
dbs-dump-bucket) A user is to ensure proper
write access to the storage bucket from within
the Operator.'
type: string
key:
description: 'Object key for the dump files. (ex:
ods-dump/scottschema.dmp).'
type: string
secretRef:
description: SecretRef is a reference to the secret
that stores GCS access information.
properties:
name:
description: name is unique within a namespace
to reference a secret resource.
type: string
namespace:
description: namespace defines the space within
which the secret name must be unique.
type: string
type: object
x-kubernetes-map-type: atomic
required:
- bucket
- key
type: object
type:
description: 'Type of Repository (ex: S3, GCS), which
tells the agent which storage system/API to use.'
enum:
- GCS
- S3
type: string
required:
- type
type: object
logStorage:
description: LogStorage optionally specifies a storage
location to copy import log to. A user is to ensure
proper write access to the storage bucket from within
the Operator.
properties:
gcsOptions:
description: GCSOptions is a reference to GCS dependent
options.
properties:
bucket:
description: 'Bucket is a required field, (ex:
dbs-dump-bucket) A user is to ensure proper
write access to the storage bucket from within
the Operator.'
type: string
key:
description: 'Object key for the dump files. (ex:
ods-dump/scottschema.dmp).'
type: string
secretRef:
description: SecretRef is a reference to the secret
that stores GCS access information.
properties:
name:
description: name is unique within a namespace
to reference a secret resource.
type: string
namespace:
description: namespace defines the space within
which the secret name must be unique.
type: string
type: object
x-kubernetes-map-type: atomic
required:
- bucket
- key
type: object
type:
description: 'Type of Repository (ex: S3, GCS), which
tells the agent which storage system/API to use.'
enum:
- GCS
- S3
type: string
required:
- type
type: object
required:
- dumpStorage
type: object
status:
description: Status represents the of the latest import for
the database instance
properties:
completeTime:
description: CompleteTime is the time import completed.
format: date-time
type: string
conditions:
description: Conditions represents the latest available
observations of the Entity's current state.
items:
description: "Condition contains details for one aspect
of the current state of this API Resource. --- This
struct is intended for direct use as an array at the
field path .status.conditions. For example, \n type
FooStatus struct{ // Represents the observations of
a foo's current state. // Known .status.conditions.type
are: \"Available\", \"Progressing\", and \"Degraded\"
// +patchMergeKey=type // +patchStrategy=merge //
+listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\"
patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`
\n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time
the condition transitioned from one status to
another. This must be when the underlying condition
changed. If the time when the underlying condition
changed is unknown, you can use the time when the
API field changed.
format: date-time
type: string
message:
description: message is a human readable message
indicating details about the transition. This
may be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance,
if .metadata.generation is currently 12, but the
.status.conditions[x].observedGeneration is 9,
the condition is out of date with respect to the
current state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier
indicating the reason for the condition's last
transition. Producers of specific condition types
may define expected values and meanings for this
field, and whether the values are considered a
guaranteed API. The value should be a CamelCase
string. This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True,
False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in
foo.example.com/CamelCase. Many .condition.type
values are consistent across resources like Available,
but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to
deconflict is important. The regex it matches
is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
criticalIncidents:
description: CriticalIncidents is a flat list of all active
Critical Incidents.
items:
description: CriticalIncident contains all information
about an ongoing critical incident.
properties:
code:
description: Code is the error code of this particular
error. Error codes are DBSE+numeric strings, like
"DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this
Incident was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error
that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value
pairs necessary for generating a user-friendly
data-driven version of Message in the user interface.
type: object
resource:
description: Resource contains information about
the Database Service component that reported the
incident, as well as information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier
of the Database Service subsystem that reported
the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the
cluster of the affected Kubernetes resource.
type: string
group:
description: Group is the Group name of
the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the k8s
resource.
type: string
name:
description: Name is the name of the affected
Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace
of the affected Kubernetes resource.
type: string
version:
description: Group is the Version of the
Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured
list of messages from the stack trace.
items:
description: CriticalIncidentStackTraceMessage
contains stack trace information available for
the incident.
properties:
component:
description: Component is the name of a Database
Service component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates
that the issue must be considered transient
until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
dumpPath:
description: DumpPath is the path of the downloaded dump
file for download only import.
type: string
observedGeneration:
description: 'Internal: The generation observed by the
controller.'
format: int64
type: integer
phase:
description: Phase is a summary of current state of the
import.
type: string
reconciled:
description: 'Internal: Whether the resource was reconciled
by the controller.'
type: boolean
startTime:
description: StartTime is the time import started.
format: date-time
type: string
type: object
type: object
phase:
description: Phase is a summary of current state of the Instance.
type: string
url:
description: "URL consists of the address and port number that
can be used to establish a client connection to the database.
\n This value is expressed in the following format: <address>:<port>.
Deprecated: use the Endpoints field instead."
type: string
walArchiveSetting:
description: WalArchiveSetting represents the current WAL archive
settings.
properties:
location:
type: string
type: object
type: object
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
registrationStatus:
description: RegistrationStatus represents the status of migration
for the database cluster.
properties:
IsHA:
description: IsHA is set to true when DBClusterSpec HA Availability
setting has at least 1 numberOfStandbys setup.
type: boolean
IsRegistered:
type: boolean
RegistrationTime:
description: RegistrationTime represents the time the on-prem
dbcluster was registered with the Cloud.
type: string
type: object
restoredFrom:
description: RestoredFrom is the status showing the most recent restore
source for current DBCluster.
properties:
restoredTime:
description: Time point of the source DBCluster this DBCluster
restores from.
format: date-time
type: string
sourceDBCluster:
description: Source DBCluster this DBCluster restores from.
type: string
type: object
serviceAccounts:
additionalProperties:
properties:
name:
type: string
namespace:
type: string
required:
- name
- namespace
type: object
description: ServiceAccounts contains the service accounts created
by the control plane to be used by different operations. By granting
permissions to these service accounts, the database can interact
with other services within the kubernetes ecosystem. For further
information, including what permissions is required, refer to the
documentation of each operation.
type: object
type: object
type: object
served: true
storage: true
subresources:
status: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: dbinstances.alloydbomni.dbadmin.goog
spec:
group: alloydbomni.dbadmin.goog
names:
kind: DBInstance
listKind: DBInstanceList
plural: dbinstances
singular: dbinstance
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .spec.instanceType
name: Type
type: string
- jsonPath: .spec.dbcParent.name
name: Parent
type: string
- jsonPath: .status.endpoints[?(@.name=="Read-Only")].value
name: Endpoint
type: string
- jsonPath: .status.conditions[?(@.type=="Available")].status
name: Available
type: string
- jsonPath: .status.conditions[?(@.type=="Streaming")].status
name: Streaming
type: string
- jsonPath: .status.conditions[?(@.type=="Available")].message
name: Message
type: string
name: v1
schema:
openAPIV3Schema:
description: DBInstance is the Schema for the DBInstances API
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
description: DBInstanceSpec defines the desired state of DBInstance
properties:
dbcParent:
description: DBClusterParent is the DBCluster this DBInstance replicates
from.
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
instanceType:
description: InstanceType indicates the type of the DBInstance. Currently
only supports "ReadPool" type.
enum:
- ReadPool
type: string
isStopped:
description: "IsStopped stops the DBNodes in this DBInstance when
true. This field is optional and defaults to false. Stopping the
DBCluster's Primary DBNode does not automatically stop the DBNodes
of ReadPool DBInstances. \n When stopped, the compute resources
(CPU, memory) of the instance are released. However, the DBNode
still keeps the storage resource."
type: boolean
nodeCount:
default: 1
description: NodeCount determines the number of DBNodes that must
be created for this DBInstance.
maximum: 20
minimum: 0
type: integer
progressTimeout:
default: 30m
description: "ProgressTimeout determines the number of seconds the
controller will attempt to provision a DBNode, or which a DBNode
could be not-ready for, before it considers the DBNode to have failed.
\n A value of 0 means that no timeout will be used."
type: string
resources:
description: Resource specifices the resources used for the Instances
(i.e, DBNodes) belonging to this DBInstance. If omitted, the instance
will use the same resources as the DBCluster's Primary Instance.
properties:
cpu:
anyOf:
- type: integer
- type: string
description: The amount of CPU allocated to the database container.
This field is required.
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
disks:
description: The specifications of the disks allocated to the
database container. This field is required.
items:
description: DiskSpec defines the desired state of a disk.
properties:
accessModes:
description: "AccessModes contains the desired access modes
for the volume. \n Refer to https://kubernetes.io/docs/concepts/storage/persistent-volumes/#access-modes
for more information."
items:
type: string
type: array
annotations:
additionalProperties:
type: string
description: "Additional annotations added to the Persistent
Volume Claim. This field is optional. \n This allows to
integrate with other tools."
type: object
name:
description: "Name of the disk. This field is required.
\n The allowed values are: \"DataDisk\", \"LogDisk\" ,
\"BackupDisk\" and \"ObsDisk\"."
enum:
- DataDisk
- LogDisk
- BackupDisk
- ObsDisk
- BackupRepoDisk
type: string
selector:
description: "A label query over volumes to consider for
binding. This field is optional. \n If this field is set,
then the volume with matching labels is used as the backing
volume for the disk. \n Refer to https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1/#PersistentVolumeClaimSpec
for more information."
properties:
matchExpressions:
description: matchExpressions is a list of label selector
requirements. The requirements are ANDed.
items:
description: A label selector requirement is a selector
that contains values, a key, and an operator that
relates the key and values.
properties:
key:
description: key is the label key that the selector
applies to.
type: string
operator:
description: operator represents a key's relationship
to a set of values. Valid operators are In,
NotIn, Exists and DoesNotExist.
type: string
values:
description: values is an array of string values.
If the operator is In or NotIn, the values array
must be non-empty. If the operator is Exists
or DoesNotExist, the values array must be empty.
This array is replaced during a strategic merge
patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value} pairs.
A single {key,value} in the matchLabels map is equivalent
to an element of matchExpressions, whose key field
is "key", the operator is "In", and the values array
contains only "value". The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
size:
description: "Disk size in bytes for example, \"10Gi\" for
10 Gibibytes. This field is required. \n The allowed size
unit prefixes are: \"Ki\", \"Mi\", \"Gi\", \"Ti, \"Pi\"
and \"Ei\" for 2-base. Also \"K\", \"M\", \"G\", \"T,
\"P\" and \"E\" for 10-base. See https://en.wikipedia.org/wiki/Unit_prefix."
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
type: string
storageClass:
description: "StorageClass points to a particular CSI storage
class. This field is optional. \n If the field is not
set, then the default CSI storage class for the Kubernetes
cluster is used. If there is no default for the Kubernetes
cluster, then the Persistence Volume Claim will fail
and the database cluster will fail to provision. \n You
can read more about storage classes in https://kubernetes.io/docs/concepts/storage/storage-classes."
type: string
volumeName:
description: "VolumeName is the binding reference to the
Persistent Volume tied to this disk. This field is optional.
\n This allows to reuse an existing volume. \n Note that
if this field is specified, the value \"storageClass\"
will not take effect. You can learn more about this in
https://kubernetes.io/docs/concepts/storage/persistent-volumes/#binding."
type: string
required:
- name
- size
type: object
type: array
memory:
anyOf:
- type: integer
- type: string
description: The amount of memory allocated to the database container.
This field is required.
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
type: object
schedulingconfig:
description: "SchedulingConfig specifies how the instance should be
scheduled on Kubernetes nodes. If omitted, the instance will use
the same scheduling config as the DBCluster's Primary Instance.
\n When any field inside the scheduling config changes, it can lead
to rescheduling of the Kubernetes pod onto a different node based on the
config."
properties:
nodeaffinity:
description: NodeAffinity describes node affinity scheduling rules
for the instance.
properties:
preferredDuringSchedulingIgnoredDuringExecution:
description: The scheduler prefers to schedule pods to
nodes that satisfy the affinity expressions specified by
this field. The scheduler might choose a node that violates one or
more of the expressions. The node that is most preferred
is the one with the greatest sum of weights, in other words, for each
node that meets all of the scheduling requirements (resource
request, requiredDuringScheduling affinity expressions,
etc.), compute a sum by iterating through the elements of
this field and adding "weight" to the sum, if the node matches
the corresponding matchExpressions; the node(s) with the
highest sum are the most preferred.
items:
description: An empty preferred scheduling term matches
all objects with implicit weight 0 (in other words, it's a no-op).
A null preferred scheduling term matches no objects (in other words,
is also a no-op).
properties:
preference:
description: A node selector term, associated with the
corresponding weight.
properties:
matchExpressions:
description: A list of node selector requirements
by node's labels.
items:
description: A node selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: The label key that the selector
applies to.
type: string
operator:
description: Represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, DoesNotExist. Gt, and
Lt.
type: string
values:
description: An array of string values. If
the operator is In or NotIn, the values
array must be non-empty. If the operator
is Exists or DoesNotExist, the values array
must be empty. If the operator is Gt or
Lt, the values array must have a single
element, which will be interpreted as an
integer. This array is replaced during a
strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchFields:
description: A list of node selector requirements
by node's fields.
items:
description: A node selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: The label key that the selector
applies to.
type: string
operator:
description: Represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, DoesNotExist. Gt, and
Lt.
type: string
values:
description: An array of string values. If
the operator is In or NotIn, the values
array must be non-empty. If the operator
is Exists or DoesNotExist, the values array
must be empty. If the operator is Gt or
Lt, the values array must have a single
element, which will be interpreted as an
integer. This array is replaced during a
strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
type: object
x-kubernetes-map-type: atomic
weight:
description: Weight associated with matching the corresponding
nodeSelectorTerm, in the range 1-100.
format: int32
type: integer
required:
- preference
- weight
type: object
type: array
requiredDuringSchedulingIgnoredDuringExecution:
description: If the affinity requirements specified by this
field isn't met at scheduling time, the pod is not
scheduled onto the node. If the affinity requirements specified
by this field aren't met at some point during pod execution
(e.g. due to an update), the system might or might not try to
eventually evict the pod from its node.
properties:
nodeSelectorTerms:
description: Required. A list of node selector terms.
The terms are ORed.
items:
description: A null or empty node selector term matches
no objects. The requirements of them are ANDed. The
TopologySelectorTerm type implements a subset of the
NodeSelectorTerm.
properties:
matchExpressions:
description: A list of node selector requirements
by node's labels.
items:
description: A node selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: The label key that the selector
applies to.
type: string
operator:
description: Represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, DoesNotExist. Gt, and
Lt.
type: string
values:
description: An array of string values. If
the operator is In or NotIn, the values
array must be non-empty. If the operator
is Exists or DoesNotExist, the values array
must be empty. If the operator is Gt or
Lt, the values array must have a single
element, which will be interpreted as an
integer. This array is replaced during a
strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchFields:
description: A list of node selector requirements
by node's fields.
items:
description: A node selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: The label key that the selector
applies to.
type: string
operator:
description: Represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, DoesNotExist. Gt, and
Lt.
type: string
values:
description: An array of string values. If
the operator is In or NotIn, the values
array must be non-empty. If the operator
is Exists or DoesNotExist, the values array
must be empty. If the operator is Gt or
Lt, the values array must have a single
element, which will be interpreted as an
integer. This array is replaced during a
strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
type: object
x-kubernetes-map-type: atomic
type: array
required:
- nodeSelectorTerms
type: object
x-kubernetes-map-type: atomic
type: object
podAffinity:
description: PodAffinity describes pod affinity scheduling rules
for the instance.
properties:
preferredDuringSchedulingIgnoredDuringExecution:
description: The scheduler prefers to schedule pods to
nodes that satisfy the affinity expressions specified by
this field. The scheduler might choose a node that violates one or
more of the expressions. The node that is most preferred
is the one with the greatest sum of weights, in other words, for each
node that meets all of the scheduling requirements (resource
request, requiredDuringScheduling affinity expressions,
etc.), compute a sum by iterating through the elements of
this field and adding "weight" to the sum, if the node has
pods which matches the corresponding podAffinityTerm. The
node(s) with the highest sum are the most preferred.
items:
description: The weights of all of the matched WeightedPodAffinityTerm
fields are added per-node to find the most preferred node(s).
properties:
podAffinityTerm:
description: Required. A pod affinity term, associated
with the corresponding weight.
properties:
labelSelector:
description: A label query over a set of resources,
in this case, pods.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are
ANDed.
items:
description: A label selector requirement
is a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: key is the label key that
the selector applies to.
type: string
operator:
description: operator represents a key's
relationship to a set of values. Valid
operators are In, NotIn, Exists, and
DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty.
If the operator is Exists or DoesNotExist,
the values array must be empty. This
array is replaced during a strategic
merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is
"In", and the values array contains only "value".
The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaceSelector:
description: A label query over the set of namespaces
that the term applies to. The term is applied
to the union of the namespaces selected by this
field and the ones listed in the namespaces field.
null selector and null or empty namespaces list
means "this pod's namespace". An empty selector
({}) matches all namespaces.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are
ANDed.
items:
description: A label selector requirement
is a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: key is the label key that
the selector applies to.
type: string
operator:
description: operator represents a key's
relationship to a set of values. Valid
operators are In, NotIn, Exists, and
DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty.
If the operator is Exists or DoesNotExist,
the values array must be empty. This
array is replaced during a strategic
merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is
"In", and the values array contains only "value".
The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaces:
description: namespaces specifies a static list
of namespace names that the term applies to. The
term is applied to the union of the namespaces
listed in this field and the ones selected by
namespaceSelector. null or empty namespaces list
and null namespaceSelector means "this pod's namespace".
items:
type: string
type: array
topologyKey:
description: This pod must be co-located (affinity)
or not co-located (anti-affinity) with the pods
matching the labelSelector in the specified namespaces.
Co-located is defined as running on a node
whose value of the label with key topologyKey
matches that of any node on which any of the selected
pods is running. Empty topologyKey is not allowed.
type: string
required:
- topologyKey
type: object
weight:
description: weight associated with matching the corresponding
podAffinityTerm, in the range 1-100.
format: int32
type: integer
required:
- podAffinityTerm
- weight
type: object
type: array
requiredDuringSchedulingIgnoredDuringExecution:
description: If the affinity requirements specified by this
field isn't met at scheduling time, the pod is not
scheduled onto the node. If the affinity requirements specified
by this field aren't met at some point during pod execution
- for example, due to a pod label update - the system might or might
not try to eventually evict the pod from its node. When
there are multiple elements, the lists of nodes corresponding
to each podAffinityTerm are intersected, in other words, all terms
must be satisfied.
items:
description: Defines a set of pods — namely, those matching
the labelSelector relative to the given namespace(s) —
that this pod must be co-located (affinity) or not co-located
(anti-affinity) with. Co-located is defined as running
on a node whose value of the label with key <topologyKey>
matches that of any node on which a pod of the set of
pods is running.
properties:
labelSelector:
description: A label query over a set of resources,
in this case, pods.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are ANDed.
items:
description: A label selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: key is the label key that the
selector applies to.
type: string
operator:
description: operator represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, and DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty. If the
operator is Exists or DoesNotExist, the
values array must be empty. This array is
replaced during a strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is "In",
and the values array contains only "value". The
requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaceSelector:
description: A label query over the set of namespaces
that the term applies to. The term is applied to the
union of the namespaces selected by this field and
the ones listed in the namespaces field. null selector
and null or empty namespaces list means "this pod's
namespace". An empty selector ({}) matches all namespaces.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are ANDed.
items:
description: A label selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: key is the label key that the
selector applies to.
type: string
operator:
description: operator represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, and DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty. If the
operator is Exists or DoesNotExist, the
values array must be empty. This array is
replaced during a strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is "In",
and the values array contains only "value". The
requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaces:
description: namespaces specifies a static list of namespace
names that the term applies to. The term is applied
to the union of the namespaces listed in this field
and the ones selected by namespaceSelector. null or
empty namespaces list and null namespaceSelector means
"this pod's namespace".
items:
type: string
type: array
topologyKey:
description: This pod must be co-located (affinity)
or not co-located (anti-affinity) with the pods matching
the labelSelector in the specified namespaces.
Co-located is defined as running on a node whose value
of the label with key topologyKey matches that of
any node on which any of the selected pods is running.
Empty topologyKey is not allowed.
type: string
required:
- topologyKey
type: object
type: array
type: object
podAntiAffinity:
description: PodAntiAffinity describes pod anti-affinity scheduling
rules for the instance.
properties:
preferredDuringSchedulingIgnoredDuringExecution:
description: The scheduler prefers to schedule pods to
nodes that satisfy the anti-affinity expressions specified
by this field, but the scheduler might choose a node that violates one
or more of the expressions. The node that is most preferred
is the one with the greatest sum of weights, in other words, for each
node that meets all of the scheduling requirements (resource
request, requiredDuringScheduling anti-affinity expressions,
etc.), compute a sum by iterating through the elements of
this field and adding "weight" to the sum, if the node has
pods which matches the corresponding podAffinityTerm. The
node(s) with the highest sum are the most preferred.
items:
description: The weights of all of the matched WeightedPodAffinityTerm
fields are added per-node to find the most preferred node(s).
properties:
podAffinityTerm:
description: Required. A pod affinity term, associated
with the corresponding weight.
properties:
labelSelector:
description: A label query over a set of resources,
in this case, pods.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are
ANDed.
items:
description: A label selector requirement
is a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: key is the label key that
the selector applies to.
type: string
operator:
description: operator represents a key's
relationship to a set of values. Valid
operators are In, NotIn, Exists, and
DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty.
If the operator is Exists or DoesNotExist,
the values array must be empty. This
array is replaced during a strategic
merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is
"In", and the values array contains only "value".
The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaceSelector:
description: A label query over the set of namespaces
that the term applies to. The term is applied
to the union of the namespaces selected by this
field and the ones listed in the namespaces field.
null selector and null or empty namespaces list
means "this pod's namespace". An empty selector
({}) matches all namespaces.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are
ANDed.
items:
description: A label selector requirement
is a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: key is the label key that
the selector applies to.
type: string
operator:
description: operator represents a key's
relationship to a set of values. Valid
operators are In, NotIn, Exists, and
DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty.
If the operator is Exists or DoesNotExist,
the values array must be empty. This
array is replaced during a strategic
merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is
"In", and the values array contains only "value".
The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaces:
description: namespaces specifies a static list
of namespace names that the term applies to. The
term is applied to the union of the namespaces
listed in this field and the ones selected by
namespaceSelector. null or empty namespaces list
and null namespaceSelector means "this pod's namespace".
items:
type: string
type: array
topologyKey:
description: This pod must be co-located (affinity)
or not co-located (anti-affinity) with the pods.
matching the labelSelector in the specified namespaces.
Co-located is defined as running on a node
whose value of the label with key topologyKey
matches that of any node on which any of the selected
pods is running. Empty topologyKey is not allowed.
type: string
required:
- topologyKey
type: object
weight:
description: weight associated with matching the corresponding
podAffinityTerm, in the range 1-100.
format: int32
type: integer
required:
- podAffinityTerm
- weight
type: object
type: array
requiredDuringSchedulingIgnoredDuringExecution:
description: If the anti-affinity requirements specified by
this field isn't met at scheduling time, the pod will
not be scheduled onto the node. If the anti-affinity requirements
specified by this field aren't met at some point during
pod execution - for example, due to a pod label update - the system
might or might not try to eventually evict the pod from its
node. When there are multiple elements, the lists of nodes
corresponding to each podAffinityTerm are intersected, which means
that all terms must be satisfied.
items:
description: Defines a set of pods — namely, those matching
the labelSelector relative to the given namespace(s) —
that this pod must be co-located (affinity) or not co-located
(anti-affinity) with. Co-located is defined as running
on a node whose value of the label with key <topologyKey>
matches that of any node on which a pod of the set of
pods is running.
properties:
labelSelector:
description: A label query over a set of resources,
in this case, pods.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are ANDed.
items:
description: A label selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: key is the label key that the
selector applies to.
type: string
operator:
description: operator represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, and DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty. If the
operator is Exists or DoesNotExist, the
values array must be empty. This array is
replaced during a strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is "In",
and the values array contains only "value". The
requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaceSelector:
description: A label query over the set of namespaces
that the term applies to. The term is applied to the
union of the namespaces selected by this field and
the ones listed in the namespaces field. null selector
and null or empty namespaces list means "this pod's
namespace". An empty selector ({}) matches all namespaces.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are ANDed.
items:
description: A label selector requirement is a
selector that contains values, a key, and an
operator that relates the key and values.
properties:
key:
description: key is the label key that the
selector applies to.
type: string
operator:
description: operator represents a key's relationship
to a set of values. Valid operators are
In, NotIn, Exists, and DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty. If the
operator is Exists or DoesNotExist, the
values array must be empty. This array is
replaced during a strategic merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is "In",
and the values array contains only "value". The
requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
namespaces:
description: namespaces specifies a static list of namespace
names that the term applies to. The term is applied
to the union of the namespaces listed in this field
and the ones selected by namespaceSelector. null or
empty namespaces list and null namespaceSelector means
"this pod's namespace".
items:
type: string
type: array
topologyKey:
description: This pod must be co-located (affinity)
or not co-located (anti-affinity) with the pods matching
the labelSelector in the specified namespaces. Co-located
is defined as running on a node whose value
of the label with key topologyKey matches that of
any node on which any of the selected pods is running.
Empty topologyKey is not allowed.
type: string
required:
- topologyKey
type: object
type: array
type: object
tolerations:
description: Tolerations to enable the management of whether to
allow or disallow scheduling an instance on a Kubernetes node
that has a specific taint applied.
items:
description: The pod this Toleration is attached to tolerates
any taint that matches the triple <key,value,effect> using
the matching operator <operator>.
properties:
effect:
description: Effect indicates the taint effect to match.
Empty means match all taint effects. When specified, allowed
values are NoSchedule, PreferNoSchedule and NoExecute.
type: string
key:
description: Key is the taint key that the toleration applies
to. Empty means match all taint keys. If the key is empty,
operator must be Exists. This combination means to match
all values and all keys.
type: string
operator:
description: Operator represents a key's relationship to
the value. Valid operators are Exists and Equal. Defaults
to Equal. Exists is equivalent to wildcard for value,
so that a pod can tolerate all taints of a particular
category.
type: string
tolerationSeconds:
description: TolerationSeconds represents the period of
time the toleration (which must be of effect NoExecute,
otherwise this field is ignored) tolerates the taint.
By default, it is not set, which means tolerate the taint
forever (do not evict). Zero and negative values will
be treated as 0 (evict immediately) by the system.
format: int64
type: integer
value:
description: Value is the taint value the toleration matches
to. If the operator is Exists, the value should be empty,
otherwise just a regular string.
type: string
type: object
type: array
type: object
required:
- nodeCount
type: object
status:
description: DBInstanceStatus defines the observed state of DBInstance
properties:
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as
information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
endpoints:
description: Endpoints are the endpoints from which the DBNodes in
the DBInstance can be accessed.
items:
description: Endpoint represents a access point through which user
can access the database.
properties:
name:
description: Name contains the name of the endpoint
type: string
value:
description: Value contains the endpoint information.
type: string
required:
- name
type: object
type: array
x-kubernetes-list-map-keys:
- name
x-kubernetes-list-type: map
observedGeneration:
description: 'The generation observed by the controller.'
format: int64
type: integer
reconciled:
description: 'Whether the resource was reconciled by the controller.'
type: boolean
type: object
type: object
served: true
storage: true
subresources:
status: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: deletestandbyjobs.alloydbomni.internal.dbadmin.goog
spec:
group: alloydbomni.internal.dbadmin.goog
names:
kind: DeleteStandbyJob
listKind: DeleteStandbyJobList
plural: deletestandbyjobs
singular: deletestandbyjob
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .spec.currentStep
name: CurrentStep
type: string
- jsonPath: .spec.attempt
name: Attempt
type: integer
- jsonPath: .spec.endTime
name: EndTime
type: string
- jsonPath: .spec.cleanup
name: Cleanup
type: boolean
name: v1
schema:
openAPIV3Schema:
description: DeleteStandbyJob is an internal workflow tracking object. Users
should not directly interact with this.
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
properties:
attempt:
default: 0
description: Attempt allows the workflow to smartly retry and choose
to fail if too many retries have occurred
type: integer
cleanup:
default: false
description: Cleanup is used to mark this object as safe for deletion.
type: boolean
currentStep:
description: CurrentStep is the current step of the workflow
type: string
currentStepTime:
description: CurrentStepTime allows us to see when the current step
was initiated which allows us to time out at the step level.
format: date-time
type: string
endTime:
description: EndTime is when the workflow has reached a terminal state
format: date-time
type: string
metadata:
additionalProperties:
type: string
description: Metadata is intended to allow different workflows to
attach data needed to execute this workflow, e.g. which DBC/instance/
other resource this is attached to
type: object
requeueTime:
description: RequeueTime if set, then tells the reconciler to requeue
this job to run at the specified time
format: date-time
type: string
startTime:
description: StartTime is when the workflow began.
format: date-time
type: string
required:
- attempt
- cleanup
type: object
status:
properties:
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as
information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
type: object
type: object
served: true
storage: true
subresources: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: failovers.alloydbomni.dbadmin.goog
spec:
group: alloydbomni.dbadmin.goog
names:
kind: Failover
listKind: FailoverList
plural: failovers
singular: failover
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .status.state
name: state
type: string
- jsonPath: .status.internal.phase
name: phase
type: string
name: v1
schema:
openAPIV3Schema:
description: Failover represents the parameters and status of a single failover
operation.
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
description: FailoverSpec represents the parameters of a single failover
operation.
properties:
dbclusterRef:
description: DBClusterRef is the DBCluster name to initiate a failover.
The `Failover` object must be created in the same namespace as the
DBCluster that it references. This field is required for Failover.
type: string
newPrimary:
description: NewPrimary is the standby instance to promote as the
new primary. If left empty, the system automatically picks the
best instance to failover to.
type: string
type: object
status:
description: FailoverStatus represents the current state of a failover.
properties:
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
createTime:
description: CreateTime is the time when the internal failover workflow
mechanism was created.
format: date-time
type: string
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as
information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
endTime:
description: EndTime is the time when failover reached its final state.
format: date-time
type: string
internal:
description: Internal is used by the system controllers. Do not rely
on the information in this section.
properties:
newPrimary:
description: NewPrimary is the instance that you are attempting
to failover to.
type: string
oldPrimary:
description: OldPrimary is the instance that was the primary at
the start of the failover.
type: string
phase:
description: Phase is used to keep track of the current state
of the failover.
enum:
- StopPrimary
- PromoteStandby
- ValidateNewPrimary
- UpdateOldPrimaryResources
- UpdateNewPrimaryResources
- Cleanup
- Complete
- UpdateStandbys
- Recreate
type: string
required:
- newPrimary
- oldPrimary
type: object
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
startTime:
description: StartTime is the time that the failover operation started.
format: date-time
type: string
state:
description: State is the current state of the failover operation.
The values are `InProgress`, `Success`, `Failed_RollbackInProgress`,
`Failed_RollbackSuccess`, and `Failed_RollbackFailed`. `InProgress` means
the failover is still in progress. `Success` means that the failover
has completed. It is complete when the new primary instance is successfully
promoted. `Failed_RollbackInProgress` means that the operator was
unable to promote the new primary instance, and that is attempting to
restart the old primary instance. `Failed_RollbackSuccess` means
that the operator was unable to promote the new primary instance,
and that it successfully restarted the old primary instance. `Failed_RollbackFailed`
means that the operator was unable to promote the new primary instance,
and that the operator wasn't able to restart the old primary instance. The DBCluster
might need to be manually repaired.
enum:
- InProgress
- Success
- Failed_RollbackInProgress
- Failed_RollbackSuccess
- Failed_RollbackFailed
type: string
type: object
type: object
served: true
storage: true
subresources:
status: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: replications.alloydbomni.dbadmin.goog
spec:
group: alloydbomni.dbadmin.goog
names:
kind: Replication
listKind: ReplicationList
plural: replications
singular: replication
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .spec.dbcluster.name
name: DBCluster
type: string
- jsonPath: .status.conditions[?(@.type=="Ready")].status
name: Ready
type: string
- jsonPath: .status.conditions[?(@.type=="Ready")].reason
name: ReadyReason
type: string
- jsonPath: .status.conditions[?(@.type=="Healthy")].status
name: Healthy
type: string
- jsonPath: .status.conditions[?(@.type=="Healthy")].reason
name: HealthyReason
type: string
name: v1
schema:
openAPIV3Schema:
description: Replication is the Schema for the Replications API.
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
description: ReplicationSpec defines the desired state of Replication.
properties:
dbcluster:
description: DBCluster is the DBCluster that this Replication belongs to.
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
downstream:
description: Downstream contains specifications for replication downstream database.
properties:
control:
description: Control specifies the replication operation to be
taken on this database. This field is required, and the allowed
values are setup, promote, and rewind.
enum:
- setup
- promote
- rewind
type: string
host:
description: Host is the upstream database's connection endpoint
that this database can access for replication.
type: string
password:
description: Password is the reference to the secret storing upstream
database's replication user password.
properties:
name:
description: name is unique within a namespace to reference
a secret resource.
type: string
namespace:
description: namespace defines the space within which the
secret name must be unique.
type: string
type: object
x-kubernetes-map-type: atomic
port:
description: Port is the upstream database's port that this database
can access for replication. Default is 5432.
format: int32
maximum: 65535
minimum: 1
type: integer
replicationSlotName:
description: ReplicationSlotName is the name of the replication
slot created on the upstream database, and will be used by this
database for replication.
type: string
username:
description: Username is the name of the replication user created
on the upstream database, and will be used by this database
to connect to upstream for replication.
type: string
required:
- control
- host
- password
- replicationSlotName
- username
type: object
upstream:
description: Upstream contains spec for replication upstream database.
properties:
password:
description: Password is the reference to the secret storing replication
user password. If not provided, a password is generated and stored in
a secret shown in status.
properties:
name:
description: name is unique within a namespace to reference
a secret resource.
type: string
namespace:
description: namespace defines the space within which the
secret name must be unique.
type: string
type: object
x-kubernetes-map-type: atomic
replicationSlotName:
description: ReplicationSlotName is the name of the replication
slot to be used for replication. If not provided, a replication
slot name is generated and shown in status.
type: string
username:
description: Username is the name of the replication user to be
used for replication. If not provided, a username is generated
and shown in status.
type: string
type: object
type: object
status:
description: ReplicationStatus defines the observed state of Replication.
properties:
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as
information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
downstream:
description: Downstream contains observed state of replication downstream
database.
type: object
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
upstream:
description: Upstream contains observed state of replication upstream
database.
properties:
host:
description: Host is this database's connection endpoint that
downstream databases can access for replication.
type: string
password:
description: Password is the reference to the secret storing this
database's replication user password.
properties:
name:
description: name is unique within a namespace to reference
a secret resource.
type: string
namespace:
description: namespace defines the space within which the
secret name must be unique.
type: string
type: object
x-kubernetes-map-type: atomic
port:
description: Port is this database's port that downstream databases
can access for replication.
format: int32
maximum: 65535
minimum: 1
type: integer
replicationSlotName:
description: ReplicationSlotName is the name of the replication
slot created on this database. Downstream databases can use
this replication slot for replication.
type: string
username:
description: Username is the name of the replication user on this
database. Downstream databases can use this user to connect
to this database for replication.
type: string
type: object
type: object
type: object
served: true
storage: true
subresources:
status: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: restores.alloydbomni.dbadmin.goog
spec:
group: alloydbomni.dbadmin.goog
names:
kind: Restore
listKind: RestoreList
plural: restores
shortNames:
- aoor
singular: restore
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .status.phase
name: Phase
type: string
- jsonPath: .status.completeTime
name: CompleteTime
type: string
- jsonPath: .status.restoredPointInTime
name: RestoredPointInTime
type: string
name: v1
schema:
openAPIV3Schema:
description: Restore is the Schema for the restores API
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
description: RestoreSpec defines the desired state of Restore.
properties:
backup:
description: The Backup to restore from. This field is optional. You
must specify either Backup or PointInTime. If you specify Backup,
then you must leave the ClonedDBClusterConfig field unspecified.
If you specify PointInTime, then you must provide a new DBCluster
name in the ClonedDBClusterConfig field. Otherwise, the Restore
request will be rejected.
type: string
clonedDBClusterConfig:
description: Settings for the cloned DBCluster. This lets you specify
the name for the cloned DBCluster. This field is optional. Default
to restore the source DBCluster if not specified.
properties:
dbclusterName:
description: The name of cloned DBCluster.
type: string
type: object
pointInTime:
description: Previous point in time to restore to. This field is optional.
Default to restore the latest available time point if not specified.
format: date-time
type: string
sourceDBCluster:
description: The name of the source DBCluster to restore from. This
field is required.
type: string
required:
- sourceDBCluster
type: object
status:
description: RestoreStatus defines the observed state of Restore.
properties:
completeTime:
description: Completion time of the Restore
format: date-time
type: string
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
createTime:
description: Creation time of the Restore
format: date-time
type: string
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as
information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
phase:
description: RestorePhase is the phase of a restore.
type: string
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
type: object
type: object
served: true
storage: true
subresources:
status: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: sidecars.alloydbomni.dbadmin.goog
spec:
group: alloydbomni.dbadmin.goog
names:
kind: Sidecar
listKind: SidecarList
plural: sidecars
shortNames:
- aoosc
singular: sidecar
scope: Namespaced
versions:
- name: v1
schema:
openAPIV3Schema:
description: Sidecar is the Schema for the sidecar API.
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
description: SidecarSpec specifies the desired state of Sidecar.
properties:
additionalVolumes:
description: AdditionalVolumes specifies a list of existing volumes
to mount into the sidecar containers. Refer to https://kubernetes.io/docs/concepts/storage/volumes/
for more information.
items:
description: Volume represents a named volume in a pod that may
be accessed by any container in the pod.
properties:
awsElasticBlockStore:
description: 'awsElasticBlockStore represents an AWS Disk resource
that is attached to a kubelet''s host machine and then exposed
to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore'
properties:
fsType:
description: 'fsType is the filesystem type of the volume
that you want to mount. Tip: Ensure that the filesystem
type is supported by the host operating system. Examples:
"ext4", "xfs", "ntfs". Implicitly inferred to be "ext4"
if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore'
type: string
partition:
description: 'partition is the partition in the volume that
you want to mount. If omitted, the default is to mount
by volume name. Examples: For volume /dev/sda1, you specify
the partition as "1". Similarly, the volume partition
for /dev/sda is "0" (or you can leave the property empty).'
format: int32
type: integer
readOnly:
description: 'readOnly value true will force the readOnly
setting in VolumeMounts. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore'
type: boolean
volumeID:
description: 'volumeID is unique ID of the persistent disk
resource in AWS (Amazon EBS volume). More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore'
type: string
required:
- volumeID
type: object
azureDisk:
description: azureDisk represents an Azure Data Disk mount on
the host and bind mount to the pod.
properties:
cachingMode:
description: 'cachingMode is the Host Caching mode: None,
Read Only, Read Write.'
type: string
diskName:
description: diskName is the Name of the data disk in the
blob storage
type: string
diskURI:
description: diskURI is the URI of data disk in the blob
storage
type: string
fsType:
description: fsType is Filesystem type to mount. Must be
a filesystem type supported by the host operating system.
Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4"
if unspecified.
type: string
kind:
description: 'kind expected values are Shared: multiple
blob disks per storage account Dedicated: single blob
disk per storage account Managed: azure managed data
disk (only in managed availability set). defaults to shared'
type: string
readOnly:
description: readOnly Defaults to false (read/write). ReadOnly
here will force the ReadOnly setting in VolumeMounts.
type: boolean
required:
- diskName
- diskURI
type: object
azureFile:
description: azureFile represents an Azure File Service mount
on the host and bind mount to the pod.
properties:
readOnly:
description: readOnly defaults to false (read/write). ReadOnly
here will force the ReadOnly setting in VolumeMounts.
type: boolean
secretName:
description: secretName is the name of secret that contains
Azure Storage Account Name and Key
type: string
shareName:
description: shareName is the azure share Name
type: string
required:
- secretName
- shareName
type: object
cephfs:
description: cephFS represents a Ceph FS mount on the host that
shares a pod's lifetime
properties:
monitors:
description: 'monitors is Required: Monitors is a collection
of Ceph monitors More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it'
items:
type: string
type: array
path:
description: 'path is Optional: Used as the mounted root,
rather than the full Ceph tree, default is /'
type: string
readOnly:
description: 'readOnly is Optional: Defaults to false (read/write).
ReadOnly here will force the ReadOnly setting in VolumeMounts.
More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it'
type: boolean
secretFile:
description: 'secretFile is Optional: SecretFile is the
path to key ring for User, default is /etc/ceph/user.secret
More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it'
type: string
secretRef:
description: 'secretRef is Optional: SecretRef is reference
to the authentication secret for User, default is empty.
More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it'
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
user:
description: 'user is optional: User is the rados user name,
default is admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it'
type: string
required:
- monitors
type: object
cinder:
description: 'cinder represents a cinder volume attached and
mounted on kubelets host machine. More info: https://examples.k8s.io/mysql-cinder-pd/README.md'
properties:
fsType:
description: 'fsType is the filesystem type to mount. Must
be a filesystem type supported by the host operating system.
Examples: "ext4", "xfs", "ntfs". Implicitly inferred to
be "ext4" if unspecified. More info: https://examples.k8s.io/mysql-cinder-pd/README.md'
type: string
readOnly:
description: 'readOnly defaults to false (read/write). ReadOnly
here will force the ReadOnly setting in VolumeMounts.
More info: https://examples.k8s.io/mysql-cinder-pd/README.md'
type: boolean
secretRef:
description: 'secretRef is optional: points to a secret
object containing parameters used to connect to OpenStack.'
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
volumeID:
description: 'volumeID used to identify the volume in cinder.
More info: https://examples.k8s.io/mysql-cinder-pd/README.md'
type: string
required:
- volumeID
type: object
configMap:
description: configMap represents a configMap that should populate
this volume
properties:
defaultMode:
description: 'defaultMode is optional: mode bits used to
set permissions on created files by default. Must be an
octal value between 0000 and 0777 or a decimal value between
0 and 511. YAML accepts both octal and decimal values,
JSON requires decimal values for mode bits. Defaults to
0644. Directories within the path are not affected by
this setting. This might be in conflict with other options
that affect the file mode, like fsGroup, and the result
can be other mode bits set.'
format: int32
type: integer
items:
description: items if unspecified, each key-value pair in
the Data field of the referenced ConfigMap will be projected
into the volume as a file whose name is the key and content
is the value. If specified, the listed keys will be projected
into the specified paths, and unlisted keys will not be
present. If a key is specified which is not present in
the ConfigMap, the volume setup will error unless it is
marked optional. Paths must be relative and may not contain
the '..' path or start with '..'.
items:
description: Maps a string key to a path within a volume.
properties:
key:
description: key is the key to project.
type: string
mode:
description: 'mode is Optional: mode bits used to
set permissions on this file. Must be an octal value
between 0000 and 0777 or a decimal value between
0 and 511. YAML accepts both octal and decimal values,
JSON requires decimal values for mode bits. If not
specified, the volume defaultMode will be used.
This might be in conflict with other options that
affect the file mode, like fsGroup, and the result
can be other mode bits set.'
format: int32
type: integer
path:
description: path is the relative path of the file
to map the key to. May not be an absolute path.
May not contain the path element '..'. May not start
with the string '..'.
type: string
required:
- key
- path
type: object
type: array
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
optional:
description: optional specify whether the ConfigMap or its
keys must be defined
type: boolean
type: object
x-kubernetes-map-type: atomic
csi:
description: csi (Container Storage Interface) represents ephemeral
storage that is handled by certain external CSI drivers (Beta
feature).
properties:
driver:
description: driver is the name of the CSI driver that handles
this volume. Consult with your admin for the correct name
as registered in the cluster.
type: string
fsType:
description: fsType to mount. Ex. "ext4", "xfs", "ntfs".
If not provided, the empty value is passed to the associated
CSI driver which will determine the default filesystem
to apply.
type: string
nodePublishSecretRef:
description: nodePublishSecretRef is a reference to the
secret object containing sensitive information to pass
to the CSI driver to complete the CSI NodePublishVolume
and NodeUnpublishVolume calls. This field is optional,
and may be empty if no secret is required. If the secret
object contains more than one secret, all secret references
are passed.
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
readOnly:
description: readOnly specifies a read-only configuration
for the volume. Defaults to false (read/write).
type: boolean
volumeAttributes:
additionalProperties:
type: string
description: volumeAttributes stores driver-specific properties
that are passed to the CSI driver. Consult your driver's
documentation for supported values.
type: object
required:
- driver
type: object
downwardAPI:
description: downwardAPI represents downward API about the pod
that should populate this volume
properties:
defaultMode:
description: 'Optional: mode bits to use on created files
by default. Must be a Optional: mode bits used to set
permissions on created files by default. Must be an octal
value between 0000 and 0777 or a decimal value between
0 and 511. YAML accepts both octal and decimal values,
JSON requires decimal values for mode bits. Defaults to
0644. Directories within the path are not affected by
this setting. This might be in conflict with other options
that affect the file mode, like fsGroup, and the result
can be other mode bits set.'
format: int32
type: integer
items:
description: Items is a list of downward API volume file
items:
description: DownwardAPIVolumeFile represents information
to create the file containing the pod field
properties:
fieldRef:
description: 'Required: Selects a field of the pod:
only annotations, labels, name and namespace are
supported.'
properties:
apiVersion:
description: Version of the schema the FieldPath
is written in terms of, defaults to "v1".
type: string
fieldPath:
description: Path of the field to select in the
specified API version.
type: string
required:
- fieldPath
type: object
x-kubernetes-map-type: atomic
mode:
description: 'Optional: mode bits used to set permissions
on this file, must be an octal value between 0000
and 0777 or a decimal value between 0 and 511. YAML
accepts both octal and decimal values, JSON requires
decimal values for mode bits. If not specified,
the volume defaultMode will be used. This might
be in conflict with other options that affect the
file mode, like fsGroup, and the result can be other
mode bits set.'
format: int32
type: integer
path:
description: 'Required: Path is the relative path
name of the file to be created. Must not be absolute
or contain the ''..'' path. Must be utf-8 encoded.
The first item of the relative path must not start
with ''..'''
type: string
resourceFieldRef:
description: 'Selects a resource of the container:
only resources limits and requests (limits.cpu,
limits.memory, requests.cpu and requests.memory)
are currently supported.'
properties:
containerName:
description: 'Container name: required for volumes,
optional for env vars'
type: string
divisor:
anyOf:
- type: integer
- type: string
description: Specifies the output format of the
exposed resources, defaults to "1"
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
resource:
description: 'Required: resource to select'
type: string
required:
- resource
type: object
x-kubernetes-map-type: atomic
required:
- path
type: object
type: array
type: object
emptyDir:
description: 'emptyDir represents a temporary directory that
shares a pod''s lifetime. More info: https://kubernetes.io/docs/concepts/storage/volumes#emptydir'
properties:
medium:
description: 'medium represents what type of storage medium
should back this directory. The default is "" which means
to use the node''s default medium. Must be an empty string
(default) or Memory. More info: https://kubernetes.io/docs/concepts/storage/volumes#emptydir'
type: string
sizeLimit:
anyOf:
- type: integer
- type: string
description: 'sizeLimit is the total amount of local storage
required for this EmptyDir volume. The size limit is also
applicable for memory medium. The maximum usage on memory
medium EmptyDir would be the minimum value between the
SizeLimit specified here and the sum of memory limits
of all containers in a pod. The default is nil which means
that the limit is undefined. More info: https://kubernetes.io/docs/concepts/storage/volumes#emptydir'
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
type: object
ephemeral:
description: "ephemeral represents a volume that is handled
by a cluster storage driver. The volume's lifecycle is tied
to the pod that defines it - it will be created before the
pod starts, and deleted when the pod is removed. \n Use this
if: a) the volume is only needed while the pod runs, b) features
of normal volumes like restoring from snapshot or capacity
tracking are needed, c) the storage driver is specified through
a storage class, and d) the storage driver supports dynamic
volume provisioning through a PersistentVolumeClaim (see EphemeralVolumeSource
for more information on the connection between this volume
type and PersistentVolumeClaim). \n Use PersistentVolumeClaim
or one of the vendor-specific APIs for volumes that persist
for longer than the lifecycle of an individual pod. \n Use
CSI for light-weight local ephemeral volumes if the CSI driver
is meant to be used that way - see the documentation of the
driver for more information. \n A pod can use both types of
ephemeral volumes and persistent volumes at the same time."
properties:
volumeClaimTemplate:
description: "Will be used to create a stand-alone PVC to
provision the volume. The pod in which this EphemeralVolumeSource
is embedded will be the owner of the PVC, in other words, the PVC
will be deleted together with the pod. The name of the
PVC will be `<pod name>-<volume name>` where `<volume
name>` is the name from the `PodSpec.Volumes` array entry.
Pod validation will reject the pod if the concatenated
name is not valid for a PVC (for example, too long). \n
An existing PVC with that name that is not owned by the
pod will *not* be used for the pod to avoid using an unrelated
volume by mistake. Starting the pod is then blocked until
the unrelated PVC is removed. If such a pre-created PVC
is meant to be used by the pod, the PVC has to updated
with an owner reference to the pod once the pod exists.
Normally this should not be necessary, but it may be useful
when manually reconstructing a broken cluster. \n This
field is read-only and no changes will be made by Kubernetes
to the PVC after it has been created. \n Required, must
not be nil."
properties:
metadata:
description: May contain labels and annotations that
will be copied into the PVC when creating it. No other
fields are allowed and will be rejected during validation.
type: object
spec:
description: The specification for the PersistentVolumeClaim.
The entire content is copied unchanged into the PVC
that gets created from this template. The same fields
as in a PersistentVolumeClaim are also valid here.
properties:
accessModes:
description: 'accessModes contains the desired access
modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1'
items:
type: string
type: array
dataSource:
description: 'dataSource field can be used to specify
either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot)
* An existing PVC (PersistentVolumeClaim) If the
provisioner or an external controller can support
the specified data source, it will create a new
volume based on the contents of the specified
data source. When the AnyVolumeDataSource feature
gate is enabled, dataSource contents will be copied
to dataSourceRef, and dataSourceRef contents will
be copied to dataSource when dataSourceRef.namespace
is not specified. If the namespace is specified,
then dataSourceRef will not be copied to dataSource.'
properties:
apiGroup:
description: APIGroup is the group for the resource
being referenced. If APIGroup is not specified,
the specified Kind must be in the core API
group. For any other third-party types, APIGroup
is required.
type: string
kind:
description: Kind is the type of resource being
referenced
type: string
name:
description: Name is the name of resource being
referenced
type: string
required:
- kind
- name
type: object
x-kubernetes-map-type: atomic
dataSourceRef:
description: 'dataSourceRef specifies the object
from which to populate the volume with data, if
a non-empty volume is desired. This may be any
object from a non-empty API group (non core object)
or a PersistentVolumeClaim object. When this field
is specified, volume binding will only succeed
if the type of the specified object matches some
installed volume populator or dynamic provisioner.
This field will replace the functionality of the
dataSource field and as such if both fields are
non-empty, they must have the same value. For
backwards compatibility, when namespace isn''t
specified in dataSourceRef, both fields (dataSource
and dataSourceRef) will be set to the same value
automatically if one of them is empty and the
other is non-empty. When namespace is specified
in dataSourceRef, dataSource isn''t set to the
same value and must be empty. There are three
important differences between dataSource and dataSourceRef:
* While dataSource only allows two specific types
of objects, dataSourceRef allows any non-core
object, as well as PersistentVolumeClaim objects.
* While dataSource ignores disallowed values (dropping
them), dataSourceRef preserves all values, and
generates an error if a disallowed value is specified.
* While dataSource only allows local objects,
dataSourceRef allows objects in any namespaces.
(Beta) Using this field requires the AnyVolumeDataSource
feature gate to be enabled. (Alpha) Using the
namespace field of dataSourceRef requires the
CrossNamespaceVolumeDataSource feature gate to
be enabled.'
properties:
apiGroup:
description: APIGroup is the group for the resource
being referenced. If APIGroup is not specified,
the specified Kind must be in the core API
group. For any other third-party types, APIGroup
is required.
type: string
kind:
description: Kind is the type of resource being
referenced
type: string
name:
description: Name is the name of resource being
referenced
type: string
namespace:
description: Namespace is the namespace of resource
being referenced Note that when a namespace
is specified, a gateway.networking.k8s.io/ReferenceGrant
object is required in the referent namespace
to allow that namespace's owner to accept
the reference. See the ReferenceGrant documentation
for details. (Alpha) This field requires the
CrossNamespaceVolumeDataSource feature gate
to be enabled.
type: string
required:
- kind
- name
type: object
resources:
description: 'resources represents the minimum resources
the volume should have. If RecoverVolumeExpansionFailure
feature is enabled users are allowed to specify
resource requirements that are lower than previous
value but must still be higher than capacity recorded
in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources'
properties:
claims:
description: "Claims lists the names of resources,
defined in spec.resourceClaims, that are used
by this container. \n This is an alpha field
and requires enabling the DynamicResourceAllocation
feature gate. \n This field is immutable.
It can only be set for containers."
items:
description: ResourceClaim references one
entry in PodSpec.ResourceClaims.
properties:
name:
description: Name must match the name
of one entry in pod.spec.resourceClaims
of the Pod where this field is used.
It makes that resource available inside
a container.
type: string
required:
- name
type: object
type: array
x-kubernetes-list-map-keys:
- name
x-kubernetes-list-type: map
limits:
additionalProperties:
anyOf:
- type: integer
- type: string
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
description: 'Limits describes the maximum amount
of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/'
type: object
requests:
additionalProperties:
anyOf:
- type: integer
- type: string
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
description: 'Requests describes the minimum
amount of compute resources required. If Requests
is omitted for a container, it defaults to
Limits if that is explicitly specified, otherwise
to an implementation-defined value. Requests
cannot exceed Limits. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/'
type: object
type: object
selector:
description: selector is a label query over volumes
to consider for binding.
properties:
matchExpressions:
description: matchExpressions is a list of label
selector requirements. The requirements are
ANDed.
items:
description: A label selector requirement
is a selector that contains values, a key,
and an operator that relates the key and
values.
properties:
key:
description: key is the label key that
the selector applies to.
type: string
operator:
description: operator represents a key's
relationship to a set of values. Valid
operators are In, NotIn, Exists, and
DoesNotExist.
type: string
values:
description: values is an array of string
values. If the operator is In or NotIn,
the values array must be non-empty.
If the operator is Exists or DoesNotExist,
the values array must be empty. This
array is replaced during a strategic
merge patch.
items:
type: string
type: array
required:
- key
- operator
type: object
type: array
matchLabels:
additionalProperties:
type: string
description: matchLabels is a map of {key,value}
pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions,
whose key field is "key", the operator is
"In", and the values array contains only "value".
The requirements are ANDed.
type: object
type: object
x-kubernetes-map-type: atomic
storageClassName:
description: 'storageClassName is the name of the
StorageClass required by the claim. More info:
https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1'
type: string
volumeMode:
description: volumeMode defines what type of volume
is required by the claim. Value of Filesystem
is implied when not included in claim spec.
type: string
volumeName:
description: volumeName is the binding reference
to the PersistentVolume backing this claim.
type: string
type: object
required:
- spec
type: object
type: object
fc:
description: fc represents a Fibre Channel resource that is
attached to a kubelet's host machine and then exposed to the
pod.
properties:
fsType:
description: 'fsType is the filesystem type to mount. Must
be a filesystem type supported by the host operating system.
Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4"
if unspecified.'
type: string
lun:
description: 'lun is Optional: FC target lun number'
format: int32
type: integer
readOnly:
description: 'readOnly is Optional: Defaults to false (read/write).
ReadOnly here will force the ReadOnly setting in VolumeMounts.'
type: boolean
targetWWNs:
description: 'targetWWNs is Optional: FC target worldwide
names (WWNs)'
items:
type: string
type: array
wwids:
description: 'wwids Optional: FC volume world wide identifiers
(wwids) Either wwids or combination of targetWWNs and
lun must be set, but not both simultaneously.'
items:
type: string
type: array
type: object
flexVolume:
description: flexVolume represents a generic volume resource
that is provisioned/attached using an exec based plugin.
properties:
driver:
description: driver is the name of the driver to use for
this volume.
type: string
fsType:
description: fsType is the filesystem type to mount. Must
be a filesystem type supported by the host operating system.
Ex. "ext4", "xfs", "ntfs". The default filesystem depends
on FlexVolume script.
type: string
options:
additionalProperties:
type: string
description: 'options is Optional: this field holds extra
command options if any.'
type: object
readOnly:
description: 'readOnly is Optional: defaults to false (read/write).
ReadOnly here will force the ReadOnly setting in VolumeMounts.'
type: boolean
secretRef:
description: 'secretRef is Optional: secretRef is reference
to the secret object containing sensitive information
to pass to the plugin scripts. This may be empty if no
secret object is specified. If the secret object contains
more than one secret, all secrets are passed to the plugin
scripts.'
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
required:
- driver
type: object
flocker:
description: flocker represents a Flocker volume attached to
a kubelet's host machine. This depends on the Flocker control
service being running
properties:
datasetName:
description: datasetName is Name of the dataset stored as
metadata -> name on the dataset for Flocker should be
considered as deprecated
type: string
datasetUUID:
description: datasetUUID is the UUID of the dataset. This
is unique identifier of a Flocker dataset
type: string
type: object
gcePersistentDisk:
description: 'gcePersistentDisk represents a GCE Disk resource
that is attached to a kubelet''s host machine and then exposed
to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk'
properties:
fsType:
description: 'fsType is filesystem type of the volume that
you want to mount. Tip: Ensure that the filesystem type
is supported by the host operating system. Examples: "ext4",
"xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk'
type: string
partition:
description: 'partition is the partition in the volume that
you want to mount. If omitted, the default is to mount
by volume name. Examples: For volume /dev/sda1, you specify
the partition as "1". Similarly, the volume partition
for /dev/sda is "0" (or you can leave the property empty).
More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk'
format: int32
type: integer
pdName:
description: 'pdName is unique name of the PD resource in
GCE. Used to identify the disk in GCE. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk'
type: string
readOnly:
description: 'readOnly here will force the ReadOnly setting
in VolumeMounts. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk'
type: boolean
required:
- pdName
type: object
gitRepo:
description: 'gitRepo represents a git repository at a particular
revision. DEPRECATED: GitRepo is deprecated. To provision
a container with a git repo, mount an EmptyDir into an InitContainer
that clones the repo using git, then mount the EmptyDir into
the Pod''s container.'
properties:
directory:
description: directory is the target directory name. Must
not contain or start with '..'. If '.' is supplied, the
volume directory will be the git repository. Otherwise,
if specified, the volume will contain the git repository
in the subdirectory with the given name.
type: string
repository:
description: repository is the URL
type: string
revision:
description: revision is the commit hash for the specified
revision.
type: string
required:
- repository
type: object
glusterfs:
description: 'glusterfs represents a Glusterfs mount on the
host that shares a pod''s lifetime. More info: https://examples.k8s.io/volumes/glusterfs/README.md'
properties:
endpoints:
description: 'endpoints is the endpoint name that details
Glusterfs topology. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod'
type: string
path:
description: 'path is the Glusterfs volume path. More info:
https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod'
type: string
readOnly:
description: 'readOnly here will force the Glusterfs volume
to be mounted with read-only permissions. Defaults to
false. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod'
type: boolean
required:
- endpoints
- path
type: object
hostPath:
description: 'hostPath represents a pre-existing file or directory
on the host machine that is directly exposed to the container.
This is generally used for system agents or other privileged
things that are allowed to see the host machine. Most containers
will NOT need this. More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath'
properties:
path:
description: 'path of the directory on the host. If the
path is a symlink, it will follow the link to the real
path. More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath'
type: string
type:
description: 'type for HostPath Volume Defaults to "" More
info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath'
type: string
required:
- path
type: object
iscsi:
description: 'iscsi represents an ISCSI Disk resource that is
attached to a kubelet''s host machine and then exposed to
the pod. More info: https://examples.k8s.io/volumes/iscsi/README.md'
properties:
chapAuthDiscovery:
description: chapAuthDiscovery defines whether support iSCSI
Discovery CHAP authentication
type: boolean
chapAuthSession:
description: chapAuthSession defines whether support iSCSI
Session CHAP authentication
type: boolean
fsType:
description: 'fsType is the filesystem type of the volume
that you want to mount. Tip: Ensure that the filesystem
type is supported by the host operating system. Examples:
"ext4", "xfs", "ntfs". Implicitly inferred to be "ext4"
if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#iscsi.'
type: string
initiatorName:
description: initiatorName is the custom iSCSI Initiator
Name. If initiatorName is specified with iscsiInterface
simultaneously, new iSCSI interface <target portal>:<volume
name> will be created for the connection.
type: string
iqn:
description: iqn is the target iSCSI Qualified Name.
type: string
iscsiInterface:
description: iscsiInterface is the interface Name that uses
an iSCSI transport. Defaults to 'default' (tcp).
type: string
lun:
description: lun represents iSCSI Target Lun number.
format: int32
type: integer
portals:
description: portals is the iSCSI Target Portal List. The
portal is either an IP or ip_addr:port if the port is
other than default (typically TCP ports 860 and 3260).
items:
type: string
type: array
readOnly:
description: readOnly here will force the ReadOnly setting
in VolumeMounts. Defaults to false.
type: boolean
secretRef:
description: secretRef is the CHAP Secret for iSCSI target
and initiator authentication
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
targetPortal:
description: targetPortal is iSCSI Target Portal. The Portal
is either an IP or ip_addr:port if the port is other than
default (typically TCP ports 860 and 3260).
type: string
required:
- iqn
- lun
- targetPortal
type: object
name:
description: 'name of the volume. Must be a DNS_LABEL and unique
within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names'
type: string
nfs:
description: 'nfs represents an NFS mount on the host that shares
a pod''s lifetime More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs'
properties:
path:
description: 'path that is exported by the NFS server. More
info: https://kubernetes.io/docs/concepts/storage/volumes#nfs'
type: string
readOnly:
description: 'readOnly here will force the NFS export to
be mounted with read-only permissions. Defaults to false.
More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs'
type: boolean
server:
description: 'server is the hostname or IP address of the
NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs'
type: string
required:
- path
- server
type: object
persistentVolumeClaim:
description: 'persistentVolumeClaimVolumeSource represents a
reference to a PersistentVolumeClaim in the same namespace.
More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims'
properties:
claimName:
description: 'claimName is the name of a PersistentVolumeClaim
in the same namespace as the pod using this volume. More
info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims'
type: string
readOnly:
description: readOnly Will force the ReadOnly setting in
VolumeMounts. Default false.
type: boolean
required:
- claimName
type: object
photonPersistentDisk:
description: photonPersistentDisk represents a PhotonController
persistent disk attached and mounted on kubelets host machine
properties:
fsType:
description: fsType is the filesystem type to mount. Must
be a filesystem type supported by the host operating system.
Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4"
if unspecified.
type: string
pdID:
description: pdID is the ID that identifies Photon Controller
persistent disk
type: string
required:
- pdID
type: object
portworxVolume:
description: portworxVolume represents a portworx volume attached
and mounted on kubelets host machine
properties:
fsType:
description: fSType represents the filesystem type to mount
Must be a filesystem type supported by the host operating
system. Ex. "ext4", "xfs". Implicitly inferred to be "ext4"
if unspecified.
type: string
readOnly:
description: readOnly defaults to false (read/write). ReadOnly
here will force the ReadOnly setting in VolumeMounts.
type: boolean
volumeID:
description: volumeID uniquely identifies a Portworx volume
type: string
required:
- volumeID
type: object
projected:
description: projected items for all in one resources secrets,
configmaps, and downward API
properties:
defaultMode:
description: defaultMode are the mode bits used to set permissions
on created files by default. Must be an octal value between
0000 and 0777 or a decimal value between 0 and 511. YAML
accepts both octal and decimal values, JSON requires decimal
values for mode bits. Directories within the path are
not affected by this setting. This might be in conflict
with other options that affect the file mode, like fsGroup,
and the result can be other mode bits set.
format: int32
type: integer
sources:
description: sources is the list of volume projections
items:
description: Projection that may be projected along with
other supported volume types
properties:
configMap:
description: configMap information about the configMap
data to project
properties:
items:
description: items if unspecified, each key-value
pair in the Data field of the referenced ConfigMap
will be projected into the volume as a file
whose name is the key and content is the value.
If specified, the listed keys will be projected
into the specified paths, and unlisted keys
will not be present. If a key is specified which
is not present in the ConfigMap, the volume
setup will error unless it is marked optional.
Paths must be relative and may not contain the
'..' path or start with '..'.
items:
description: Maps a string key to a path within
a volume.
properties:
key:
description: key is the key to project.
type: string
mode:
description: 'mode is Optional: mode bits
used to set permissions on this file.
Must be an octal value between 0000 and
0777 or a decimal value between 0 and
511. YAML accepts both octal and decimal
values, JSON requires decimal values for
mode bits. If not specified, the volume
defaultMode will be used. This might be
in conflict with other options that affect
the file mode, like fsGroup, and the result
can be other mode bits set.'
format: int32
type: integer
path:
description: path is the relative path of
the file to map the key to. May not be
an absolute path. May not contain the
path element '..'. May not start with
the string '..'.
type: string
required:
- key
- path
type: object
type: array
name:
description: 'Name of the referent. More info:
https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
optional:
description: optional specify whether the ConfigMap
or its keys must be defined
type: boolean
type: object
x-kubernetes-map-type: atomic
downwardAPI:
description: downwardAPI information about the downwardAPI
data to project
properties:
items:
description: Items is a list of DownwardAPIVolume
file
items:
description: DownwardAPIVolumeFile represents
information to create the file containing
the pod field
properties:
fieldRef:
description: 'Required: Selects a field
of the pod: only annotations, labels,
name and namespace are supported.'
properties:
apiVersion:
description: Version of the schema the
FieldPath is written in terms of,
defaults to "v1".
type: string
fieldPath:
description: Path of the field to select
in the specified API version.
type: string
required:
- fieldPath
type: object
x-kubernetes-map-type: atomic
mode:
description: 'Optional: mode bits used to
set permissions on this file, must be
an octal value between 0000 and 0777 or
a decimal value between 0 and 511. YAML
accepts both octal and decimal values,
JSON requires decimal values for mode
bits. If not specified, the volume defaultMode
will be used. This might be in conflict
with other options that affect the file
mode, like fsGroup, and the result can
be other mode bits set.'
format: int32
type: integer
path:
description: 'Required: Path is the relative
path name of the file to be created. Must
not be absolute or contain the ''..''
path. Must be utf-8 encoded. The first
item of the relative path must not start
with ''..'''
type: string
resourceFieldRef:
description: 'Selects a resource of the
container: only resources limits and requests
(limits.cpu, limits.memory, requests.cpu
and requests.memory) are currently supported.'
properties:
containerName:
description: 'Container name: required
for volumes, optional for env vars'
type: string
divisor:
anyOf:
- type: integer
- type: string
description: Specifies the output format
of the exposed resources, defaults
to "1"
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
resource:
description: 'Required: resource to
select'
type: string
required:
- resource
type: object
x-kubernetes-map-type: atomic
required:
- path
type: object
type: array
type: object
secret:
description: secret information about the secret data
to project
properties:
items:
description: items if unspecified, each key-value
pair in the Data field of the referenced Secret
will be projected into the volume as a file
whose name is the key and content is the value.
If specified, the listed keys will be projected
into the specified paths, and unlisted keys
will not be present. If a key is specified which
is not present in the Secret, the volume setup
will error unless it is marked optional. Paths
must be relative and may not contain the '..'
path or start with '..'.
items:
description: Maps a string key to a path within
a volume.
properties:
key:
description: key is the key to project.
type: string
mode:
description: 'mode is Optional: mode bits
used to set permissions on this file.
Must be an octal value between 0000 and
0777 or a decimal value between 0 and
511. YAML accepts both octal and decimal
values, JSON requires decimal values for
mode bits. If not specified, the volume
defaultMode will be used. This might be
in conflict with other options that affect
the file mode, like fsGroup, and the result
can be other mode bits set.'
format: int32
type: integer
path:
description: path is the relative path of
the file to map the key to. May not be
an absolute path. May not contain the
path element '..'. May not start with
the string '..'.
type: string
required:
- key
- path
type: object
type: array
name:
description: 'Name of the referent. More info:
https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
optional:
description: optional field specify whether the
Secret or its key must be defined
type: boolean
type: object
x-kubernetes-map-type: atomic
serviceAccountToken:
description: serviceAccountToken is information about
the serviceAccountToken data to project
properties:
audience:
description: audience is the intended audience
of the token. A recipient of a token must identify
itself with an identifier specified in the audience
of the token, and otherwise should reject the
token. The audience defaults to the identifier
of the apiserver.
type: string
expirationSeconds:
description: expirationSeconds is the requested
duration of validity of the service account
token. As the token approaches expiration, the
kubelet volume plugin will proactively rotate
the service account token. The kubelet will
start trying to rotate the token if the token
is older than 80 percent of its time to live
or if the token is older than 24 hours.Defaults
to 1 hour and must be at least 10 minutes.
format: int64
type: integer
path:
description: path is the path relative to the
mount point of the file to project the token
into.
type: string
required:
- path
type: object
type: object
type: array
type: object
quobyte:
description: quobyte represents a Quobyte mount on the host
that shares a pod's lifetime
properties:
group:
description: group to map volume access to Default is no
group
type: string
readOnly:
description: readOnly here will force the Quobyte volume
to be mounted with read-only permissions. Defaults to
false.
type: boolean
registry:
description: registry represents a single or multiple Quobyte
Registry services specified as a string as host:port pair
(multiple entries are separated with commas) which acts
as the central registry for volumes
type: string
tenant:
description: tenant owning the given Quobyte volume in the
Backend Used with dynamically provisioned Quobyte volumes,
value is set by the plugin
type: string
user:
description: user to map volume access to Defaults to serivceaccount
user
type: string
volume:
description: volume is a string that references an already
created Quobyte volume by name.
type: string
required:
- registry
- volume
type: object
rbd:
description: 'rbd represents a Rados Block Device mount on the
host that shares a pod''s lifetime. More info: https://examples.k8s.io/volumes/rbd/README.md'
properties:
fsType:
description: 'fsType is the filesystem type of the volume
that you want to mount. Tip: Ensure that the filesystem
type is supported by the host operating system. Examples:
"ext4", "xfs", "ntfs". Implicitly inferred to be "ext4"
if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#rbd.'
type: string
image:
description: 'image is the rados image name. More info:
https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it'
type: string
keyring:
description: 'keyring is the path to key ring for RBDUser.
Default is /etc/ceph/keyring. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it'
type: string
monitors:
description: 'monitors is a collection of Ceph monitors.
More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it'
items:
type: string
type: array
pool:
description: 'pool is the rados pool name. Default is rbd.
More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it'
type: string
readOnly:
description: 'readOnly here will force the ReadOnly setting
in VolumeMounts. Defaults to false. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it'
type: boolean
secretRef:
description: 'secretRef is name of the authentication secret
for RBDUser. If provided overrides keyring. Default is
nil. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it'
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
user:
description: 'user is the rados user name. Default is admin.
More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it'
type: string
required:
- image
- monitors
type: object
scaleIO:
description: scaleIO represents a ScaleIO persistent volume
attached and mounted on Kubernetes nodes.
properties:
fsType:
description: fsType is the filesystem type to mount. Must
be a filesystem type supported by the host operating system.
Ex. "ext4", "xfs", "ntfs". Default is "xfs".
type: string
gateway:
description: gateway is the host address of the ScaleIO
API Gateway.
type: string
protectionDomain:
description: protectionDomain is the name of the ScaleIO
Protection Domain for the configured storage.
type: string
readOnly:
description: readOnly Defaults to false (read/write). ReadOnly
here will force the ReadOnly setting in VolumeMounts.
type: boolean
secretRef:
description: secretRef references to the secret for ScaleIO
user and other sensitive information. If this is not provided,
Login operation will fail.
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
sslEnabled:
description: sslEnabled Flag enable/disable SSL communication
with Gateway, default false
type: boolean
storageMode:
description: storageMode indicates whether the storage for
a volume should be ThickProvisioned or ThinProvisioned.
Default is ThinProvisioned.
type: string
storagePool:
description: storagePool is the ScaleIO Storage Pool associated
with the protection domain.
type: string
system:
description: system is the name of the storage system as
configured in ScaleIO.
type: string
volumeName:
description: volumeName is the name of a volume already
created in the ScaleIO system that is associated with
this volume source.
type: string
required:
- gateway
- secretRef
- system
type: object
secret:
description: 'secret represents a secret that should populate
this volume. More info: https://kubernetes.io/docs/concepts/storage/volumes#secret'
properties:
defaultMode:
description: 'defaultMode is Optional: mode bits used to
set permissions on created files by default. Must be an
octal value between 0000 and 0777 or a decimal value between
0 and 511. YAML accepts both octal and decimal values,
JSON requires decimal values for mode bits. Defaults to
0644. Directories within the path are not affected by
this setting. This might be in conflict with other options
that affect the file mode, like fsGroup, and the result
can be other mode bits set.'
format: int32
type: integer
items:
description: items If unspecified, each key-value pair in
the Data field of the referenced Secret will be projected
into the volume as a file whose name is the key and content
is the value. If specified, the listed keys will be projected
into the specified paths, and unlisted keys will not be
present. If a key is specified which is not present in
the Secret, the volume setup will error unless it is marked
optional. Paths must be relative and may not contain the
'..' path or start with '..'.
items:
description: Maps a string key to a path within a volume.
properties:
key:
description: key is the key to project.
type: string
mode:
description: 'mode is Optional: mode bits used to
set permissions on this file. Must be an octal value
between 0000 and 0777 or a decimal value between
0 and 511. YAML accepts both octal and decimal values,
JSON requires decimal values for mode bits. If not
specified, the volume defaultMode will be used.
This might be in conflict with other options that
affect the file mode, like fsGroup, and the result
can be other mode bits set.'
format: int32
type: integer
path:
description: path is the relative path of the file
to map the key to. May not be an absolute path.
May not contain the path element '..'. May not start
with the string '..'.
type: string
required:
- key
- path
type: object
type: array
optional:
description: optional field specify whether the Secret or
its keys must be defined
type: boolean
secretName:
description: 'secretName is the name of the secret in the
pod''s namespace to use. More info: https://kubernetes.io/docs/concepts/storage/volumes#secret'
type: string
type: object
storageos:
description: storageOS represents a StorageOS volume attached
and mounted on Kubernetes nodes.
properties:
fsType:
description: fsType is the filesystem type to mount. Must
be a filesystem type supported by the host operating system.
Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4"
if unspecified.
type: string
readOnly:
description: readOnly defaults to false (read/write). ReadOnly
here will force the ReadOnly setting in VolumeMounts.
type: boolean
secretRef:
description: secretRef specifies the secret to use for obtaining
the StorageOS API credentials. If not specified, default
values will be attempted.
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
type: object
x-kubernetes-map-type: atomic
volumeName:
description: volumeName is the human-readable name of the
StorageOS volume. Volume names are only unique within
a namespace.
type: string
volumeNamespace:
description: volumeNamespace specifies the scope of the
volume within StorageOS. If no namespace is specified
then the Pod's namespace will be used. This allows the
Kubernetes name scoping to be mirrored within StorageOS
for tighter integration. Set VolumeName to any name to
override the default behaviour. Set to "default" if you
are not using namespaces within StorageOS. Namespaces
that do not pre-exist within StorageOS will be created.
type: string
type: object
vsphereVolume:
description: vsphereVolume represents a vSphere volume attached
and mounted on kubelets host machine
properties:
fsType:
description: fsType is filesystem type to mount. Must be
a filesystem type supported by the host operating system.
Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4"
if unspecified.
type: string
storagePolicyID:
description: storagePolicyID is the storage Policy Based
Management (SPBM) profile ID associated with the StoragePolicyName.
type: string
storagePolicyName:
description: storagePolicyName is the storage Policy Based
Management (SPBM) profile name.
type: string
volumePath:
description: volumePath is the path that identifies vSphere
volume vmdk
type: string
required:
- volumePath
type: object
required:
- name
type: object
type: array
sidecars:
description: Sidecar specifies a list of sidecar containers to inject
into the database pod. Refer to https://kubernetes.io/docs/concepts/containers/
for more information.
items:
description: A single application container that you want to run
within a pod.
properties:
args:
description: 'Arguments to the entrypoint. The container image''s
CMD is used if this is not provided. Variable references $(VAR_NAME)
are expanded using the container''s environment. If a variable
cannot be resolved, the reference in the input string will
be unchanged. Double $$ are reduced to a single $, which allows
for escaping the $(VAR_NAME) syntax: "$$(VAR_NAME)" will
produce the string literal "$(VAR_NAME)". Escaped references
will never be expanded, regardless of whether the variable
exists or not. Cannot be updated. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell'
items:
type: string
type: array
command:
description: 'Entrypoint array. Not executed within a shell.
The container image''s ENTRYPOINT is used if this is not provided.
Variable references $(VAR_NAME) are expanded using the container''s
environment. If a variable cannot be resolved, the reference
in the input string will be unchanged. Double $$ are reduced
to a single $, which allows for escaping the $(VAR_NAME) syntax:
"$$(VAR_NAME)" will produce the string literal "$(VAR_NAME)".
Escaped references will never be expanded, regardless of whether
the variable exists or not. Cannot be updated. More info:
https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell'
items:
type: string
type: array
env:
description: List of environment variables to set in the container.
Cannot be updated.
items:
description: EnvVar represents an environment variable present
in a Container.
properties:
name:
description: Name of the environment variable. Must be
a C_IDENTIFIER.
type: string
value:
description: 'Variable references $(VAR_NAME) are expanded
using the previously defined environment variables in
the container and any service environment variables.
If a variable cannot be resolved, the reference in the
input string will be unchanged. Double $$ are reduced
to a single $, which allows for escaping the $(VAR_NAME)
syntax: "$$(VAR_NAME)" will produce the string
literal "$(VAR_NAME)". Escaped references will never
be expanded, regardless of whether the variable exists
or not. Defaults to "".'
type: string
valueFrom:
description: Source for the environment variable's value.
Cannot be used if value is not empty.
properties:
configMapKeyRef:
description: Selects a key of a ConfigMap.
properties:
key:
description: The key to select.
type: string
name:
description: 'Name of the referent. More info:
https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
optional:
description: Specify whether the ConfigMap or
its key must be defined
type: boolean
required:
- key
type: object
x-kubernetes-map-type: atomic
fieldRef:
description: 'Selects a field of the pod: supports
metadata.name, metadata.namespace, `metadata.labels[''<KEY>'']`,
`metadata.annotations[''<KEY>'']`, spec.nodeName,
spec.serviceAccountName, status.hostIP, status.podIP,
status.podIPs.'
properties:
apiVersion:
description: Version of the schema the FieldPath
is written in terms of, defaults to "v1".
type: string
fieldPath:
description: Path of the field to select in the
specified API version.
type: string
required:
- fieldPath
type: object
x-kubernetes-map-type: atomic
resourceFieldRef:
description: 'Selects a resource of the container:
only resources limits and requests (limits.cpu,
limits.memory, limits.ephemeral-storage, requests.cpu,
requests.memory and requests.ephemeral-storage)
are currently supported.'
properties:
containerName:
description: 'Container name: required for volumes,
optional for env vars'
type: string
divisor:
anyOf:
- type: integer
- type: string
description: Specifies the output format of the
exposed resources, defaults to "1"
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
resource:
description: 'Required: resource to select'
type: string
required:
- resource
type: object
x-kubernetes-map-type: atomic
secretKeyRef:
description: Selects a key of a secret in the pod's
namespace
properties:
key:
description: The key of the secret to select from. Must
be a valid secret key.
type: string
name:
description: 'Name of the referent. More info:
https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
optional:
description: Specify whether the Secret or its
key must be defined
type: boolean
required:
- key
type: object
x-kubernetes-map-type: atomic
type: object
required:
- name
type: object
type: array
envFrom:
description: List of sources to populate environment variables
in the container. The keys defined within a source must be
a C_IDENTIFIER. All invalid keys will be reported as an event
when the container is starting. When a key exists in multiple
sources, the value associated with the last source will take
precedence. Values defined by an Env with a duplicate key
will take precedence. Cannot be updated.
items:
description: EnvFromSource represents the source of a set
of ConfigMaps
properties:
configMapRef:
description: The ConfigMap to select from
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
optional:
description: Specify whether the ConfigMap must be
defined
type: boolean
type: object
x-kubernetes-map-type: atomic
prefix:
description: An optional identifier to prepend to each
key in the ConfigMap. Must be a C_IDENTIFIER.
type: string
secretRef:
description: The Secret to select from
properties:
name:
description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names.'
type: string
optional:
description: Specify whether the Secret must be defined
type: boolean
type: object
x-kubernetes-map-type: atomic
type: object
type: array
image:
description: 'Container image name. More info: https://kubernetes.io/docs/concepts/containers/images
This field is optional to allow higher level config management
to default or override container images in workload controllers
like Deployments and StatefulSets.'
type: string
imagePullPolicy:
description: 'Image pull policy. One of Always, Never, IfNotPresent.
Defaults to Always if :{{ .Chart.Version }} tag is specified, or IfNotPresent
otherwise. Cannot be updated. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images'
type: string
lifecycle:
description: Actions that the management system should take
in response to container lifecycle events. Cannot be updated.
properties:
postStart:
description: 'PostStart is called immediately after a container
is created. If the handler fails, the container is terminated
and restarted according to its restart policy. Other management
of the container blocks until the hook completes. More
info: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks'
properties:
exec:
description: Exec specifies the action to take.
properties:
command:
description: Command is the command line to execute
inside the container, the working directory for
the command is root ('/') in the container's
filesystem. The command is simply exec'd, it is
not run inside a shell, so traditional shell instructions
('|', etc) won't work. To use a shell, you need
to explicitly call out to that shell. Exit status
of 0 is treated as live/healthy and non-zero is
unhealthy.
items:
type: string
type: array
type: object
httpGet:
description: HTTPGet specifies the http request to perform.
properties:
host:
description: Host name to connect to, defaults to
the pod IP. You probably want to set "Host" in
httpHeaders instead.
type: string
httpHeaders:
description: Custom headers to set in the request.
HTTP allows repeated headers.
items:
description: HTTPHeader describes a custom header
to be used in HTTP probes
properties:
name:
description: The header field name. This will
be canonicalized upon output, so case-variant
names will be understood as the same header.
type: string
value:
description: The header field value
type: string
required:
- name
- value
type: object
type: array
path:
description: Path to access on the HTTP server.
type: string
port:
anyOf:
- type: integer
- type: string
description: Name or number of the port to access
on the container. Number must be in the range
1 to 65535. Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
scheme:
description: Scheme to use for connecting to the
host. Defaults to HTTP.
type: string
required:
- port
type: object
tcpSocket:
description: Deprecated. TCPSocket is NOT supported
as a LifecycleHandler and kept for the backward compatibility.
There are no validation of this field and lifecycle
hooks will fail in runtime when tcp handler is specified.
properties:
host:
description: 'Optional: Host name to connect to,
defaults to the pod IP.'
type: string
port:
anyOf:
- type: integer
- type: string
description: Number or name of the port to access
on the container. Number must be in the range
1 to 65535. Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
required:
- port
type: object
type: object
preStop:
description: 'PreStop is called immediately before a container
is terminated due to an API request or management event
such as liveness/startup probe failure, preemption, resource
contention, etc. The handler is not called if the container
crashes or exits. The Pod''s termination grace period
countdown begins before the PreStop hook is executed.
Regardless of the outcome of the handler, the container
will eventually terminate within the Pod''s termination
grace period (unless delayed by finalizers). Other management
of the container blocks until the hook completes or until
the termination grace period is reached. More info: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks'
properties:
exec:
description: Exec specifies the action to take.
properties:
command:
description: Command is the command line to execute
inside the container, the working directory for
the command is root ('/') in the container's
filesystem. The command is simply exec'd, it is
not run inside a shell, so traditional shell instructions
('|', etc) won't work. To use a shell, you need
to explicitly call out to that shell. Exit status
of 0 is treated as live/healthy and non-zero is
unhealthy.
items:
type: string
type: array
type: object
httpGet:
description: HTTPGet specifies the http request to perform.
properties:
host:
description: Host name to connect to, defaults to
the pod IP. You probably want to set "Host" in
httpHeaders instead.
type: string
httpHeaders:
description: Custom headers to set in the request.
HTTP allows repeated headers.
items:
description: HTTPHeader describes a custom header
to be used in HTTP probes
properties:
name:
description: The header field name. This will
be canonicalized upon output, so case-variant
names will be understood as the same header.
type: string
value:
description: The header field value
type: string
required:
- name
- value
type: object
type: array
path:
description: Path to access on the HTTP server.
type: string
port:
anyOf:
- type: integer
- type: string
description: Name or number of the port to access
on the container. Number must be in the range
1 to 65535. Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
scheme:
description: Scheme to use for connecting to the
host. Defaults to HTTP.
type: string
required:
- port
type: object
tcpSocket:
description: Deprecated. TCPSocket is NOT supported
as a LifecycleHandler and kept for the backward compatibility.
There are no validation of this field and lifecycle
hooks will fail in runtime when tcp handler is specified.
properties:
host:
description: 'Optional: Host name to connect to,
defaults to the pod IP.'
type: string
port:
anyOf:
- type: integer
- type: string
description: Number or name of the port to access
on the container. Number must be in the range
1 to 65535. Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
required:
- port
type: object
type: object
type: object
livenessProbe:
description: 'Periodic probe of container liveness. Container
will be restarted if the probe fails. Cannot be updated. More
info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes'
properties:
exec:
description: Exec specifies the action to take.
properties:
command:
description: Command is the command line to execute
inside the container, the working directory for the
command is root ('/') in the container's filesystem.
The command is simply exec'd, it is not run inside
a shell, so traditional shell instructions ('|', etc)
won't work. To use a shell, you need to explicitly
call out to that shell. Exit status of 0 is treated
as live/healthy and non-zero is unhealthy.
items:
type: string
type: array
type: object
failureThreshold:
description: Minimum consecutive failures for the probe
to be considered failed after having succeeded. Defaults
to 3. Minimum value is 1.
format: int32
type: integer
grpc:
description: GRPC specifies an action involving a GRPC port.
properties:
port:
description: Port number of the gRPC service. Number
must be in the range 1 to 65535.
format: int32
type: integer
service:
description: "Service is the name of the service to
place in the gRPC HealthCheckRequest (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md).
\n If this is not specified, the default behavior
is defined by gRPC."
type: string
required:
- port
type: object
httpGet:
description: HTTPGet specifies the http request to perform.
properties:
host:
description: Host name to connect to, defaults to the
pod IP. You probably want to set "Host" in httpHeaders
instead.
type: string
httpHeaders:
description: Custom headers to set in the request. HTTP
allows repeated headers.
items:
description: HTTPHeader describes a custom header
to be used in HTTP probes
properties:
name:
description: The header field name. This will
be canonicalized upon output, so case-variant
names will be understood as the same header.
type: string
value:
description: The header field value
type: string
required:
- name
- value
type: object
type: array
path:
description: Path to access on the HTTP server.
type: string
port:
anyOf:
- type: integer
- type: string
description: Name or number of the port to access on
the container. Number must be in the range 1 to 65535.
Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
scheme:
description: Scheme to use for connecting to the host.
Defaults to HTTP.
type: string
required:
- port
type: object
initialDelaySeconds:
description: 'Number of seconds after the container has
started before liveness probes are initiated. More info:
https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes'
format: int32
type: integer
periodSeconds:
description: How often (in seconds) to perform the probe.
Default to 10 seconds. Minimum value is 1.
format: int32
type: integer
successThreshold:
description: Minimum consecutive successes for the probe
to be considered successful after having failed. Defaults
to 1. Must be 1 for liveness and startup. Minimum value
is 1.
format: int32
type: integer
tcpSocket:
description: TCPSocket specifies an action involving a TCP
port.
properties:
host:
description: 'Optional: Host name to connect to, defaults
to the pod IP.'
type: string
port:
anyOf:
- type: integer
- type: string
description: Number or name of the port to access on
the container. Number must be in the range 1 to 65535.
Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
required:
- port
type: object
terminationGracePeriodSeconds:
description: Optional duration in seconds the pod needs
to terminate gracefully upon probe failure. The grace
period is the duration in seconds after the processes
running in the pod are sent a termination signal and the
time when the processes are forcibly halted with a kill
signal. Set this value longer than the expected cleanup
time for your process. If this value is nil, the pod's
terminationGracePeriodSeconds will be used. Otherwise,
this value overrides the value provided by the pod spec.
Value must be non-negative integer. The value zero indicates
stop immediately via the kill signal (no opportunity to
shut down). This is a beta field and requires enabling
ProbeTerminationGracePeriod feature gate. Minimum value
is 1. spec.terminationGracePeriodSeconds is used if unset.
format: int64
type: integer
timeoutSeconds:
description: 'Number of seconds after which the probe times
out. Defaults to 1 second. Minimum value is 1. More info:
https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes'
format: int32
type: integer
type: object
name:
description: Name of the container specified as a DNS_LABEL.
Each container in a pod must have a unique name (DNS_LABEL).
Cannot be updated.
type: string
ports:
description: List of ports to expose from the container. Not
specifying a port here DOES NOT prevent that port from being
exposed. Any port which is listening on the default "0.0.0.0"
address inside a container will be accessible from the network.
Modifying this array with strategic merge patch may corrupt
the data. For more information See https://github.com/kubernetes/kubernetes/issues/108255.
Cannot be updated.
items:
description: ContainerPort represents a network port in a
single container.
properties:
containerPort:
description: Number of port to expose on the pod's IP
address. This must be a valid port number, 0 < x < 65536.
format: int32
type: integer
hostIP:
description: What host IP to bind the external port to.
type: string
hostPort:
description: Number of port to expose on the host. If
specified, this must be a valid port number, 0 < x <
65536. If HostNetwork is specified, this must match
ContainerPort. Most containers do not need this.
format: int32
type: integer
name:
description: If specified, this must be an IANA_SVC_NAME
and unique within the pod. Each named port in a pod
must have a unique name. Name for the port that can
be referred to by services.
type: string
protocol:
default: TCP
description: Protocol for port. Must be UDP, TCP, or SCTP.
Defaults to "TCP".
type: string
required:
- containerPort
type: object
type: array
x-kubernetes-list-map-keys:
- containerPort
- protocol
x-kubernetes-list-type: map
readinessProbe:
description: 'Periodic probe of container service readiness.
Container will be removed from service endpoints if the probe
fails. Cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes'
properties:
exec:
description: Exec specifies the action to take.
properties:
command:
description: Command is the command line to execute
inside the container, the working directory for the
command is root ('/') in the container's filesystem.
The command is simply exec'd, it is not run inside
a shell, so traditional shell instructions ('|', etc)
won't work. To use a shell, you need to explicitly
call out to that shell. Exit status of 0 is treated
as live/healthy and non-zero is unhealthy.
items:
type: string
type: array
type: object
failureThreshold:
description: Minimum consecutive failures for the probe
to be considered failed after having succeeded. Defaults
to 3. Minimum value is 1.
format: int32
type: integer
grpc:
description: GRPC specifies an action involving a GRPC port.
properties:
port:
description: Port number of the gRPC service. Number
must be in the range 1 to 65535.
format: int32
type: integer
service:
description: "Service is the name of the service to
place in the gRPC HealthCheckRequest (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md).
\n If this is not specified, the default behavior
is defined by gRPC."
type: string
required:
- port
type: object
httpGet:
description: HTTPGet specifies the http request to perform.
properties:
host:
description: Host name to connect to, defaults to the
pod IP. You probably want to set "Host" in httpHeaders
instead.
type: string
httpHeaders:
description: Custom headers to set in the request. HTTP
allows repeated headers.
items:
description: HTTPHeader describes a custom header
to be used in HTTP probes
properties:
name:
description: The header field name. This will
be canonicalized upon output, so case-variant
names will be understood as the same header.
type: string
value:
description: The header field value
type: string
required:
- name
- value
type: object
type: array
path:
description: Path to access on the HTTP server.
type: string
port:
anyOf:
- type: integer
- type: string
description: Name or number of the port to access on
the container. Number must be in the range 1 to 65535.
Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
scheme:
description: Scheme to use for connecting to the host.
Defaults to HTTP.
type: string
required:
- port
type: object
initialDelaySeconds:
description: 'Number of seconds after the container has
started before liveness probes are initiated. More info:
https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes'
format: int32
type: integer
periodSeconds:
description: How often (in seconds) to perform the probe.
Default to 10 seconds. Minimum value is 1.
format: int32
type: integer
successThreshold:
description: Minimum consecutive successes for the probe
to be considered successful after having failed. Defaults
to 1. Must be 1 for liveness and startup. Minimum value
is 1.
format: int32
type: integer
tcpSocket:
description: TCPSocket specifies an action involving a TCP
port.
properties:
host:
description: 'Optional: Host name to connect to, defaults
to the pod IP.'
type: string
port:
anyOf:
- type: integer
- type: string
description: Number or name of the port to access on
the container. Number must be in the range 1 to 65535.
Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
required:
- port
type: object
terminationGracePeriodSeconds:
description: Optional duration in seconds the pod needs
to terminate gracefully upon probe failure. The grace
period is the duration in seconds after the processes
running in the pod are sent a termination signal and the
time when the processes are forcibly halted with a kill
signal. Set this value longer than the expected cleanup
time for your process. If this value is nil, the pod's
terminationGracePeriodSeconds will be used. Otherwise,
this value overrides the value provided by the pod spec.
Value must be non-negative integer. The value zero indicates
stop immediately via the kill signal (no opportunity to
shut down). This is a beta field and requires enabling
ProbeTerminationGracePeriod feature gate. Minimum value
is 1. spec.terminationGracePeriodSeconds is used if unset.
format: int64
type: integer
timeoutSeconds:
description: 'Number of seconds after which the probe times
out. Defaults to 1 second. Minimum value is 1. More info:
https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes'
format: int32
type: integer
type: object
resizePolicy:
description: Resources resize policy for the container.
items:
description: ContainerResizePolicy represents resource resize
policy for the container.
properties:
resourceName:
description: 'Name of the resource to which this resource
resize policy applies. Supported values: cpu, memory.'
type: string
restartPolicy:
description: Restart policy to apply when specified resource
is resized. If not specified, it defaults to NotRequired.
type: string
required:
- resourceName
- restartPolicy
type: object
type: array
x-kubernetes-list-type: atomic
resources:
description: 'Compute Resources required by this container.
Cannot be updated. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/'
properties:
claims:
description: "Claims lists the names of resources, defined
in spec.resourceClaims, that are used by this container.
\n This is an alpha field and requires enabling the DynamicResourceAllocation
feature gate. \n This field is immutable. It can only
be set for containers."
items:
description: ResourceClaim references one entry in PodSpec.ResourceClaims.
properties:
name:
description: Name must match the name of one entry
in pod.spec.resourceClaims of the Pod where this
field is used. It makes that resource available
inside a container.
type: string
required:
- name
type: object
type: array
x-kubernetes-list-map-keys:
- name
x-kubernetes-list-type: map
limits:
additionalProperties:
anyOf:
- type: integer
- type: string
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
description: 'Limits describes the maximum amount of compute
resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/'
type: object
requests:
additionalProperties:
anyOf:
- type: integer
- type: string
pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
x-kubernetes-int-or-string: true
description: 'Requests describes the minimum amount of compute
resources required. If Requests is omitted for a container,
it defaults to Limits if that is explicitly specified,
otherwise to an implementation-defined value. Requests
cannot exceed Limits. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/'
type: object
type: object
restartPolicy:
description: 'RestartPolicy defines the restart behavior of
individual containers in a pod. This field may only be set
for init containers, and the only allowed value is "Always".
For non-init containers or when this field is not specified,
the restart behavior is defined by the Pod''s restart policy
and the container type. Setting the RestartPolicy as "Always"
for the init container will have the following effect: this
init container will be continually restarted on exit until
all regular containers have terminated. Once all regular containers
have completed, all init containers with restartPolicy "Always"
will be shut down. This lifecycle differs from normal init
containers and is often referred to as a "sidecar" container.
Although this init container still starts in the init container
sequence, it does not wait for the container to complete before
proceeding to the next init container. Instead, the next init
container starts immediately after this init container is
started, or after any startupProbe has successfully completed.'
type: string
securityContext:
description: 'SecurityContext defines the security options the
container should be run with. If set, the fields of SecurityContext
override the equivalent fields of PodSecurityContext. More
info: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/'
properties:
allowPrivilegeEscalation:
description: 'AllowPrivilegeEscalation controls whether
a process can gain more privileges than its parent process.
This bool directly controls if the no_new_privs flag will
be set on the container process. AllowPrivilegeEscalation
is true always when the container is: 1) run as Privileged
2) has CAP_SYS_ADMIN Note that this field cannot be set
when spec.os.name is windows.'
type: boolean
capabilities:
description: The capabilities to add/drop when running containers.
Defaults to the default set of capabilities granted by
the container runtime. Note that this field cannot be
set when spec.os.name is windows.
properties:
add:
description: Added capabilities
items:
description: Capability represent POSIX capabilities
type
type: string
type: array
drop:
description: Removed capabilities
items:
description: Capability represent POSIX capabilities
type
type: string
type: array
type: object
privileged:
description: Run container in privileged mode. Processes
in privileged containers are essentially equivalent to
root on the host. Defaults to false. Note that this field
cannot be set when spec.os.name is windows.
type: boolean
procMount:
description: procMount denotes the type of proc mount to
use for the containers. The default is DefaultProcMount
which uses the container runtime defaults for readonly
paths and masked paths. This requires the ProcMountType
feature flag to be enabled. Note that this field cannot
be set when spec.os.name is windows.
type: string
readOnlyRootFilesystem:
description: Whether this container has a read-only root
filesystem. Default is false. Note that this field cannot
be set when spec.os.name is windows.
type: boolean
runAsGroup:
description: The GID to run the entrypoint of the container
process. Uses runtime default if unset. May also be set
in PodSecurityContext. If set in both SecurityContext
and PodSecurityContext, the value specified in SecurityContext
takes precedence. Note that this field cannot be set when
spec.os.name is windows.
format: int64
type: integer
runAsNonRoot:
description: Indicates that the container must run as a
non-root user. If true, the Kubelet will validate the
image at runtime to ensure that it does not run as UID
0 (root) and fail to start the container if it does. If
unset or false, no such validation will be performed.
May also be set in PodSecurityContext. If set in both
SecurityContext and PodSecurityContext, the value specified
in SecurityContext takes precedence.
type: boolean
runAsUser:
description: The UID to run the entrypoint of the container
process. Defaults to user specified in image metadata
if unspecified. May also be set in PodSecurityContext. If
set in both SecurityContext and PodSecurityContext, the
value specified in SecurityContext takes precedence. Note
that this field cannot be set when spec.os.name is windows.
format: int64
type: integer
seLinuxOptions:
description: The SELinux context to be applied to the container.
If unspecified, the container runtime will allocate a
random SELinux context for each container. May also be
set in PodSecurityContext. If set in both SecurityContext
and PodSecurityContext, the value specified in SecurityContext
takes precedence. Note that this field cannot be set when
spec.os.name is windows.
properties:
level:
description: Level is SELinux level label that applies
to the container.
type: string
role:
description: Role is a SELinux role label that applies
to the container.
type: string
type:
description: Type is a SELinux type label that applies
to the container.
type: string
user:
description: User is a SELinux user label that applies
to the container.
type: string
type: object
seccompProfile:
description: The seccomp options to use by this container.
If seccomp options are provided at both the pod & container
level, the container options override the pod options.
Note that this field cannot be set when spec.os.name is
windows.
properties:
localhostProfile:
description: localhostProfile indicates a profile defined
in a file on the node should be used. The profile
must be preconfigured on the node to work. Must be
a descending path, relative to the kubelet's configured
seccomp profile location. Must be set if type is "Localhost".
Must NOT be set for any other type.
type: string
type:
description: "type indicates which kind of seccomp profile
will be applied. Valid options are: \n Localhost -
a profile defined in a file on the node should be
used. RuntimeDefault - the container runtime default
profile should be used. Unconfined - no profile should
be applied."
type: string
required:
- type
type: object
windowsOptions:
description: The Windows specific settings applied to all
containers. If unspecified, the options from the PodSecurityContext
will be used. If set in both SecurityContext and PodSecurityContext,
the value specified in SecurityContext takes precedence.
Note that this field cannot be set when spec.os.name is
linux.
properties:
gmsaCredentialSpec:
description: GMSACredentialSpec is where the GMSA admission
webhook (https://github.com/kubernetes-sigs/windows-gmsa)
inlines the contents of the GMSA credential spec named
by the GMSACredentialSpecName field.
type: string
gmsaCredentialSpecName:
description: GMSACredentialSpecName is the name of the
GMSA credential spec to use.
type: string
hostProcess:
description: HostProcess determines if a container should
be run as a 'Host Process' container. All of a Pod's
containers must have the same effective HostProcess
value (it is not allowed to have a mix of HostProcess
containers and non-HostProcess containers). In addition,
if HostProcess is true then HostNetwork must also
be set to true.
type: boolean
runAsUserName:
description: The UserName in Windows to run the entrypoint
of the container process. Defaults to the user specified
in image metadata if unspecified. May also be set
in PodSecurityContext. If set in both SecurityContext
and PodSecurityContext, the value specified in SecurityContext
takes precedence.
type: string
type: object
type: object
startupProbe:
description: 'StartupProbe indicates that the Pod has successfully
initialized. If specified, no other probes are executed until
this completes successfully. If this probe fails, the Pod
will be restarted, just as if the livenessProbe failed. This
can be used to provide different probe parameters at the beginning
of a Pod''s lifecycle, when it might take a long time to load
data or warm a cache, than during steady-state operation.
This cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes'
properties:
exec:
description: Exec specifies the action to take.
properties:
command:
description: Command is the command line to execute
inside the container, the working directory for the
command is root ('/') in the container's filesystem.
The command is simply exec'd, it is not run inside
a shell, so traditional shell instructions ('|', etc)
won't work. To use a shell, you need to explicitly
call out to that shell. Exit status of 0 is treated
as live/healthy and non-zero is unhealthy.
items:
type: string
type: array
type: object
failureThreshold:
description: Minimum consecutive failures for the probe
to be considered failed after having succeeded. Defaults
to 3. Minimum value is 1.
format: int32
type: integer
grpc:
description: GRPC specifies an action involving a GRPC port.
properties:
port:
description: Port number of the gRPC service. Number
must be in the range 1 to 65535.
format: int32
type: integer
service:
description: "Service is the name of the service to
place in the gRPC HealthCheckRequest (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md).
\n If this is not specified, the default behavior
is defined by gRPC."
type: string
required:
- port
type: object
httpGet:
description: HTTPGet specifies the http request to perform.
properties:
host:
description: Host name to connect to, defaults to the
pod IP. You probably want to set "Host" in httpHeaders
instead.
type: string
httpHeaders:
description: Custom headers to set in the request. HTTP
allows repeated headers.
items:
description: HTTPHeader describes a custom header
to be used in HTTP probes
properties:
name:
description: The header field name. This will
be canonicalized upon output, so case-variant
names will be understood as the same header.
type: string
value:
description: The header field value
type: string
required:
- name
- value
type: object
type: array
path:
description: Path to access on the HTTP server.
type: string
port:
anyOf:
- type: integer
- type: string
description: Name or number of the port to access on
the container. Number must be in the range 1 to 65535.
Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
scheme:
description: Scheme to use for connecting to the host.
Defaults to HTTP.
type: string
required:
- port
type: object
initialDelaySeconds:
description: 'Number of seconds after the container has
started before liveness probes are initiated. More info:
https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes'
format: int32
type: integer
periodSeconds:
description: How often (in seconds) to perform the probe.
Default to 10 seconds. Minimum value is 1.
format: int32
type: integer
successThreshold:
description: Minimum consecutive successes for the probe
to be considered successful after having failed. Defaults
to 1. Must be 1 for liveness and startup. Minimum value
is 1.
format: int32
type: integer
tcpSocket:
description: TCPSocket specifies an action involving a TCP
port.
properties:
host:
description: 'Optional: Host name to connect to, defaults
to the pod IP.'
type: string
port:
anyOf:
- type: integer
- type: string
description: Number or name of the port to access on
the container. Number must be in the range 1 to 65535.
Name must be an IANA_SVC_NAME.
x-kubernetes-int-or-string: true
required:
- port
type: object
terminationGracePeriodSeconds:
description: Optional duration in seconds the pod needs
to terminate gracefully upon probe failure. The grace
period is the duration in seconds after the processes
running in the pod are sent a termination signal and the
time when the processes are forcibly halted with a kill
signal. Set this value longer than the expected cleanup
time for your process. If this value is nil, the pod's
terminationGracePeriodSeconds will be used. Otherwise,
this value overrides the value provided by the pod spec.
Value must be non-negative integer. The value zero indicates
stop immediately via the kill signal (no opportunity to
shut down). This is a beta field and requires enabling
ProbeTerminationGracePeriod feature gate. Minimum value
is 1. spec.terminationGracePeriodSeconds is used if unset.
format: int64
type: integer
timeoutSeconds:
description: 'Number of seconds after which the probe times
out. Defaults to 1 second. Minimum value is 1. More info:
https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes'
format: int32
type: integer
type: object
stdin:
description: Whether this container should allocate a buffer
for stdin in the container runtime. If this is not set, reads
from stdin in the container will always result in EOF. Default
is false.
type: boolean
stdinOnce:
description: Whether the container runtime should close the
stdin channel after it has been opened by a single attach.
When stdin is true the stdin stream will remain open across
multiple attach sessions. If stdinOnce is set to true, stdin
is opened on container start, is empty until the first client
attaches to stdin, and then remains open and accepts data
until the client disconnects, at which time stdin is closed
and remains closed until the container is restarted. If this
flag is false, a container processes that reads from stdin
will never receive an EOF. Default is false
type: boolean
terminationMessagePath:
description: 'Optional: Path at which the file to which the
container''s termination message will be written is mounted
into the container''s filesystem. Message written is intended
to be brief final status, such as an assertion failure message.
Will be truncated by the node if greater than 4096 bytes.
The total message length across all containers will be limited
to 12kb. Defaults to /dev/termination-log. Cannot be updated.'
type: string
terminationMessagePolicy:
description: Indicate how the termination message should be
populated. File will use the contents of terminationMessagePath
to populate the container status message on both success and
failure. FallbackToLogsOnError will use the last chunk of
container log output if the termination message file is empty
and the container exited with an error. The log output is
limited to 2048 bytes or 80 lines, whichever is smaller. Defaults
to File. Cannot be updated.
type: string
tty:
description: Whether this container should allocate a TTY for
itself, also requires 'stdin' to be true. Default is false.
type: boolean
volumeDevices:
description: volumeDevices is the list of block devices to be
used by the container.
items:
description: volumeDevice describes a mapping of a raw block
device within a container.
properties:
devicePath:
description: devicePath is the path inside of the container
that the device will be mapped to.
type: string
name:
description: name must match the name of a persistentVolumeClaim
in the pod
type: string
required:
- devicePath
- name
type: object
type: array
volumeMounts:
description: Pod volumes to mount into the container's filesystem.
Cannot be updated.
items:
description: VolumeMount describes a mounting of a Volume
within a container.
properties:
mountPath:
description: Path within the container at which the volume
should be mounted. Must not contain ':'.
type: string
mountPropagation:
description: mountPropagation determines how mounts are
propagated from the host to container and the other
way around. When not set, MountPropagationNone is used.
This field is beta in 1.10.
type: string
name:
description: This must match the Name of a Volume.
type: string
readOnly:
description: Mounted read-only if true, read-write otherwise
(false or unspecified). Defaults to false.
type: boolean
subPath:
description: Path within the volume from which the container's
volume should be mounted. Defaults to "" (volume's root).
type: string
subPathExpr:
description: Expanded path within the volume from which
the container's volume should be mounted. Behaves similarly
to SubPath but environment variable references $(VAR_NAME)
are expanded using the container's environment. Defaults
to "" (volume's root). SubPathExpr and SubPath are mutually
exclusive.
type: string
required:
- mountPath
- name
type: object
type: array
workingDir:
description: Container's working directory. If not specified,
the container runtime's default will be used, which might
be configured in the container image. Cannot be updated.
type: string
required:
- name
type: object
type: array
type: object
status:
description: SidecarStatus specifies the observed state of Sidecar.
properties:
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as information about
the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
type: object
type: object
served: true
storage: true
subresources:
status: {}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.13.0
labels:
alloydb-omni: "true"
name: switchovers.alloydbomni.dbadmin.goog
spec:
group: alloydbomni.dbadmin.goog
names:
kind: Switchover
listKind: SwitchoverList
plural: switchovers
singular: switchover
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .status.state
name: state
type: string
- jsonPath: .status.internal.phase
name: phase
type: string
- jsonPath: .status.internal.newPrimary
name: newPrimary
type: string
- jsonPath: .status.internal.oldPrimary
name: oldPrimary
type: string
name: v1
schema:
openAPIV3Schema:
description: Switchover represents the parameters and status of a single switchover
operation.
properties:
apiVersion:
description: 'APIVersion defines the versioned schema of this representation
of an object. Servers must convert recognized schemas to the latest
internal value, and can reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
type: string
kind:
description: 'Kind is a string value representing the REST resource this
object represents. Servers can infer this from the endpoint that the client
submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
type: string
metadata:
type: object
spec:
description: SwitchoverSpec defines the desired state of Switchover.
properties:
dbclusterRef:
description: DBClusterRef is the DBCluster name to initiate a switchover.
The `Switchover` object must be created in the same namespace as
the DBCluster that it references. This field is required for Switchover.
type: string
newPrimary:
description: NewPrimary is the standby instance to switch with the
current primary.
type: string
newPrimaryInstance:
description: 'NewPrimaryInstance is the standby instance to switch
with the current primary. Deprecated: Please use NewPrimary field
instead.'
type: string
primaryHost:
description: PrimaryHost is the IP always point to the primary instance.
type: string
type: object
status:
description: SwitchoverStatus defines the observed state of Switchover.
properties:
conditions:
description: Conditions represents the latest available observations
of the Entity's current state.
items:
description: "Condition contains details for one aspect of the current
state of this API Resource. This struct is intended for direct
use as an array at the field path .status.conditions. For example,
\n type FooStatus struct{ // Represents the observations of a
foo's current state. // Known .status.conditions.type are: \"Available\",
\"Progressing\", and \"Degraded\" // +patchMergeKey=type // +patchStrategy=merge
// +listType=map // +listMapKey=type Conditions []metav1.Condition
`json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\"
protobuf:\"bytes,1,rep,name=conditions\"` \n // other fields }"
properties:
lastTransitionTime:
description: lastTransitionTime is the last time the condition
transitioned from one status to another, which occurs when
the underlying condition changed. If the time when the underlying
condition changed is unknown, you can use the time when the API
field changed.
format: date-time
type: string
message:
description: message is a human readable message indicating
details about the transition. This can be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: observedGeneration represents the .metadata.generation
that the condition was set based upon. For instance, if .metadata.generation
is currently 12, but the .status.conditions[x].observedGeneration
is 9, the condition is out of date with respect to the current
state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: reason contains a programmatic identifier indicating
the reason for the condition's last transition. Producers
of specific condition types can define expected values and
meanings for this field, and whether the values are considered
a guaranteed API. The value must be a CamelCase string.
This field might not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: type of condition in CamelCase or in foo.example.com/CamelCase.
Many .condition.type values are consistent across resources
like Available, but because arbitrary conditions can be useful
(see .node.status.conditions), the ability to deconflict is
important. The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt).
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
x-kubernetes-list-map-keys:
- type
x-kubernetes-list-type: map
createTime:
description: CreateTime is the time that the internal switchover workflow
mechanism was created.
format: date-time
type: string
criticalIncidents:
description: CriticalIncidents is a flat list of all active Critical
Incidents.
items:
description: CriticalIncident contains all information about an
ongoing critical incident.
properties:
code:
description: Code is the error code of this particular error.
Error codes are DBSE+numeric strings, like "DBSE1012".
type: string
createTime:
description: CreateTime is the timestamp when this Incident
was created at the origin.
format: date-time
type: string
message:
description: Message describes the incident or error that occurred.
type: string
messageTemplateParams:
additionalProperties:
type: string
description: MessageTemplateParams contains key-value pairs
necessary for generating a user-friendly data-driven version
of Message in the user interface.
type: object
resource:
description: Resource contains information about the Database
Service component that reported the incident, as well as
information about the Kubernetes resource.
properties:
component:
description: Component is an internal identifier of the
Database Service subsystem that reported the incident.
type: string
location:
description: Location
properties:
cluster:
description: Cluster is the name of the cluster of the
affected Kubernetes resource.
type: string
group:
description: Group is the Group name of the Kubernetes resource.
type: string
kind:
description: Kind is the Kind of the Kubernetes resource.
type: string
name:
description: Name is the name of the affected Kubernetes resource.
type: string
namespace:
description: Namespace is the namespace of the affected
Kubernetes resource.
type: string
version:
description: Group is the Version of the Kubernetes resource.
type: string
type: object
required:
- component
type: object
stackTrace:
description: StackTrace contains an unstructured list of messages
from the stack trace.
items:
description: CriticalIncidentStackTraceMessage contains stack
trace information available for the incident.
properties:
component:
description: Component is the name of a Database Service
component that logged the message.
type: string
message:
description: Logged message.
type: string
type: object
type: array
transientUntil:
description: TransientUntil, if present, indicates that the issue
must be considered transient until the specified time.
format: date-time
type: string
required:
- code
- createTime
- resource
type: object
type: array
endTime:
description: EndTime is the time switchover reached its final state.
format: date-time
type: string
internal:
description: Internal is used by the system controllers. Do not rely
on the information in this section.
properties:
newPrimary:
description: NewPrimary is the instance that you are attempting
to switchover to.
type: string
oldPrimary:
description: OldPrimary is the instance that was the primary at
the start of the switchover.
type: string
phase:
description: Phase is used to keep track of the current state
of the switchover
enum:
- UpdateDbcluster
- StopPrimary
- PromoteStandby
- ValidateNewPrimary
- UpdateOldPrimaryResources
- UpdateNewPrimaryResources
- UpdateOldPrimaryConfigs
- Complete
- SyncOldPrimary
- StartOldPrimary
- PreSuccess
- RepointStandbys
- RollbackPrimary
- RollbackStandbys
type: string
required:
- newPrimary
- oldPrimary
type: object
observedGeneration:
description: 'Internal: The generation observed by the controller.'
format: int64
type: integer
reconciled:
description: 'Internal: Whether the resource was reconciled by the
controller.'
type: boolean
startTime:
description: StartTime is the time that the switchover operation started.
format: date-time
type: string
state:
description: State is the current state of the switchover operation.
The values are `InProgress`, `Success`, `Failed_RollbackInProgress`,
`Failed_RollbackSuccess`, and `Failed_RollbackFailed`. `InProgress` means
the switchover is still in progress. `Success` means that the switchover
has completed. `Failed_RollbackInProgress` means that the operator
was unable to promote the new primary instance, and is attempting
to restart the old primary instance. `Failed_RollbackSuccess` means
that the operator was unable to promote the new primary instance,
and that it successfully restarted the old primary instance. `Failed_RollbackFailed`
means that the operator was unable to promote the new primary instance,
and that the operator wasn't able to restart the old primary instance. The DBCluster
might need to be manually repaired.
enum:
- InProgress
- Success
- Failed_RollbackInProgress
- Failed_RollbackSuccess
- Failed_RollbackFailed
type: string
type: object
type: object
served: true
storage: true
subresources:
status: {}