Welkin Apps Config Schema¶
Note
This is auto-generated documentation from a JSON schema that is under construction, this will improve over time.
https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml
This describes the structure of the config for both the service and workload clusters.
Keep in mind that this is evaluated on the merged config, and each config file will contain different properties.
Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
---|---|---|---|---|---|---|---|
Can be instantiated | No | Unknown status | No | Forbidden | Allowed | none | config/schemas/config.yaml |
TYPE:
object
(Welkin Apps Config)
all of
PROPERTIES:
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
global | object |
Required | cannot be null | Welkin Apps Config |
clusterApi | object |
Optional | cannot be null | Welkin Apps Config |
user | object |
Optional | cannot be null | Welkin Apps Config |
hnc | object |
Optional | cannot be null | Welkin Apps Config |
harbor | object |
Optional | cannot be null | Welkin Apps Config |
storageClasses | object |
Optional | cannot be null | Welkin Apps Config |
objectStorage | object |
Optional | cannot be null | Welkin Apps Config |
rookCeph | object |
Optional | cannot be null | Welkin Apps Config |
velero | object |
Optional | cannot be null | Welkin Apps Config |
clusterAdmin | object |
Optional | cannot be null | Welkin Apps Config |
dex | object |
Optional | cannot be null | Welkin Apps Config |
externalTrafficPolicy | object |
Optional | cannot be null | Welkin Apps Config |
falco | object |
Optional | cannot be null | Welkin Apps Config |
gatekeeper | object |
Optional | cannot be null | Welkin Apps Config |
kured | object |
Optional | cannot be null | Welkin Apps Config |
opa | object |
Optional | cannot be null | Welkin Apps Config |
trivy | object |
Optional | cannot be null | Welkin Apps Config |
alerts | object |
Optional | cannot be null | Welkin Apps Config |
grafana | object |
Optional | cannot be null | Welkin Apps Config |
grafanaLabelEnforcer | object |
Optional | cannot be null | Welkin Apps Config |
kubeStateMetrics | object |
Optional | cannot be null | Welkin Apps Config |
metricsServer | object |
Optional | cannot be null | Welkin Apps Config |
openstackMonitoring | object |
Optional | cannot be null | Welkin Apps Config |
prometheus | object |
Optional | cannot be null | Welkin Apps Config |
prometheusOperator | object |
Optional | cannot be null | Welkin Apps Config |
prometheusBlackboxExporter | object |
Optional | cannot be null | Welkin Apps Config |
prometheusNodeExporter | object |
Optional | cannot be null | Welkin Apps Config |
s3Exporter | object |
Optional | cannot be null | Welkin Apps Config |
thanos | object |
Optional | cannot be null | Welkin Apps Config |
wcProbeIngress | object |
Optional | cannot be null | Welkin Apps Config |
welcomingDashboard | object |
Optional | cannot be null | Welkin Apps Config |
fluentd | object |
Optional | cannot be null | Welkin Apps Config |
opensearch | object |
Optional | cannot be null | Welkin Apps Config |
calicoAccountant | object |
Optional | cannot be null | Welkin Apps Config |
calicoFelixMetrics | object |
Optional | cannot be null | Welkin Apps Config |
certmanager | object |
Optional | cannot be null | Welkin Apps Config |
ingressNginx | object |
Optional | cannot be null | Welkin Apps Config |
issuers | object |
Optional | cannot be null | Welkin Apps Config |
networkPolicies | object |
Optional | cannot be null | Welkin Apps Config |
nodeLocalDns | object |
Optional | cannot be null | Welkin Apps Config |
externalDns | object |
Optional | cannot be null | Welkin Apps Config |
tektonPipelines | object |
Optional | cannot be null | Welkin Apps Config |
Additional Properties | object |
Optional | cannot be null | Welkin Apps Config |
global¶
Some common options used in various helm charts.
global
-
is required
-
Type:
object
(Global options) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Global options)
clusterApi¶
Set to true if kubernetes is installed with cluster-api.
clusterApi
-
is optional
-
Type:
object
(ClusterAPI Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(ClusterAPI Config)
user¶
Configuration for Application Developers (users), that use the workload cluster
user
-
is optional
-
Type:
object
(User Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(User Config)
hnc¶
Configuration for Hierarchical Namespace Controller.
Note
hnc
-
is optional
-
Type:
object
(HNC (Hierarchical Namespace Controller) Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(HNC (Hierarchical Namespace Controller) Config)
harbor¶
Configuration options for Harbor.
Harbor is a container registry that deployed for the application developers to use when deploying their applications.
Note
See upstream documentation for reference. All config variables that exists in harbor are not exposed via our config.
harbor
-
is optional
-
Type:
object
(Harbor Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Harbor Config)
storageClasses¶
Configuration options for using block storage in Welkin
storageClasses
-
is optional
-
Type:
object
(Storage Classes Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Storage Classes Config)
objectStorage¶
Configuration options for using object storage in Welkin
This is used for:
- Fluentd audit logs
- Fluentd service cluster logs
- Harbor database backups and registry storage
- OpenSearch workload cluster log snapshots
- Rclone object storage sync source and restore destination
- Thanos metrics storage
- Velero resource backups and volume snapshots
Harbor, Rclone, and Thanos have additional configuration to use Swift.
objectStorage
-
is optional
-
Type:
object
(Object Storage Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Object Storage Config)
rookCeph¶
Configure support for Rook Ceph.
This is deprecated and should be configured via compliantkubernetes-kubespray if used.
rookCeph
-
is optional
-
Type:
object
(Rook Ceph Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Rook Ceph Config)
velero¶
Configure Velero, the backup and snapshot tool for Kubernetes resources and volumes.
This requires that objectStorage
is configured, and will use the bucket or container set in objectStorage.buckets.velero
.
velero
-
is optional
-
Type:
object
(Velero Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Velero Config)
clusterAdmin¶
Configure the cluster admins.
clusterAdmin
-
is optional
-
Type:
object
(Cluster Admin) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Cluster Admin)
dex¶
Configure Dex, the federated OIDC Identity Provider.
Note
Dex is installed in the service cluster, so this configuration mainly applies there.
dex
-
is optional
-
Type:
object
(Dex Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Dex Config)
externalTrafficPolicy¶
Configure global ingress external traffic policy.
externalTrafficPolicy
-
is optional
-
Type:
object
(External Traffic Policy) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(External Traffic Policy)
falco¶
Configuration for Falco, runtime security tool and threat detection.
falco
-
is optional
-
Type:
object
(Falco Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Falco Config)
gatekeeper¶
Configure OPA Gatekeeper to give application developer access to Custom Resource Definitions.
Some preconfigured services can be found under the key user
.
Note
See the admin docs for context.
gatekeeper
-
is optional
-
Type:
object
(OPA Gatekeeper Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(OPA Gatekeeper Config)
kured¶
Configuration for Kured (Kubernetes Reboot Daemon).
Kured orchestrates node reboots to allow nodes to automatically perform system updates and patches.
kured
-
is optional
-
Type:
object
(Kured Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Kured Config)
opa¶
Configure Open Policy Agent, constraints and mutations enforced by Gatekeeper.
Welkin contains multiple safeguards to make it easy to follow security best practices.
This includes an implementation of constraints and mutations with similar behaviour as Pod Security Policies, and application developer centric safeguards.
opa
-
is optional
-
Type:
object
(Open Policy Agent Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Open Policy Agent Config)
trivy¶
Configure Trivy Operator.
Trivy automatically scans the cluster for vulnerabilities, misconfigurations, and exposed secrets.
trivy
-
is optional
-
Type:
object
(Trivy Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Trivy Config)
alerts¶
Configure alerting.
alerts
-
is optional
-
Type:
object
(Alerts Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Alerts Config)
grafana¶
Configure Grafana, the metrics visualisation dashboard.
Welkin hosts two instances of Grafana one for the Platform Administrator and one for the Application Developer.
Note
Grafana is installed in the service cluster, so this configuration mainly applies there.
grafana
-
is optional
-
Type:
object
(Grafana Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Grafana Config)
grafanaLabelEnforcer¶
Configure Grafana Label Enforcer, responsible to filter metrics from different clusters for Grafana datasources.
grafanaLabelEnforcer
-
is optional
-
Type:
object
(Grafana Label Enforcer Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Grafana Label Enforcer Config)
kubeStateMetrics¶
Configure the kube-state-metrics exporter.
kubeStateMetrics
-
is optional
-
Type:
object
(Kube State Metrics) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Kube State Metrics)
metricsServer¶
Configure the metrics-server exporter, used to provide for the metrics API in Kubernetes.
metricsServer
-
is optional
-
Type:
object
(Metrics Server) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Metrics Server)
openstackMonitoring¶
Configure the collection of metrics for OpenStack components.
openstackMonitoring
-
is optional
-
Type:
object
(Openstack Monitoring) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Openstack Monitoring)
prometheus¶
Configure Prometheus.
Prometheus automatically collects metrics via ServiceMonitors, PodMonitors, and Probes, and pushes metrics to Thanos for long term storage. Additionally Prometheus evaluates recording rules for both service and workload cluster, and all alerting rules for the workload cluster.
Note
Prometheus is installed in both service cluster and workload cluster, so this configuration applies there with some exceptions.
prometheus
-
is optional
-
Type:
object
(Prometheus Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Prometheus Config)
prometheusOperator¶
Configure Prometheus Operator.
prometheusOperator
-
is optional
-
Type:
object
(Prometheus Operator) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Prometheus Operator)
prometheusBlackboxExporter¶
Configure Prometheus Blackbox Exporter, the exporter used for probing endpoints.
prometheusBlackboxExporter
-
is optional
-
Type:
object
(Prometheus Blackbox Exporter) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Prometheus Blackbox Exporter)
prometheusNodeExporter¶
Configure Prometheus Node Exporter, the exporter used for collecting node metrics.
prometheusNodeExporter
-
is optional
-
Type:
object
(Prometheus Node Exporter) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Prometheus Node Exporter)
s3Exporter¶
Configure S3 exporter, used to collect metrics about S3 usage.
s3Exporter
-
is optional
-
Type:
object
(S3 Exporter) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(S3 Exporter)
thanos¶
Configuration for Thanos.
Thanos ingests metrics sent from Prometheus in both the service and workload clusters, and stores them in object storage.
This requires that objectStorage
is configured, and will use the bucket or container set in objectStorage.buckets.thanos
.
Note
Thanos and its components are installed in the service cluster, so this configuration mainly applies there.
thanos
-
is optional
-
Type:
object
(Thanos Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Thanos Config)
wcProbeIngress¶
Configure a probe for the workload cluster Ingress Controller.
wcProbeIngress
-
is optional
-
Type:
object
(Workcload Cluster Ingress Probe) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Workcload Cluster Ingress Probe)
welcomingDashboard¶
If you want to add extra text to the grafana/opensearch "welcoming dashboards"
then write the text in these values as a one-line string.
Note, first line of the string is a header, not all characters are supported.
For newline in Grafana dashboard use format \\n
welcomingDashboard
-
is optional
-
Type:
object
(Welcoming Dashboard) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Welcoming Dashboard)
fluentd¶
Configuration for Fluentd.
Fluentd automatically collects logs from all containers running in the environment.
In the service cluster audit, application, and platform logs can be shipped to object storage. In the workload cluster audit logs can be shipped to object storage and application and platform logs to OpenSearch running in the service cluster.
Logs are collected using a daemon set, and in the workload cluster two sets are deployed, one for the system nodes and one for the worker nodes. Application developer can modify two ConfigMaps to add additional configuration and plugins to the set running on the worker nodes.
When logs are shipped to object storage a stateful aggregator is deployed that buffers logs with persistence before they are shipped. When logs are shipped to OpenSearch it is done directly from the forwarder daemons.
Shipping audit and service cluster logs requires that objectStorage
is configured, and will use the bucket or container set in objectStorage.buckets.audit
and objectStorage.buckets.scLogs
respectively.
Note
Fluentd is installed in both service cluster and workload cluster, so this configuration applies there with some exceptions.
fluentd
-
is optional
-
Type:
object
(Fluentd Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Fluentd Config)
opensearch¶
Configuration for OpenSearch.
OpenSearch ingests logs sent from Fluentd in the workload cluster, and presents them in OpenSearch Dashboards.
Note
OpenSearch and its components are installed in the service cluster, so this configuration mainly applies there.
opensearch
-
is optional
-
Type:
object
(OpenSearch Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(OpenSearch Config)
calicoAccountant¶
Configure Calico accountant, used to collect metrics about packets affected by Network Policies when using Calico.
calicoAccountant
-
is optional
-
Type:
object
(Calico Accountant) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Calico Accountant)
calicoFelixMetrics¶
Configure Calico Felix metrics, used to collect metrics about Calico.
calicoFelixMetrics
-
is optional
-
Type:
object
(Calico Felix Metrics) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Calico Felix Metrics)
certmanager¶
Configure cert-manager, used to provision certificates either self-signed or via Let's Encrypt.
certmanager
-
is optional
-
Type:
object
(cert-manager Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(cert-manager Config)
ingressNginx¶
Configure Ingress-NGINX, the ingress controller.
ingressNginx
-
is optional
-
Type:
object
(Ingress-NGINX Controller Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Ingress-NGINX Controller Config)
issuers¶
Configure issuers for cert-manager.
issuers
-
is optional
-
Type:
object
(Issuers Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Issuers Config)
networkPolicies¶
Configure Network Policies.
Most common Network Policy rules can be updated by running ./bin/ck8s update-ips <both|sc|wc>
.
networkPolicies
-
is optional
-
Type:
object
(Network Policies Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Network Policies Config)
nodeLocalDns¶
Configure node-local-dns, node local DNS resolving and caching.
nodeLocalDns
-
is optional
-
Type:
object
(Node Local DNS) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Node Local DNS)
externalDns¶
Configure External DNS.
External DNS manages DNS records based on Kubernetes resources, and can automatically configure DNS records from:
- CRD resources
- Ingress resources
- Service resources
Currently only AWS Route 53 is supported as the DNS provider.
Note
See the upstream documentation for reference.
externalDns
-
is optional
-
Type:
object
(External DNS Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(External DNS Config)
tektonPipelines¶
Configure Tekton Pipelines
tektonPipelines
-
is optional
-
Type:
object
(Tekton Pipelines Config) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Tekton Pipelines Config)
PROPERTIES:
Additional properties are allowed, as long as they follow this schema:
Configure additional properties not covered by the schema.
-
is optional
-
Type:
object
(Additional Properties) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Additional Properties)
Definitions¶
component¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/component"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
affinity | object |
Optional | cannot be null | Welkin Apps Config |
enabled | boolean |
Optional | cannot be null | Welkin Apps Config |
nodeSelector | object |
Optional | cannot be null | Welkin Apps Config |
resources | object |
Optional | cannot be null | Welkin Apps Config |
tolerations | array |
Optional | cannot be null | Welkin Apps Config |
topologySpreadConstraints | array |
Optional | cannot be null | Welkin Apps Config |
extraArgs | array |
Optional | cannot be null | Welkin Apps Config |
affinity¶
Affinity is a group of affinity scheduling rules.
affinity
-
is optional
-
Type:
object
(Affinity) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Affinity)
enabled¶
enabled
-
is optional
-
Type:
boolean
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
boolean
nodeSelector¶
Kubernetes node selector
nodeSelector
-
is optional
-
Type:
object
(Kubernetes Node Selector) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Kubernetes Node Selector)
EXAMPLES:
kubernetes.io/os: linux
resources¶
Resource requests are used by the kube-scheduler to pick a node to schedule pods on.
Limits are enforced. Resources are commonly 'cpu' and 'memory'.
resources
-
is optional
-
Type:
object
(Kubernetes Resource Requirements) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Kubernetes Resource Requirements)
EXAMPLES:
requests:
memory: 128Mi
cpu: 100m
limits:
memory: 256Mi
cpu: 250m
tolerations¶
Kubernetes Tolerations
Kubernetes taint and toleration
tolerations
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
topologySpreadConstraints¶
TopologySpreadConstraints describes how pods should spread across topology domains.
topologySpreadConstraints
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
extraArgs¶
Extra arguments passed to a container
extraArgs
-
is optional
-
Type:
string[]
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string[]
cpumem¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/cpumem"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
cpu | Multiple | Optional | cannot be null | Welkin Apps Config |
memory | Multiple | Optional | cannot be null | Welkin Apps Config |
cpu¶
cpu
-
is optional
-
Type: any of the following:
string
orinteger
(Details) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
any of the following: string
or integer
(Details)
CONSTRAINTS:
pattern: the string must match the following regular expression:
^[1-9][0-9]*m?$
DEFAULTS:
The default value is:
"100m"
memory¶
memory
-
is optional
-
Type: any of the following:
string
orinteger
(Details) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
any of the following: string
or integer
(Details)
CONSTRAINTS:
pattern: the string must match the following regular expression:
^[0-9]+(\.[0-9]+)?([KMG]i)?$
DEFAULTS:
The default value is:
"128Mi"
extraArgs¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/extraArgs"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
fluentdBuffer¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/fluentdBuffer"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
timekey | string |
Optional | cannot be null | Welkin Apps Config |
timekeyUseUtc | boolean |
Optional | cannot be null | Welkin Apps Config |
timekeyWait | string |
Optional | cannot be null | Welkin Apps Config |
chunkLimitSize | string |
Optional | cannot be null | Welkin Apps Config |
totalLimitSize | string |
Optional | cannot be null | Welkin Apps Config |
flushInterval | string |
Optional | cannot be null | Welkin Apps Config |
flushMode | string |
Optional | cannot be null | Welkin Apps Config |
flushThreadBurstInterval | number |
Optional | cannot be null | Welkin Apps Config |
flushThreadCount | integer |
Optional | cannot be null | Welkin Apps Config |
retryForever | boolean |
Optional | cannot be null | Welkin Apps Config |
retryType | string |
Optional | cannot be null | Welkin Apps Config |
retryMaxInterval | integer |
Optional | cannot be null | Welkin Apps Config |
Additional Properties | Merged | Optional | cannot be null | Welkin Apps Config |
timekey¶
Output plugin will flush chunks per specified time (enabled when time is specified in chunk keys).
timekey
-
is optional
-
Type:
string
(Time Key) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Time Key)
EXAMPLES:
10m
timekeyUseUtc¶
Output plugin decides to use UTC or not to format placeholders using timekey.
timekeyUseUtc
-
is optional
-
Type:
boolean
(Timekey Use UTC) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
boolean
(Timekey Use UTC)
timekeyWait¶
Output plugin will write chunks after timekey_wait seconds later after timekey expiration.
If a user configures timekey 60m, output plugin will wait delayed events for flushed timekey and write the chunk at 10 minutes of each hour.
timekeyWait
-
is optional
-
Type:
string
(Timekey wait) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Timekey wait)
EXAMPLES:
1m
chunkLimitSize¶
Events will be written into chunks until the size of chunks become chunkLimitSize
.
chunkLimitSize
-
is optional
-
Type:
string
(Chunk Limit Size) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Chunk Limit Size)
EXAMPLES:
50MB
totalLimitSize¶
The size limitation of this buffer plugin instance.
Once the total size of stored buffer reached this threshold, all append operations will fail with error (and data will be lost).
totalLimitSize
-
is optional
-
Type:
string
(Total Limit Size) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Total Limit Size)
EXAMPLES:
9GB
flushInterval¶
Flushes the buffer each flushInterval
, if flushMode
is equal to interval
.
flushInterval
-
is optional
-
Type:
string
(Flush Interval) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Flush Interval)
EXAMPLES:
15m
flushMode¶
The flush mode to use.
flushMode
-
is optional
-
Type:
string
(Flush Mode) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Flush Mode)
CONSTRAINTS:
enum: the value of this property must be equal to one of the following values:
Value | Explanation |
---|---|
"lazy" |
Flushes/writes chunks once per timekey |
"interval" |
Flushes/writes chunks per specified time via flushInterval |
"immediate" |
Flushes/writes chunks immediately after events are appended into chunks |
flushThreadBurstInterval¶
The sleep interval (seconds) for threads between flushes when the output plugin flushes the waiting chunks to the next ones.
flushThreadBurstInterval
-
is optional
-
Type:
number
(Flush Thread Burst Interval) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
number
(Flush Thread Burst Interval)
flushThreadCount¶
The number of threads to flush/write chunks in parallel.
flushThreadCount
-
is optional
-
Type:
integer
(Flush Thread Count) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
integer
(Flush Thread Count)
retryForever¶
If true, plugin will ignore retryTimeout
and retryMaxTimes
options and retry flushing forever.
retryForever
-
is optional
-
Type:
boolean
(Retry Forever) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
boolean
(Retry Forever)
retryType¶
The retry algorithm type to use.
retryType
-
is optional
-
Type:
string
(Retry Type) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Retry Type)
CONSTRAINTS:
enum: the value of this property must be equal to one of the following values:
Value | Explanation |
---|---|
"exponential_backoff" |
Increase the wait time, in seconds, exponentially per failure |
"periodic" |
Output plugin will retry periodically with fixed intervals (configured via retryWait) |
retryMaxInterval¶
The maximum interval (seconds) for exponential backoff between retries while failing.
retryMaxInterval
-
is optional
-
Type:
integer
(Retry Max Interval) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
integer
(Retry Max Interval)
PROPERTIES:
Additional properties are allowed, as long as they follow this schema:
Additional properties
Assuming that these are never structures, only scalars
-
is optional
-
Type: any of the following:
string
orinteger
orboolean
(Additional Properties) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
any of the following: string
or integer
or boolean
(Additional Properties)
not
goDuration¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/goDuration"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
iplist¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/iplist"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
netpolRule¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/netpolRule"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
enabled | boolean |
Optional | cannot be null | Welkin Apps Config |
ips | array |
Optional | cannot be null | Welkin Apps Config |
ports | array |
Optional | cannot be null | Welkin Apps Config |
enabled¶
enabled
-
is optional
-
Type:
boolean
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
boolean
ips¶
List of IP netmasks
ips
-
is optional
-
Type:
string[]
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string[]
ports¶
A 16 bit unsigned integer
ports
-
is optional
-
Type:
integer[]
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
integer[]
kubernetesNodeSelector¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/kubernetesNodeSelector"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
Additional Properties | string |
Optional | cannot be null | Welkin Apps Config |
PROPERTIES:
Additional properties are allowed, as long as they follow this schema:
-
is optional
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
percentage¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/percentage"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
port¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/port"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
portlist¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/portlist"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
kubernetesResourceRequirements¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/kubernetesResourceRequirements"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
requests | object |
Optional | cannot be null | Welkin Apps Config |
limits | object |
Optional | cannot be null | Welkin Apps Config |
requests¶
requests
-
is optional
-
Type:
object
(Kubernetes Quantity Map) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Kubernetes Quantity Map)
limits¶
limits
-
is optional
-
Type:
object
(Kubernetes Quantity Map) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Kubernetes Quantity Map)
timeRange¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/timeRange"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
kubernetesTolerations¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/kubernetesTolerations"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
kubernetesTopologySpreadConstraints¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/kubernetesTopologySpreadConstraints"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
kubernetesQuantityMap¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/kubernetesQuantityMap"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
Additional Properties | Multiple | Optional | cannot be null | Welkin Apps Config |
PROPERTIES:
Additional properties are allowed, as long as they follow this schema:
Used for CPU shares, memory and storage size etc.
See https://github.com/kubernetes/apimachinery/blob/master/pkg/api/resource/quantity.go
-
is optional
-
Type: any of the following:
string
ornumber
(Kubernetes Quantity) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
any of the following: string
or number
(Kubernetes Quantity)
kubernetesQuantity¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/kubernetesQuantity"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
kubernetesPersistentVolumeClaim¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/kubernetesPersistentVolumeClaim"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
size | string |
Optional | cannot be null | Welkin Apps Config |
size¶
size
-
is optional
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
DEFAULTS:
The default value is:
"1Gi"
io.k8s.api.core.v1.Affinity¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.Affinity"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
nodeAffinity | Merged | Optional | cannot be null | Welkin Apps Config |
podAffinity | Merged | Optional | cannot be null | Welkin Apps Config |
podAntiAffinity | Merged | Optional | cannot be null | Welkin Apps Config |
nodeAffinity¶
Describes node affinity scheduling rules for the pod.
nodeAffinity
-
is optional
-
Type: merged type (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
merged type (Details)
all of
podAffinity¶
Describes pod affinity scheduling rules (e.g. co-locate this pod in the same node, zone, etc. as some other pod(s)).
podAffinity
-
is optional
-
Type: merged type (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
merged type (Details)
all of
podAntiAffinity¶
Describes pod anti-affinity scheduling rules (e.g. avoid putting this pod in the same node, zone, etc. as some other pod(s)).
podAntiAffinity
-
is optional
-
Type: merged type (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
merged type (Details)
all of
io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelectorRequirement¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelectorRequirement"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
key | string |
Required | cannot be null | Welkin Apps Config |
operator | string |
Required | cannot be null | Welkin Apps Config |
values | array |
Optional | cannot be null | Welkin Apps Config |
key¶
key is the label key that the selector applies to.
key
-
is required
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
operator¶
operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.
operator
-
is required
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
values¶
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.
values
-
is optional
-
Type:
string[]
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string[]
io.k8s.api.core.v1.NodeAffinity¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.NodeAffinity"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
preferredDuringSchedulingIgnoredDuringExecution | array |
Optional | cannot be null | Welkin Apps Config |
requiredDuringSchedulingIgnoredDuringExecution | Merged | Optional | cannot be null | Welkin Apps Config |
preferredDuringSchedulingIgnoredDuringExecution¶
The scheduler will prefer to schedule pods to nodes that satisfy the affinity expressions specified by this field, but it may 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, i.e. 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.
preferredDuringSchedulingIgnoredDuringExecution
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
requiredDuringSchedulingIgnoredDuringExecution¶
If the affinity requirements specified by this field are not met at scheduling time, the pod will not be scheduled onto the node. If the affinity requirements specified by this field cease to be met at some point during pod execution (e.g. due to an update), the system may or may not try to eventually evict the pod from its node.
requiredDuringSchedulingIgnoredDuringExecution
-
is optional
-
Type: merged type (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
merged type (Details)
all of
io.k8s.api.core.v1.PodAffinity¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.PodAffinity"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
preferredDuringSchedulingIgnoredDuringExecution | array |
Optional | cannot be null | Welkin Apps Config |
requiredDuringSchedulingIgnoredDuringExecution | array |
Optional | cannot be null | Welkin Apps Config |
preferredDuringSchedulingIgnoredDuringExecution¶
The scheduler will prefer to schedule pods to nodes that satisfy the affinity expressions specified by this field, but it may 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, i.e. 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.
preferredDuringSchedulingIgnoredDuringExecution
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
requiredDuringSchedulingIgnoredDuringExecution¶
If the affinity requirements specified by this field are not met at scheduling time, the pod will not be scheduled onto the node. If the affinity requirements specified by this field cease to be met at some point during pod execution (e.g. due to a pod label update), the system may or may 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, i.e. all terms must be satisfied.
requiredDuringSchedulingIgnoredDuringExecution
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
io.k8s.api.core.v1.PodAntiAffinity¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.PodAntiAffinity"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
preferredDuringSchedulingIgnoredDuringExecution | array |
Optional | cannot be null | Welkin Apps Config |
requiredDuringSchedulingIgnoredDuringExecution | array |
Optional | cannot be null | Welkin Apps Config |
preferredDuringSchedulingIgnoredDuringExecution¶
The scheduler will prefer to schedule pods to nodes that satisfy the anti-affinity expressions specified by this field, but it may 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, i.e. 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.
preferredDuringSchedulingIgnoredDuringExecution
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
requiredDuringSchedulingIgnoredDuringExecution¶
If the anti-affinity requirements specified by this field are not met at scheduling time, the pod will not be scheduled onto the node. If the anti-affinity requirements specified by this field cease to be met at some point during pod execution (e.g. due to a pod label update), the system may or may 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, i.e. all terms must be satisfied.
requiredDuringSchedulingIgnoredDuringExecution
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
io.k8s.api.core.v1.PreferredSchedulingTerm¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.PreferredSchedulingTerm"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
preference | Merged | Required | cannot be null | Welkin Apps Config |
weight | integer |
Required | cannot be null | Welkin Apps Config |
preference¶
A node selector term, associated with the corresponding weight.
preference
-
is required
-
Type: merged type (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
merged type (Details)
all of
DEFAULTS:
The default value is:
{}
weight¶
Weight associated with matching the corresponding nodeSelectorTerm, in the range 1-100.
weight
-
is required
-
Type:
integer
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
integer
CONSTRAINTS:
unknown format: the value of this string must follow the format: int32
io.k8s.api.core.v1.NodeSelector¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.NodeSelector"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
nodeSelectorTerms | array |
Required | cannot be null | Welkin Apps Config |
nodeSelectorTerms¶
Required. A list of node selector terms. The terms are ORed.
nodeSelectorTerms
-
is required
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
io.k8s.api.core.v1.WeightedPodAffinityTerm¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.WeightedPodAffinityTerm"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
podAffinityTerm | Merged | Required | cannot be null | Welkin Apps Config |
weight | integer |
Required | cannot be null | Welkin Apps Config |
podAffinityTerm¶
Required. A pod affinity term, associated with the corresponding weight.
podAffinityTerm
-
is required
-
Type: merged type (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
merged type (Details)
all of
DEFAULTS:
The default value is:
{}
weight¶
weight associated with matching the corresponding podAffinityTerm, in the range 1-100.
weight
-
is required
-
Type:
integer
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
integer
CONSTRAINTS:
unknown format: the value of this string must follow the format: int32
io.k8s.api.core.v1.PodAffinityTerm¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.PodAffinityTerm"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
labelSelector | Merged | Optional | cannot be null | Welkin Apps Config |
matchLabelKeys | array |
Optional | cannot be null | Welkin Apps Config |
mismatchLabelKeys | array |
Optional | cannot be null | Welkin Apps Config |
namespaceSelector | Merged | Optional | cannot be null | Welkin Apps Config |
namespaces | array |
Optional | cannot be null | Welkin Apps Config |
topologyKey | string |
Required | cannot be null | Welkin Apps Config |
labelSelector¶
A label query over a set of resources, in this case pods. If it's null, this PodAffinityTerm matches with no Pods.
labelSelector
-
is optional
-
Type: merged type (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
merged type (Details)
all of
matchLabelKeys¶
MatchLabelKeys is a set of pod label keys to select which pods will be taken into consideration. The keys are used to lookup values from the incoming pod labels, those key-value labels are merged with labelSelector
as key in (value)
to select the group of existing pods which pods will be taken into consideration for the incoming pod's pod (anti) affinity. Keys that don't exist in the incoming pod labels will be ignored. The default value is empty. The same key is forbidden to exist in both matchLabelKeys and labelSelector. Also, matchLabelKeys cannot be set when labelSelector isn't set. This is an alpha field and requires enabling MatchLabelKeysInPodAffinity feature gate.
matchLabelKeys
-
is optional
-
Type:
string[]
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string[]
mismatchLabelKeys¶
MismatchLabelKeys is a set of pod label keys to select which pods will be taken into consideration. The keys are used to lookup values from the incoming pod labels, those key-value labels are merged with labelSelector
as key notin (value)
to select the group of existing pods which pods will be taken into consideration for the incoming pod's pod (anti) affinity. Keys that don't exist in the incoming pod labels will be ignored. The default value is empty. The same key is forbidden to exist in both mismatchLabelKeys and labelSelector. Also, mismatchLabelKeys cannot be set when labelSelector isn't set. This is an alpha field and requires enabling MatchLabelKeysInPodAffinity feature gate.
mismatchLabelKeys
-
is optional
-
Type:
string[]
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string[]
namespaceSelector¶
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.
namespaceSelector
-
is optional
-
Type: merged type (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
merged type (Details)
all of
namespaces¶
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".
namespaces
-
is optional
-
Type:
string[]
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string[]
topologyKey¶
This pod should be co-located (affinity) or not co-located (anti-affinity) with the pods matching the labelSelector in the specified namespaces, where 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.
topologyKey
-
is required
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
matchExpressions | array |
Optional | cannot be null | Welkin Apps Config |
matchLabels | object |
Optional | cannot be null | Welkin Apps Config |
matchExpressions¶
matchExpressions is a list of label selector requirements. The requirements are ANDed.
matchExpressions
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
matchLabels¶
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.
matchLabels
-
is optional
-
Type:
object
(Details) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Details)
io.k8s.api.core.v1.NodeSelectorTerm¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.NodeSelectorTerm"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
matchExpressions | array |
Optional | cannot be null | Welkin Apps Config |
matchFields | array |
Optional | cannot be null | Welkin Apps Config |
matchExpressions¶
A list of node selector requirements by node's labels.
matchExpressions
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
matchFields¶
A list of node selector requirements by node's fields.
matchFields
-
is optional
-
Type: an array of merged types (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
an array of merged types (Details)
io.k8s.api.core.v1.NodeSelectorRequirement¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.NodeSelectorRequirement"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
key | string |
Required | cannot be null | Welkin Apps Config |
operator | string |
Required | cannot be null | Welkin Apps Config |
values | array |
Optional | cannot be null | Welkin Apps Config |
key¶
The label key that the selector applies to.
key
-
is required
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
operator¶
Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.
operator
-
is required
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
values¶
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.
values
-
is optional
-
Type:
string[]
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string[]
io.k8s.api.core.v1.EnvVar¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.EnvVar"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
name | string |
Required | cannot be null | Welkin Apps Config |
value | string |
Optional | cannot be null | Welkin Apps Config |
valueFrom | object |
Optional | cannot be null | Welkin Apps Config |
name¶
Name of the environment variable.
Must be a C_IDENTIFIER.
name
-
is required
-
Type:
string
(Environment Variable Name) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Environment Variable Name)
value¶
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: i.e. $$(VAR_NAME)
will produce the string literal $(VAR_NAME)
.
Escaped references will never be expanded, regardless of whether the variable exists or not.
value
-
is optional
-
Type:
string
(Environment Variable Value) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Environment Variable Value)
valueFrom¶
Environment Variable Source represents a source for the value of an Environment Variable.
Imported from Kubernetes project
valueFrom
-
is optional
-
Type:
object
(Environment Variable Source) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
object
(Environment Variable Source)
io.k8s.api.core.v1.EnvVarSource¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.EnvVarSource"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
configMapKeyRef | Not specified | Optional | cannot be null | Welkin Apps Config |
fieldRef | Not specified | Optional | cannot be null | Welkin Apps Config |
resourceFieldRef | Not specified | Optional | cannot be null | Welkin Apps Config |
secretKeyRef | Not specified | Optional | cannot be null | Welkin Apps Config |
configMapKeyRef¶
configMapKeyRef
-
is optional
-
Type: unknown
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
unknown
fieldRef¶
fieldRef
-
is optional
-
Type: unknown
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
unknown
resourceFieldRef¶
resourceFieldRef
-
is optional
-
Type: unknown
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
unknown
secretKeyRef¶
secretKeyRef
-
is optional
-
Type: unknown
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
unknown
io.k8s.api.core.v1.ConfigMapKeySelector¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.ConfigMapKeySelector"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
key | string |
Required | cannot be null | Welkin Apps Config |
name | string |
Optional | cannot be null | Welkin Apps Config |
optional | boolean |
Optional | cannot be null | Welkin Apps Config |
key¶
The key to select.
key
-
is required
-
Type:
string
(Config Map Key) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Config Map Key)
name¶
Name of the referent.
This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
name
-
is optional
-
Type:
string
(Config Map Name) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Config Map Name)
optional¶
Specify whether the ConfigMap or its key must be defined.
optional
-
is optional
-
Type:
boolean
(Config Map Optional) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
boolean
(Config Map Optional)
io.k8s.api.core.v1.ObjectFieldSelector¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.ObjectFieldSelector"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
apiVersion | string |
Optional | cannot be null | Welkin Apps Config |
fieldPath | string |
Required | cannot be null | Welkin Apps Config |
apiVersion¶
Version of the schema the FieldPath is written in terms of, defaults to v1
.
apiVersion
-
is optional
-
Type:
string
(API Version) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(API Version)
fieldPath¶
Path of the field to select in the specified API version.
fieldPath
-
is required
-
Type:
string
(Field Path) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Field Path)
io.k8s.api.core.v1.ResourceFieldSelector¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.ResourceFieldSelector"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
containerName | string |
Optional | cannot be null | Welkin Apps Config |
divisor | Not specified | Optional | cannot be null | Welkin Apps Config |
resource | string |
Optional | cannot be null | Welkin Apps Config |
containerName¶
Container name, required for volumes, optional for env vars
containerName
-
is optional
-
Type:
string
(Container Name) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Container Name)
divisor¶
Specifies the output format of the exposed resources, defaults to 1
.
divisor
-
is optional
-
Type: unknown (Divisor)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
unknown (Divisor)
resource¶
Required, resource to select.
resource
-
is optional
-
Type:
string
(Resource) -
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
(Resource)
io.k8s.api.core.v1.SecretKeySelector¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.SecretKeySelector"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
key | string |
Required | cannot be null | Welkin Apps Config |
name | string |
Optional | cannot be null | Welkin Apps Config |
optional | boolean |
Optional | cannot be null | Welkin Apps Config |
key¶
The key of the secret to select from. Must be a valid secret key.
key
-
is required
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
name¶
Name of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
name
-
is optional
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
optional¶
Specify whether the Secret or its key must be defined
optional
-
is optional
-
Type:
boolean
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
boolean
io.k8s.api.core.v1.TopologySpreadConstraint¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.TopologySpreadConstraint"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
labelSelector | Merged | Optional | cannot be null | Welkin Apps Config |
matchLabelKeys | array |
Optional | cannot be null | Welkin Apps Config |
maxSkew | integer |
Required | cannot be null | Welkin Apps Config |
minDomains | integer |
Optional | cannot be null | Welkin Apps Config |
nodeAffinityPolicy | string |
Optional | cannot be null | Welkin Apps Config |
nodeTaintsPolicy | string |
Optional | cannot be null | Welkin Apps Config |
topologyKey | string |
Required | cannot be null | Welkin Apps Config |
whenUnsatisfiable | string |
Required | cannot be null | Welkin Apps Config |
labelSelector¶
LabelSelector is used to find matching pods. Pods that match this label selector are counted to determine the number of pods in their corresponding topology domain.
labelSelector
-
is optional
-
Type: merged type (Details)
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
merged type (Details)
all of
matchLabelKeys¶
MatchLabelKeys is a set of pod label keys to select the pods over which spreading will be calculated. The keys are used to lookup values from the incoming pod labels, those key-value labels are ANDed with labelSelector to select the group of existing pods over which spreading will be calculated for the incoming pod. The same key is forbidden to exist in both MatchLabelKeys and LabelSelector. MatchLabelKeys cannot be set when LabelSelector isn't set. Keys that don't exist in the incoming pod labels will be ignored. A null or empty list means only match against labelSelector.
This is a beta field and requires the MatchLabelKeysInPodTopologySpread feature gate to be enabled (enabled by default).
matchLabelKeys
-
is optional
-
Type:
string[]
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string[]
maxSkew¶
MaxSkew describes the degree to which pods may be unevenly distributed. When whenUnsatisfiable=DoNotSchedule
, it is the maximum permitted difference between the number of matching pods in the target topology and the global minimum. The global minimum is the minimum number of matching pods in an eligible domain or zero if the number of eligible domains is less than MinDomains. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 2/2/1: In this case, the global minimum is 1. | zone1 | zone2 | zone3 | | P P | P P | P | - if MaxSkew is 1, incoming pod can only be scheduled to zone3 to become 2/2/2; scheduling it onto zone1(zone2) would make the ActualSkew(3-1) on zone1(zone2) violate MaxSkew(1). - if MaxSkew is 2, incoming pod can be scheduled onto any zone. When whenUnsatisfiable=ScheduleAnyway
, it is used to give higher precedence to topologies that satisfy it. It's a required field. Default value is 1 and 0 is not allowed.
maxSkew
-
is required
-
Type:
integer
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
integer
CONSTRAINTS:
unknown format: the value of this string must follow the format: int32
minDomains¶
MinDomains indicates a minimum number of eligible domains. When the number of eligible domains with matching topology keys is less than minDomains, Pod Topology Spread treats "global minimum" as 0, and then the calculation of Skew is performed. And when the number of eligible domains with matching topology keys equals or greater than minDomains, this value has no effect on scheduling. As a result, when the number of eligible domains is less than minDomains, scheduler won't schedule more than maxSkew Pods to those domains. If value is nil, the constraint behaves as if MinDomains is equal to 1. Valid values are integers greater than 0. When value is not nil, WhenUnsatisfiable must be DoNotSchedule.
For example, in a 3-zone cluster, MaxSkew is set to 2, MinDomains is set to 5 and pods with the same labelSelector spread as 2/2/2: | zone1 | zone2 | zone3 | | P P | P P | P P | The number of domains is less than 5(MinDomains), so "global minimum" is treated as 0. In this situation, new pod with the same labelSelector cannot be scheduled, because computed skew will be 3(3 - 0) if new Pod is scheduled to any of the three zones, it will violate MaxSkew.
minDomains
-
is optional
-
Type:
integer
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
integer
CONSTRAINTS:
unknown format: the value of this string must follow the format: int32
nodeAffinityPolicy¶
NodeAffinityPolicy indicates how we will treat Pod's nodeAffinity/nodeSelector when calculating pod topology spread skew. Options are: - Honor: only nodes matching nodeAffinity/nodeSelector are included in the calculations. - Ignore: nodeAffinity/nodeSelector are ignored. All nodes are included in the calculations.
If this value is nil, the behavior is equivalent to the Honor policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.
nodeAffinityPolicy
-
is optional
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
nodeTaintsPolicy¶
NodeTaintsPolicy indicates how we will treat node taints when calculating pod topology spread skew. Options are: - Honor: nodes without taints, along with tainted nodes for which the incoming pod has a toleration, are included. - Ignore: node taints are ignored. All nodes are included.
If this value is nil, the behavior is equivalent to the Ignore policy. This is a beta-level feature default enabled by the NodeInclusionPolicyInPodTopologySpread feature flag.
nodeTaintsPolicy
-
is optional
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
topologyKey¶
TopologyKey is the key of node labels. Nodes that have a label with this key and identical values are considered to be in the same topology. We consider each \
topologyKey
-
is required
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
whenUnsatisfiable¶
WhenUnsatisfiable indicates how to deal with a pod if it doesn't satisfy the spread constraint. - DoNotSchedule (default) tells the scheduler not to schedule it. - ScheduleAnyway tells the scheduler to schedule the pod in any location, but giving higher precedence to topologies that would help reduce the skew. A constraint is considered "Unsatisfiable" for an incoming pod if and only if every possible node assignment for that pod would violate "MaxSkew" on some topology. For example, in a 3-zone cluster, MaxSkew is set to 1, and pods with the same labelSelector spread as 3/1/1: | zone1 | zone2 | zone3 | | P P P | P | P | If WhenUnsatisfiable is set to DoNotSchedule, incoming pod can only be scheduled to zone2(zone3) to become 3/2/1(3/1/2) as ActualSkew(2-1) on zone2(zone3) satisfies MaxSkew(1). In other words, the cluster can still be imbalanced, but scheduler won't make it more imbalanced. It's a required field.
whenUnsatisfiable
-
is required
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
io.k8s.api.core.v1.Toleration¶
Reference this group by using
{"$ref":"https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/main/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.Toleration"}
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
effect | string |
Optional | cannot be null | Welkin Apps Config |
key | string |
Optional | cannot be null | Welkin Apps Config |
operator | string |
Optional | cannot be null | Welkin Apps Config |
tolerationSeconds | integer |
Optional | cannot be null | Welkin Apps Config |
value | string |
Optional | cannot be null | Welkin Apps Config |
effect¶
Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule, PreferNoSchedule and NoExecute.
effect
-
is optional
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
key¶
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.
key
-
is optional
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
operator¶
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.
operator
-
is optional
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
tolerationSeconds¶
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.
tolerationSeconds
-
is optional
-
Type:
integer
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
integer
CONSTRAINTS:
unknown format: the value of this string must follow the format: int64
value¶
Value is the taint value the toleration matches to. If the operator is Exists, the value should be empty, otherwise just a regular string.
value
-
is optional
-
Type:
string
-
cannot be null
-
defined in: Welkin Apps Config
TYPE:
string
Generated Sun Nov 17 03:51:36 UTC 2024 from elastisys/compliantkubernetes-apps@main