Redpanda Operator CRD Reference

cluster.redpanda.com/v1alpha1

Package v1alpha1 contains API Schema definitions for the redpanda v1alpha1 API group

Resource Types

Admin

Admin is a top level field of the values file

Appears In:
Field Description

external object (keys:string, values:ExternalListener)

port integer

Auth

Auth is a top level field of the values file

Appears In:
Field Description

sasl SASL

Budget

Budget is a top level field of the values file

Appears In:
Field Description

maxUnavailable integer

CPU

Appears In:
Field Description

cores Quantity

overprovisioned boolean

Certificate

Appears In:
Field Description

issuerRef IssuerRef

secretRef SecretRef

duration Duration

caEnabled boolean

ChartRef

Appears In:
Field Description

chartName string

ChartName is the chart to use

chartVersion string

ChartVersion defines the helm chart version to use

helmRepositoryName string

HelmRepositoryName defines the repository to use, defaults to redpanda if not defined

timeout Duration

Timeout is the time to wait for any individual Kubernetes operation (like Jobs for hooks) during the performance of a Helm action. Defaults to '15m0s'.

upgrade HelmUpgrade

Upgrade contains the details for handling upgrades including failures

Config

Config is a top level field of the values file

Appears In:
Field Description

cluster RawExtension

tunable RawExtension

ConfigWatcher

Appears In:
Field Description

enabled boolean

extraVolumeMounts string

SecurityContext SecurityContext

Configurator

Appears In:
Field Description

extraVolumeMounts string

ConsoleCreateObj

Appears In:
Field Description

create boolean

Container

Appears In:
Field Description

max Quantity

min Quantity

External

External is a top level field of the values file

Appears In:
Field Description

addresses string array

domain string

enabled boolean

type string

externalDNS ExternalDNS

ExternalDNS

Appears In:
Field Description

enabled boolean

ExternalListener

Field Description

port integer

advertisedPorts integer array

HTTP

HTTP is a top level field of the values file`

Appears In:
Field Description

authenticationMethod string

enabled boolean

external object (keys:string, values:ExternalListener)

kafkaEndpoint string

port integer

HelmUpgrade

HelmUpgrade represents the configurations upgrading helm releases

Appears In:
Field Description

remediation UpgradeRemediation

force boolean

preserveValues boolean

cleanupOnFail boolean

InitContainerImage

Appears In:
Field Description

repository string

tag string

InitContainers

Appears In:
Field Description

configurator Configurator

extraInitContainers string

setDataDirOwnership SetDataDirOwnership

setTieredStorageCacheDirOwnership SetTieredStorageCacheDirOwnership

tuning Tuning

IssuerRef

Appears In:
Field Description

name string

kind string

Kafka

Kafka is a top level field of the values file

Appears In:
Field Description

authenticationMethod string

external object (keys:string, values:ExternalListener)

port integer

LicenseSecretRef

LicenseSecretRef is a top level field of the values file

Appears In:
Field Description

secret_key string

secret_name string

ListenerTLS

ListenerTLS is a top level field of the values file

Field Description

cert string

enabled boolean

requireClientAuth boolean

Listeners

Listeners is a top level field of the values file

Appears In:
Field Description

admin Admin

http HTTP

kafka Kafka

rpc RPC

schemaRegistry SchemaRegistry

LivenessProbe

LivenessProbe is a top level field of the values file

Appears In:
Field Description

failureThreshold integer

initialDelaySeconds integer

periodSeconds integer

Logging

Logging is a top level field of the values file

Appears In:
Field Description

logLevel string

usageStats UsageStats

Memory

Appears In:
Field Description

container Container

enable_memory_locking boolean

redpanda RedpandaMemory

Monitoring

Appears In:
Field Description

enabled boolean

commonLabels object (keys:string, values:string)

scrapeInterval string

PersistentVolume

PersistentVolume is a top level field of the values file

Appears In:
Field Description

annotations object (keys:string, values:string)

enabled boolean

labels object (keys:string, values:string)

size string

storageClass string

PostInstallJob

PostInstallJob is a top level field of the values file

Appears In:
Field Description

annotations object (keys:string, values:string)

enabled boolean

labels object (keys:string, values:string)

PostUpgradeJob

PostUpgradeJob is a top level field of the values file

Appears In:
Field Description

annotations object (keys:string, values:string)

enabled boolean

labels object (keys:string, values:string)

extraEnv EnvVar array

extraEnvFrom EnvFromSource array

RBAC

Appears In:
Field Description

annotations object (keys:string, values:string)

enabled boolean

RPC

RPC is a top level field of the values file

Appears In:
Field Description

port integer

RackAwareness

RackAwareness is a top level field of the values file

Appears In:
Field Description

enabled boolean

nodeAnnotation string

ReadinessProbe

ReadinessProbe is a top level field of the values file

Appears In:
Field Description

failureThreshold integer

initialDelaySeconds integer

periodSeconds integer

Redpanda

Redpanda is the Schema for the redpanda API

Appears In:
Field Description

apiVersion string

cluster.redpanda.com/v1alpha1

kind string

Redpanda

kind string

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint 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

apiVersion string

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

metadata ObjectMeta

Refer to Kubernetes API documentation for fields of metadata.

RedpandaClusterSpec

RedpandaClusterSpec defines the desired state of Redpanda Cluster

These fields are used to configure the Redpanda Helm chart. For descriptions and default values, see Redpanda Helm Chart Specification.

Appears In:
Field Description

nameOverride string

NameOverride is the override to give your redpanda release

fullNameOverride string

FullNameOverride is the override to give your redpanda release

clusterDomain string

ClusterDomain is the override to give your redpanda release

commonLabels object (keys:string, values:string)

CommonLabels is the override to give your redpanda release

nodeSelector object (keys:string, values:string)

NodeSelector is the override to give your redpanda release

tolerations Toleration array

Tolerations is the override to give your redpanda release

Image defines the container image to use for the redpanda cluster

imagePullSecrets LocalObjectReference array

license_key string

license_secret_ref LicenseSecretRef

rackAwareness RackAwareness

console RedpandaConsole

auth Auth

tls TLS

external External

logging Logging

resources Resources

storage Storage

post_install_job PostInstallJob

post_upgrade_job PostUpgradeJob

statefulset Statefulset

tuning Tuning

listeners Listeners

config Config

rbac RBAC

serviceAccount ServiceAccount

monitoring Monitoring

RedpandaConsole

Appears In:
Field Description

enabled boolean

configMap ConsoleCreateObj

deployment ConsoleCreateObj

config RawExtension

RedpandaImage

RedpandaImage is a top level field of the values file

Appears In:
Field Description

repository string

tag string

pullPolicy string

RedpandaList

RedpandaList contains a list of Redpanda

Field Description

apiVersion string

cluster.redpanda.com/v1alpha1

kind string

RedpandaList

kind string

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint 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

apiVersion string

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

metadata ListMeta

Refer to Kubernetes API documentation for fields of metadata.

items Redpanda array

RedpandaMemory

Appears In:
Field Description

memory Quantity

reserveMemory Quantity

RedpandaSpec

RedpandaSpec defines the desired state of Redpanda

Appears In:
Field Description

chartRef ChartRef

ChartRef defines chart details including repository

helmRepositoryName string

HelmRepositoryName defines the repository to use, defaults to redpanda if not defined

clusterSpec RedpandaClusterSpec

ClusterSpec defines the values to use in the cluster

RedpandaStatus

RedpandaStatus defines the observed state of Redpanda

Appears In:
Field Description

observedGeneration integer

ObservedGeneration is the last observed generation.

lastHandledReconcileAt string

LastHandledReconcileAt holds the value of the most recent reconcile request value, so a change of the annotation value can be detected.

conditions Condition array

Conditions holds the conditions for the Redpanda.

lastAppliedRevision string

LastAppliedRevision is the revision of the last successfully applied source.

lastAttemptedRevision string

LastAttemptedRevision is the revision of the last reconciliation attempt.

helmRelease string

helmReleaseReady boolean

helmRepository string

helmRepositoryReady boolean

upgradeFailures integer

failures integer

Failures is the reconciliation failure count against the latest desired state. It is reset after a successful reconciliation.

installFailures integer

Resources

Appears In:
Field Description

cpu CPU

memory Memory

SASL

SASL is a top level field of the values file

Appears In:
Field Description

enabled boolean

mechanism string

secretRef string

users UsersItems array

SchemaRegistry

SchemaRegistry is a top level field of the values file

Appears In:
Field Description

authenticationMethod string

enabled boolean

external object (keys:string, values:ExternalListener)

kafkaEndpoint string

port integer

SecretRef

Appears In:
Field Description

name string

ServiceAccount

Appears In:
Field Description

annotations object (keys:string, values:string)

create boolean

name string

SetDataDirOwnership

Appears In:
Field Description

enabled boolean

extraVolumeMounts string

SetTieredStorageCacheDirOwnership

Appears In:
Field Description

extraVolumeMounts string

SideCarObj

SideCarObj represents generic sidecar object. This is a placeholder for now as it may each sidecar entry may require more specific impl.

Appears In:
Field Description

enabled boolean

SecurityContext SecurityContext

SideCars

SideCars is a field that stores sidecars in the statefulset

Appears In:
Field Description

configWatcher ConfigWatcher

rpkStatus SideCarObj

StartupProbe

StartupProbe is a top level field of the values file

Appears In:
Field Description

failureThreshold integer

initialDelaySeconds integer

periodSeconds integer

Statefulset

Statefulset is a top level field of the values file

Appears In:
Field Description

additionalRedpandaCmdFlags string array

annotations object (keys:string, values:string)

budget Budget

extraVolumeMounts string

extraVolumes string

initContainerImage InitContainerImage

initContainers InitContainers

livenessProbe LivenessProbe

nodeSelector object (keys:string, values:string)

podAffinity PodAffinity

podAntiAffinity PodAntiAffinity

priorityClassName string

readinessProbe ReadinessProbe

replicas integer

securityContext SecurityContext

sideCars SideCars

skipChown boolean

startupProbe StartupProbe

tolerations Toleration array

topologySpreadConstraints TopologySpreadConstraints

updateStrategy UpdateStrategy

terminationGracePeriodSeconds integer

Storage

Storage is a top level field of the values file

Appears In:
Field Description

hostPath string

persistentVolume PersistentVolume

tieredConfig TieredConfig

tieredStorageHostPath string

tieredStoragePersistentVolume TieredStoragePersistentVolume

TLS

TLS is a top level field of the values file

Appears In:
Field Description

certs object (keys:string, values:Certificate)

enabled boolean

TieredConfig

TieredConfig is a top level field of the values file

Appears In:
Field Description

cloud_storage_api_endpoint string

cloud_storage_api_endpoint_port integer

cloud_storage_bucket string

cloud_storage_cache_check_interval integer

cloud_storage_cache_directory string

cloud_storage_cache_size integer

cloud_storage_credentials_source string

cloud_storage_disable_tls boolean

cloud_storage_enable_remote_read boolean

cloud_storage_enable_remote_write boolean

cloud_storage_initial_backoff_ms integer

cloud_storage_manifest_upload_timeout_ms integer

cloud_storage_max_connection_idle_time_ms integer

cloud_storage_max_connections integer

cloud_storage_reconciliation_interval_ms integer

cloud_storage_region string

cloud_storage_segment_max_upload_interval_sec integer

cloud_storage_segment_upload_timeout_ms integer

cloud_storage_trust_file string

cloud_storage_upload_ctrl_d_coeff integer

cloud_storage_upload_ctrl_max_shares integer

cloud_storage_upload_ctrl_min_shares integer

cloud_storage_upload_ctrl_p_coeff integer

cloud_storage_upload_ctrl_update_interval_ms integer

TieredStoragePersistentVolume

TieredStoragePersistentVolume is a top level field of the values file

Appears In:
Field Description

annotations object (keys:string, values:string)

enabled boolean

labels object (keys:string, values:string)

storageClass string

TopologySpreadConstraints

TopologySpreadConstraints is a top level field of the values file

Appears In:
Field Description

maxSkew integer

topologyKey string

whenUnsatisfiable string

Tuning

Tuning is a top level field of the values file

Field Description

extraVolumeMounts string

ballast_file_path string

ballast_file_size string

tune_aio_events boolean

tune_ballast_file boolean

tune_clocksource boolean

well_known_io string

UpdateStrategy

UpdateStrategy is a top level field of the values file

Appears In:
Field Description

type string

UsageStats

Appears In:
Field Description

enabled boolean

organization string

clusterId string

UsersItems

UsersItems is a top level field of the values file

Appears In:
Field Description

mechanism string

name string

password string