Skip to content

Commit 2b996e4

Browse files
committed
Remove field gate information for stable feature, add details to field selectors documentation
1 parent 75a8ee2 commit 2b996e4

File tree

3 files changed

+11
-6
lines changed

3 files changed

+11
-6
lines changed

Diff for: content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -316,9 +316,8 @@ may also be used with field selectors when included in the `spec.versions[*].sel
316316
{{< feature-state feature_gate_name="CustomResourceFieldSelectors" >}}
317317

318318
The `spec.versions[*].selectableFields` field of a {{< glossary_tooltip term_id="CustomResourceDefinition" text="CustomResourceDefinition" >}} may be used to
319-
declare which other fields in a custom resource may be used in field selectors
320-
with the feature of `CustomResourceFieldSelectors`
321-
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) (This feature gate is enabled by default since Kubernetes v1.31).
319+
declare which other fields in a custom resource may be used in field selectors.
320+
322321
The following example adds the `.spec.color` and `.spec.size` fields as
323322
selectable fields.
324323

Diff for: content/en/docs/concepts/overview/working-with-objects/field-selectors.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,14 @@ Error from server (BadRequest): Unable to find "ingresses" that match label sele
4646
| Node | `spec.unschedulable` |
4747
| CertificateSigningRequest | `spec.signerName` |
4848

49+
### Custom resources fields
50+
51+
All custom resource types support the `metadata.name` and `metadata.namespace` fields.
52+
53+
Additionally, the `spec.versions[*].selectableFields` field of a {{< glossary_tooltip term_id="CustomResourceDefinition" text="CustomResourceDefinition" >}}
54+
declares which other fields in a custom resource may be used in field selectors. See [selectable fields for custom resources](/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/#crd-selectable-fields)
55+
for more information about how to use field selectors with CustomResourceDefinitions.
56+
4957
## Supported operators
5058

5159
You can use the `=`, `==`, and `!=` operators with field selectors (`=` and `==` mean the same thing). This `kubectl` command, for example, selects all Kubernetes Services that aren't in the `default` namespace:
@@ -72,4 +80,4 @@ You can use field selectors across multiple resource types. This `kubectl` comma
7280

7381
```shell
7482
kubectl get statefulsets,services --all-namespaces --field-selector metadata.namespace!=default
75-
```
83+
```

Diff for: content/en/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions.md

-2
Original file line numberDiff line numberDiff line change
@@ -1685,8 +1685,6 @@ may also be used with field selectors when included in the `spec.versions[*].sel
16851685

16861686
{{< feature-state feature_gate_name="CustomResourceFieldSelectors" >}}
16871687

1688-
For Kubernetes {{< skew currentVersion >}} the ability to define field selectors for
1689-
custom resources is a stable feature since Kubernetes v1.32.
16901688
The `spec.versions[*].selectableFields` field of a {{< glossary_tooltip term_id="CustomResourceDefinition" text="CustomResourceDefinition" >}} may be used to
16911689
declare which other fields in a custom resource may be used in field selectors
16921690
with the feature of `CustomResourceFieldSelectors`

0 commit comments

Comments
 (0)