Commit Graph

77 Commits

Author SHA1 Message Date
Joe Betz 2b996e4434 Remove field gate information for stable feature, add details to field selectors documentation 2024-10-31 11:42:21 -04:00
Vaibhav Goel 98861dd726
Update the apiserver-aggregation.md (#47165)
* Update the apiserver-aggregation.md

* updated the apiserver-aggregation.md
2024-08-29 00:58:29 +01:00
hacktivist123 e6d2e1499d Merge main into dev-1.31 to keep in sync 2024-07-29 18:03:33 +01:00
Kubernetes Prow Robot 1b47e81c5f
Merge pull request #46263 from MikeSpreitzer/fix-46262
Clarify remark about object names wrt CRD
2024-07-28 13:19:32 -07:00
Joe Betz 8f1e148864
KEP-4358: Custom Resource Field Selectors: Promote to Beta (#46980)
* KEP-4358: Custom Resource Field Selectors: Promote to Beta

* Update content/en/docs/reference/command-line-tools-reference/feature-gates/custom-resource-field-selectors.md

Co-authored-by: Dipesh Rawat <rawat.dipesh@gmail.com>

* Remove alpha level notes about enabling the feature

* Update content/en/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions.md

Co-authored-by: Tim Bannister <tim@scalefactory.com>

* Update content/en/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions.md

Co-authored-by: lakshmi prasuna <56723673+T-Lakshmi@users.noreply.github.com>

* Update content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md

Co-authored-by: lakshmi prasuna <56723673+T-Lakshmi@users.noreply.github.com>

---------

Co-authored-by: Dipesh Rawat <rawat.dipesh@gmail.com>
Co-authored-by: Tim Bannister <tim@scalefactory.com>
Co-authored-by: lakshmi prasuna <56723673+T-Lakshmi@users.noreply.github.com>
2024-07-26 16:53:58 -07:00
Mike Spreitzer 279c81eb26
Clarify remark about object names wrt CRD
Signed-off-by: Mike Spreitzer <mspreitz@us.ibm.com>
2024-07-24 00:44:51 -04:00
Charlie Le 712686dcbd
Update custom-resources.md
Removes extraneous 'with'.
2024-06-01 20:48:20 -07:00
Daniel Chan cdf1ed1236 Merge remote-tracking branch 'upstream/main' into dev-1.30
Merge main into dev-1.30 to keep in sync
2024-04-02 10:05:03 -04:00
Joe Betz 8c0a57a1e1 Add docs for CRD field selection 2024-03-18 11:09:04 -04:00
Dipesh Rawat c889d9b251
Add metadata to use mechanism for API reference links 2024-03-14 14:50:24 +00:00
John Huang dad0076e02
update space
update space
2024-01-26 23:11:40 +08:00
John Huang de76ac2da9
Update content/en/docs/concepts/extend-kubernetes/api-extension/_index.md
Co-authored-by: Tim Bannister <tim@scalefactory.com>
2023-10-17 15:17:33 +08:00
John Huang 1ac047637e
Update content/en/docs/concepts/extend-kubernetes/api-extension/_index.md
Co-authored-by: Tim Bannister <tim@scalefactory.com>
2023-10-17 15:17:23 +08:00
John Huang 9d6436775b
Update content/en/docs/concepts/extend-kubernetes/api-extension/_index.md
Co-authored-by: Ritika <52399571+Ritikaa96@users.noreply.github.com>
2023-09-28 14:17:27 +08:00
pegasas 43de4ac891 add some description of aggregation layer 2023-09-22 08:31:06 +08:00
John Huang 9ded8f2492
Update content/en/docs/concepts/extend-kubernetes/api-extension/_index.md
Co-authored-by: Tim Bannister <tim@scalefactory.com>
2023-09-22 08:27:29 +08:00
pegasas 6e06a71e40 Add documentation explaining the difference between CRDs and API aggregation layer 2023-09-21 09:11:42 +08:00
Alexander Zielenski e894028da7 move to other pages, add links 2023-08-07 22:10:04 -07:00
Tim Bannister 634c17f61c Reorganize Working with Kubernetes Objects section
- move Understanding Kubernetes Objects to be section overview
- within the section, consistently link to the new (moved) page from the
  first mention of “object”
- add a redirect

Co-authored-by: Divya Mohan <divya.mohan0209@gmail.com>
2023-04-29 21:39:42 +01:00
Kubernetes Prow Robot 90e30eac42
Merge pull request #37216 from tengqm/tweak-cr
Tweak line wrapping in the custom-resource concept page
2022-11-09 14:34:54 -08:00
Sahdev Zala 03b167954c Change weight for localization
Part of the work at Doc Sprint KubeCon NA 2022

Related # https://github.com/kubernetes/website/issues/35093

Signed-off-by: Sahdev Zala <spzala@us.ibm.com>
2022-10-24 11:33:32 -04:00
Qiming Teng 888c244394 Tweak line wrapping in the custom-resource concept page
This PR fixes the long line problems found in the custom-resources.md
concept page. Saddly, there are some markdown tables we cannot fix yet
in this PR. Maybe a HTML table is a better alternative.
2022-10-08 16:46:25 +08:00
Qiming Teng ab166dcba2 Tweak line wrapping in the apiserver aggregation page
This PR fixes the long lines found in the apiserver-aggregation.md page.
2022-10-08 16:42:16 +08:00
Kubernetes Prow Robot 781edc66f9
Merge pull request #34734 from sftim/20220628_update_extend_kubernetes_concept_overview
Update “Extend Kubernetes” concept overview
2022-09-22 18:08:39 -07:00
Tim Bannister dd615623bc Tweak custom resources concept
- Use capitalizations as per style guide
- Use glossary tooltips where appropriate
2022-08-27 15:06:07 +01:00
Tim Bannister 4f9ca16794 Revise “Extending Kubernetes” concept
- Rework section index page
- Use more glossary tooltips
- Mention APIService more clearly
- Shift CRD note to the overview page for API extensions
2022-07-18 21:29:27 +01:00
Tim Bannister 73cd38cdc6 Move kubectl overview to be section index
Also:
- use glossary definition in page introduction
- tidy broken link in What's Next section
- update links to refer to moved page
2022-03-03 10:03:00 +00:00
Wang 2d560fd4fb
Update custom-resources.md 2021-11-10 05:07:02 +09:00
Wang 324e4e07fa
[en] update custom-resources
Make it clear that the main API server delegates requests to user created API server.
2021-11-09 18:31:31 +09:00
Kubernetes Prow Robot b50819e5f9
Merge pull request #29349 from jaypipes/controller-dec-api
clarify declarative API in custom controller docs
2021-09-29 09:10:50 -07:00
Jay Pipes 6a4dddd251 clarify declarative API in custom controller docs
The content describing a declarative API in the custom controller
section of the custom resources doc was confusing:

> A declarative API allows you to declare or specify the desired state
of your resource **and tries to keep the current state of Kubernetes
objects in sync with the desired state**. The controller interprets the
structured data as a record of the user's desired state, and continually
maintains this state.

(emphasis added)

It is not the declarative API that tries to keep the current state of
the objects in sync with the desired state. It's the controller that
does that.

I've reworded this paragraph to hopefully clarify this.

Closes Issue #29348

Signed-off-by: Jay Pipes <jaypipes@gmail.com>
2021-09-28 16:19:54 -04:00
deepsan 84c2324c2b Fix service-catalog usage of apiserver aggregation
The Service Catalog architecture changed from using api aggregation to CRDs, but the docs still refer to the older architecture using api aggregation.

Couple of changes here:
1. Change the sentence on how Service Catalog is implemented
2. Replace the example for usage of api aggregation from service-catalog to metrics-server. There are multiple implementations that can be linked to(keda, prometheus, datadog,...), but keeping the documentation neutral by pointing to kubernetes-sigs/metrics-server

References:
- Service Catalog [v0.3.0 release notes](https://github.com/kubernetes-sigs/service-catalog/releases/tag/v0.3.0):

> In release 0.3.0, we've focused on replacing the Aggregated API Server with the CustomResourceDefinitions (CRDs) and the Admission Webhook solution.

- Project [README](https://github.com/kubernetes-sigs/service-catalog/pull/2691/files)
> Service Catalog recently switched to a new CRDs-based architecture. The old API Server-based implementation is available on the v0.2 branch. We support this implementation by providing bug fixes until July 2020.
2021-09-09 17:58:56 -07:00
Kubernetes Prow Robot a161d54e9f
Merge pull request #29209 from deepsan/api-server
Reword Go requirement for subordinate API servers
2021-09-07 05:39:15 -07:00
Kubernetes Prow Robot de92339f81
Merge pull request #29229 from sftim/20210804_update_api_aggregation_layer
Retitle “Kubernetes API Aggregation Layer” concept
2021-08-10 18:46:46 -07:00
deepsan 788b9ce132 Reword Go requirement for Aggregated API
Given 'Aggregated APIs are subordinate API servers that sit behind the primary API server, which acts as a proxy', the comparison table indicates a requirement for the subordinate API servers to use Go, when it is not a requirement as long as the subordinate API server follows the expected contract
2021-08-05 15:07:43 -07:00
Tim Bannister 075fdf2e37 Retitle “Kubernetes API Aggregation Layer” concept
The old title “Extending the Kubernetes API with the aggregation layer”
sounds more like a task page than a concept, so I reworded.
2021-08-04 22:28:54 +01:00
Tim Bannister 1ca5ecbf77 Link to new API reference page for APIService 2021-08-04 22:25:12 +01:00
Xiaopeng Han ecede1568a
update the correct operator link
The original link of `operator pattern` is a meaningless page. This commit updates the link to the correct `operator pattern` page.
2021-03-29 11:54:32 +08:00
Kubernetes Prow Robot 35e74c709d
Merge pull request #25460 from gavinfish/EnableAggregatedDiscoveryTimeout
Remove legacy feature gate EnableAggregatedDiscoveryTimeout for Aggregation layer
2021-03-04 17:16:21 -08:00
Karen Bradshaw 3fd65482e8 clean up use of word: simply 2021-02-07 12:15:29 -05:00
drfish e354338ca3 Remove legacy feature gate EnableAggregatedDiscoveryTimeout 2020-12-07 21:39:46 +08:00
Tim Bannister 3edb970570 Move API overview to be a Docsy section overview 2020-10-20 23:41:54 +01:00
Qiming Teng c8f4704873 Fix links in concepts section (2) 2020-08-02 09:11:14 +08:00
Jerry Park ffe0090d2c Fix with concepts/extend-kubernetes/api-extension/custom-resources/ 2020-06-22 09:32:29 +00:00
Karen Bradshaw 5fe8c3ca5e move setup konnectivity svc
move api-access to extend-kubernetes
2020-06-10 16:06:01 -04:00
Karen Bradshaw ecc27bbbe7 add en pages 2020-06-09 19:33:15 -04:00
Prasad Katti 1481e711c6 Move update-api-object-kubectl-patch.md to be under 'Manage Kubernetes Objects' section 2020-05-18 09:25:13 -07:00
Vinicius Barbosa ded2612866
Update content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md
Co-Authored-By: Jim Angel <jimangel@users.noreply.github.com>
2020-04-21 07:32:37 -03:00
Vinicius Barbosa 7119fa1c27
Merge branch 'master' into patch-1 2020-04-21 00:26:19 -03:00
Ali Mirlou 2060adcc0d Minor refactor and typo fix of Custom Resources topic
Revert a change in Custom Resources topic

Revert Latin phrases to original form

Update custom-resources.md
2020-04-12 00:37:50 +00:00