PodAffinityTerm Schema¶
Note
This is auto-generated documentation from a JSON schema that is under construction, this will improve over time.
Return to the root config schema
https://raw.githubusercontent.com/elastisys/compliantkubernetes-apps/v0.39.2/config/schemas/config.yaml#/$defs/io.k8s.api.core.v1.PodAffinityTerm
Defines a set of pods (namely those matching the labelSelector relative to the given namespace(s)) that this pod should be co-located (affinity) or not co-located (anti-affinity) with, where co-located is defined as running on a node whose value of the label with key
Imported from Kubernetes project
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
(PodAffinityTerm)
PROPERTIES:
Property | Type | Required | Nullable | Defined by |
---|---|---|---|---|
labelSelector | Merged | Optional | cannot be null | Compliant Kubernetes Apps Config |
matchLabelKeys | array |
Optional | cannot be null | Compliant Kubernetes Apps Config |
mismatchLabelKeys | array |
Optional | cannot be null | Compliant Kubernetes Apps Config |
namespaceSelector | Merged | Optional | cannot be null | Compliant Kubernetes Apps Config |
namespaces | array |
Optional | cannot be null | Compliant Kubernetes Apps Config |
topologyKey | string |
Required | cannot be null | Compliant Kubernetes 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: Compliant Kubernetes 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: Compliant Kubernetes 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: Compliant Kubernetes 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: Compliant Kubernetes 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: Compliant Kubernetes 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: Compliant Kubernetes Apps Config
TYPE:
string
Return to the root config schema
Generated Thu Nov 14 16:14:40 UTC 2024 from elastisys/compliantkubernetes-apps@v0.39.2