Loading

common.k8s.elastic.co/v1

ECK

Package v1 contains API schema definitions for common types used by all resources.

Config represents untyped YAML configuration.

ConfigMapRef is a reference to a config map that exists in the same namespace as the referring resource.

Appears In:
Field Description
configMapName string

ConfigSource references configuration settings.

Field Description
secretName string
SecretName is the name of the secret.

HTTPConfig holds the HTTP layer configuration for resources.

Field Description
service ServiceTemplate
Service defines the template for the associated Kubernetes Service object.
tls TLSOptions
TLS defines options for configuring TLS for HTTP.

KeyToPath defines how to map a key in a Secret object to a filesystem path.

Appears In:
Field Description
key string
Key is the key contained in the secret.
path string
Path is the relative file path to map the key to. Path must not be an absolute file path and must not contain any ".." components.

LocalObjectSelector defines a reference to a Kubernetes object corresponding to an Elastic resource managed by the operator

Appears In:
Field Description
namespace string
Namespace of the Kubernetes object. If empty, defaults to the current namespace.
name string
Name of an existing Kubernetes object corresponding to an Elastic resource managed by ECK.
serviceName string
ServiceName is the name of an existing Kubernetes service which is used to make requests to the referenced object. It has to be in the same namespace as the referenced resource. If left empty, the default HTTP service of the referenced resource is used.

LogsMonitoring holds a list of Elasticsearch clusters which receive logs data from associated resources.

Appears In:
Field Description
elasticsearchRefs ObjectSelector array
ElasticsearchRefs is a reference to a list of monitoring Elasticsearch clusters running in the same Kubernetes cluster. Due to existing limitations, only a single Elasticsearch cluster is currently supported.

MetricsMonitoring holds a list of Elasticsearch clusters which receive monitoring data from associated resources.

Appears In:
Field Description
elasticsearchRefs ObjectSelector array
ElasticsearchRefs is a reference to a list of monitoring Elasticsearch clusters running in the same Kubernetes cluster. Due to existing limitations, only a single Elasticsearch cluster is currently supported.

Monitoring holds references to both the metrics, and logs Elasticsearch clusters for configuring stack monitoring.

Field Description
metrics MetricsMonitoring
Metrics holds references to Elasticsearch clusters which receive monitoring data from this resource.
logs LogsMonitoring
Logs holds references to Elasticsearch clusters which receive log data from an associated resource.

ObjectSelector defines a reference to a Kubernetes object which can be an Elastic resource managed by the operator or a Secret describing an external Elastic resource not managed by the operator.

Field Description
namespace string
Namespace of the Kubernetes object. If empty, defaults to the current namespace.
name string
Name of an existing Kubernetes object corresponding to an Elastic resource managed by ECK.
serviceName string
ServiceName is the name of an existing Kubernetes service which is used to make requests to the referenced object. It has to be in the same namespace as the referenced resource. If left empty, the default HTTP service of the referenced resource is used.
secretName string
SecretName is the name of an existing Kubernetes secret that contains connection information for associating an Elastic resource not managed by the operator. The referenced secret must contain the following: - url: the URL to reach the Elastic resource - username: the username of the user to be authenticated to the Elastic resource - password: the password of the user to be authenticated to the Elastic resource - ca.crt: the CA certificate in PEM format (optional) - api-key: the key to authenticate against the Elastic resource instead of a username and password (supported only for elasticsearchRefs in AgentSpec and in BeatSpec) This field cannot be used in combination with the other fields name, namespace or serviceName.

PodDisruptionBudgetTemplate defines the template for creating a PodDisruptionBudget.

Appears In:
Field Description
metadata ObjectMeta
Refer to Kubernetes API documentation for fields of metadata.
spec PodDisruptionBudgetSpec
Spec is the specification of the PDB.

SecretRef is a reference to a secret that exists in the same namespace.

Field Description
secretName string
SecretName is the name of the secret.

SecretSource defines a data source based on a Kubernetes Secret.

Field Description
secretName string
SecretName is the name of the secret.
entries KeyToPath array
Entries define how to project each key-value pair in the secret to filesystem paths. If not defined, all keys will be projected to similarly named paths in the filesystem. If defined, only the specified keys will be projected to the corresponding paths.

SelfSignedCertificate holds configuration for the self-signed certificate generated by the operator.

Appears In:
Field Description
subjectAltNames SubjectAlternativeName array
SubjectAlternativeNames is a list of SANs to include in the generated HTTP TLS certificate.
disabled boolean
Disabled indicates that the provisioning of the self-signed certifcate should be disabled.

ServiceTemplate defines the template for a Kubernetes Service.

Field Description
metadata ObjectMeta
Refer to Kubernetes API documentation for fields of metadata.
spec ServiceSpec
Spec is the specification of the service.

SubjectAlternativeName represents a SAN entry in a x509 certificate.

Field Description
dns string
DNS is the DNS name of the subject.
ip string
IP is the IP address of the subject.

TLSOptions holds TLS configuration options.

Field Description
selfSignedCertificate SelfSignedCertificate
SelfSignedCertificate allows configuring the self-signed certificate generated by the operator.
certificate SecretRef
Certificate is a reference to a Kubernetes secret that contains the certificate and private key for enabling TLS. The referenced secret should contain the following:

* ca.crt: The certificate authority (optional).
* tls.crt: The certificate (or a chain).
* tls.key: The private key to the first certificate in the certificate chain.