kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

aggregated discovery stable

pull/45267/head
Jefftree 2024-03-12 13:27:02 -04:00
parent 59467ef456
commit 4d80f852db
2 changed files with 9 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
content/en/docs/concepts/overview/kubernetes-api.md
View File

@ -71,22 +71,22 @@ separate endpoint for each group version.
### Aggregated discovery ### Aggregated discovery
{{< feature-state state="beta" for_k8s_version="v1.27" >}} {{< feature-state state="stable" for_k8s_version="v1.27" >}}
Kubernetes offers beta support for aggregated discovery, publishing Kubernetes offers stable support for aggregated discovery, publishing
all resources supported by a cluster through two endpoints (`/api` and all resources supported by a cluster through two endpoints (`/api` and
`/apis`). Requesting this `/apis`). Requesting this
endpoint drastically reduces the number of requests sent to fetch the endpoint drastically reduces the number of requests sent to fetch the
discovery data from the cluster. You can access the data by discovery data from the cluster. You can access the data by
requesting the respective endpoints with an `Accept` header indicating requesting the respective endpoints with an `Accept` header indicating
the aggregated discovery resource: the aggregated discovery resource:
`Accept: application/json;v=v2beta1;g=apidiscovery.k8s.io;as=APIGroupDiscoveryList`. `Accept: application/json;v=v2;g=apidiscovery.k8s.io;as=APIGroupDiscoveryList`.
Without indicating the resource type using the `Accept` header, the default Without indicating the resource type using the `Accept` header, the default
response for the `/api` and `/apis` endpoint is an unaggregated discovery response for the `/api` and `/apis` endpoint is an unaggregated discovery
document. document.
The [discovery document](https://github.com/kubernetes/kubernetes/blob/release-v{{< skew currentVersion >}}/api/discovery/aggregated_v2beta1.json) The [discovery document](https://github.com/kubernetes/kubernetes/blob/release-v{{< skew currentVersion >}}/api/discovery/aggregated_v2.json)
for the built-in resources can be found in the Kubernetes GitHub repository. for the built-in resources can be found in the Kubernetes GitHub repository.
This Github document can be used as a reference of the base set of the available resources This Github document can be used as a reference of the base set of the available resources
if a Kubernetes cluster is not available to query. if a Kubernetes cluster is not available to query.
@ -295,14 +295,14 @@ cluster.
{{< feature-state feature_gate_name="AggregatedDiscoveryEndpoint" >}} {{< feature-state feature_gate_name="AggregatedDiscoveryEndpoint" >}}
Kubernetes offers beta support for aggregated discovery, publishing Kubernetes offers stable support for aggregated discovery, publishing
all resources supported by a cluster through two endpoints (`/api` and all resources supported by a cluster through two endpoints (`/api` and
`/apis`) compared to one for every group version. Requesting this `/apis`) compared to one for every group version. Requesting this
endpoint drastically reduces the number of requests sent to fetch the endpoint drastically reduces the number of requests sent to fetch the
discovery for the average Kubernetes cluster. This may be accessed by discovery for the average Kubernetes cluster. This may be accessed by
requesting the respective endpoints with an Accept header indicating requesting the respective endpoints with an Accept header indicating
the aggregated discovery resource: the aggregated discovery resource:
`Accept: application/json;v=v2beta1;g=apidiscovery.k8s.io;as=APIGroupDiscoveryList`. `Accept: application/json;v=v2;g=apidiscovery.k8s.io;as=APIGroupDiscoveryList`.
The endpoint also supports ETag and protobuf encoding. The endpoint also supports ETag and protobuf encoding.

3
content/en/docs/reference/command-line-tools-reference/feature-gates/aggregated-discovery-endpoint.md
View File

@ -13,6 +13,9 @@ stages:
- stage: beta - stage: beta
defaultValue: true defaultValue: true
fromVersion: "1.27" fromVersion: "1.27"
- stage: stable
defaultValue: true
fromVersion: "1.30"
--- ---
Enable a single HTTP endpoint `/discovery/<version>` which Enable a single HTTP endpoint `/discovery/<version>` which
supports native HTTP caching with ETags containing all APIResources known to the API server. supports native HTTP caching with ETags containing all APIResources known to the API server.