Commit Graph

566 Commits

Author SHA1 Message Date
Shao Yang Hong 14a3548525 Fix link to param "version" 2021-06-14 11:45:41 +08:00
Karen Bradshaw cc9b8e77db update latest to deprecated version 2020-12-11 10:48:35 -05:00
Lorenzo Paris 60a265e6bd Update authentication.md with link to anon reqs (#19706)
Suggest adding a link in case the reader is not familiar with what "anonymous requests" means. This paragraph also includes a reference to "anonymous user," so I think the link is warranted. Thanks.
2020-03-19 11:16:36 -07:00
Yuk, Yongsu 4ed2cf7748 Edit kube-scheduler glossary. (#19708)
* Edit kube-scheduler glossary.

#19707

* Apply suggestions from code review

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

Co-authored-by: Tim Bannister <tim@scalefactory.com>
2020-03-18 17:02:43 -07:00
Tim Bannister e881e91b9a Improve RBAC guide (#17538)
* Update to match website style guide

* Use glossary shortcodes
* Overall tidying

* Drop mention of old (unsupported) releases

* Reword RBAC notes & warnings

* Write “role bindings” as two words

* Tweak RBAC guide wording

* Tweak RBAC out-of-the-box roles table

* Mention other authorizers

There are other authorizers than RBAC and ABAC; hint that these exist
and that the API server might run with these configured.

* Fix formatting of API discovery roles

Also add table caption

* Drop incorrect reference to cluster-status

* Drop vestigial RBAC warning
2020-03-18 15:50:44 -07:00
inductor 4297f3b29c Update nginx to modern versions (#19198)
* update nginx versions

* update

* update examples
2020-03-17 10:48:23 -07:00
Anastas Dancha 1f958e0744 updating cheatsheet.md with command to get containerIDs of all initContainer (#19243)
* adding cheatsheet.md

adding kubectl command to get containerIDs of all
initContainers for every Pod in the cluster
helps to identify stopped container which should not be removed,
when running manual cleanup of stopped containers on K8s cluster nodes

* adding more context for finding initContainer IDs

* removing reference to github issue

Signed-off-by: Anastas Dancha <anapsix@random.io>
2020-03-15 23:12:35 -07:00
Tim Bannister d341eee62e Add cross-references to fundamental concepts (#18092) 2020-03-15 22:30:35 -07:00
steadysupply b2e7dee806 Grammar correction (#19083)
* Grammar correction

* Update ingress.md
2020-03-15 22:20:35 -07:00
Tim Bannister 8999de5238 Fix glossary definitions for cluster infrastructure & operations (#18317)
- Fix category typo
- Reword
2020-03-15 22:18:35 -07:00
makocchi 08e21a1e90 Clean up extensions/v1beta1 in docs [reference/using-api/api-overview.md] (#18840)
* Clean up extensions/v1beta1 in docs

* Mention about resources in the extensions/v1beta1 api group
2020-03-15 22:06:36 -07:00
Manuel Rüger 1d08290c55 AdmissionControllers: Rewrite PodTolerationRestriction (#18849)
Personally the explanation was quite difficult to understand without looking into the code.
I hope I managed to simplify it a bit and added an example how to add annotations to a
namespace so they can be consumed by the PodTolerationRestriction admission
controller.

Signed-off-by: Manuel Rüger <manuel@rueg.eu>
2020-03-15 22:04:35 -07:00
Louis Raymond a869f00509 Update cheatsheet.md (#19039)
Replaced 'if' ZSH kubectl autocomplete with a more compact form
2020-03-15 21:58:35 -07:00
Qiming Teng e0a03c0ebd Resource name constraints (5) (#19122)
xref: #17969, #19099, #18746
2020-03-15 21:52:36 -07:00
Tsahi Duek 5f496a6ce6 Changed 'caBundle' description (#19341)
It is not clear that the 'caBundle' field in the Mutating/Validating webhook object is used for client-side validation from the admission controller itself.
The comment which appears at the source code is much more clear --> https://github.com/kubernetes/api/blob/master/admissionregistration/v1beta1/types.go#L534-L537

My suggestion is to change the description to match the documentation which is IMO much more clear
2020-03-15 21:28:35 -07:00
Naoki Oketani e37b117a3f remove example of deprecated option: kubectl get --export (#19336) 2020-03-15 21:24:35 -07:00
Andrey Zhelnin 8ccc83fad6 Update kubectl explain usage case (#19612)
You can't specify more then one resources at one for explain. See error below:
$ kubectl explain pods,svc
the server doesn't have a resource type "pods,svc"

error: We accept only this format: explain RESOURCE
2020-03-13 17:50:34 -07:00
Morten Lied Johansen cc594a19a9 Added FIAAS Python client library (#19224) 2020-03-09 09:17:36 -07:00
Kubernetes Prow Robot ddb114e717 Use <code> block to display pipes in syntax within markdown table in kubectl overview (#19450) 2020-03-05 05:08:37 -08:00
Andrew Allbright 1242c008a8 Update some instances of latin abbreviation e.g. to alternative phrases (#19182) 2020-02-29 23:12:40 -08:00
Jie Shen be4809ab13 Remove extra backslash in code block (#19255) 2020-02-23 02:34:47 -08:00
Jamario Rankins 499afe4e80 Fix typo about watch bookmarks (#18902) 2020-02-21 21:38:47 -08:00
Qiming Teng ceccbc049c Resource name constraints (1) (#19106)
xref: #17969, #19099, #18746
2020-02-19 15:44:30 -08:00
Jamie Luckett fefda3e4ea Add missing space in documentation line (#19013) 2020-02-19 12:38:47 -08:00
Fabian Ruff f16c41b5ac Fix inital alpha version of ValidateProxyRedirects (#19192)
See: https://github.com/kubernetes/kubernetes/pull/88260
2020-02-19 12:13:33 -08:00
Andrew Allbright 470f932dd8 Latin Abbreviations "vs" Updated to "versus" (#19181)
* grep -lR ' vs ' ./content/en/docs | xargs sed -i '' -e 's/ vs / versus /g'

* Update content/en/docs/concepts/configuration/overview.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Update content/en/docs/concepts/policy/resource-quotas.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

Co-authored-by: Tim Bannister <tim@scalefactory.com>
2020-02-19 00:14:25 -08:00
Andrew Allbright 1513a7b29a latin phrase removed (#19180) 2020-02-18 16:42:25 -08:00
Patrik d15314ca88 fix error in StartupProbe feature gate (#19098)
Signed-off-by: Patrik Cyvoct <patrik@ptrk.io>
2020-02-12 12:05:52 -08:00
Jim Angel 834f1c6bbe adding in a docs alias (#19077) 2020-02-11 18:42:07 -08:00
Zach Corleissen d4437d56c5 Change url to alias (#19070) 2020-02-11 00:48:02 -08:00
Jim Angel db5ddfab15 adding redir (#18834) 2020-02-10 20:02:01 -08:00
Tim Bannister 2faf1024d9 Tweak linking for Kubernetes object concept (#18122)
- Add a link from /docs/reference/using-api/api-concepts/
- Tweak other incoming links to match
2020-02-10 19:24:01 -08:00
Cory O'Daniel 6ff38e05c8 adding elixir k8s client (#19056) 2020-02-10 14:43:54 -08:00
Kabir Kwatra cd2f675b5b Updated CHANGELOG-11 link (#19036) 2020-02-09 14:53:53 -08:00
Mariyan Dimitrov 3482077227 Remove command prompt from Windows example (#18906)
* Remove command prompt from Windows example

According to the [style
guide](https://kubernetes.io/docs/contribute/style/style-guide/#don-t-include-the-command-prompt),
the command prompt should not be included in the examples. Removing the
Windows command prompt from the jsonpath example.

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>

* Put Windows example inside note shortcode

I'm putting the Windows example in a Hug note shortcode to be consistent
with the rest of the documentation.

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>
2020-02-09 05:15:52 -08:00
Prasad Honavar 9da040d5d0 Update cheatsheet.md (#18975)
* Update cheatsheet.md

"List all pods in the namespace, with more details" command corrected by adding --all-namespaces

* Update content/en/docs/reference/kubectl/cheatsheet.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

Co-authored-by: Tim Bannister <tim@scalefactory.com>
2020-02-07 11:45:46 -08:00
Tim Bannister d43ac11196 Revise glossary entry for Device Plugin (#16291) 2020-02-07 09:49:46 -08:00
Aman Gupta 7e0dd4f59f (fix) Removed -n test from kubectl get pv command (#18877)
- PV are cluster scoped rather than namespaced scope
    - So, there is no need to list it by namespace

Signed-off-by: Aman Gupta <aman.gupta@mayadata.io>
2020-02-07 07:23:45 -08:00
Maria Ntalla a816bd7175 Document list/map/structType and listMapKeys (#18977)
These markers where introduced to describe topology of lists, maps,
structs - primarily in support of server-side apply.

Secondarily, a small typo fix:)
2020-02-06 12:57:25 -08:00
Julian V. Modesto 3dcb84268c Document dry-run authorization requirements (#18235)
* Document dry-run write access requirement.

- Add section on dry-run authorization
- Refer to dry-run authorization for diff
- Consistently hyphenate dry-run

* Update content/en/docs/reference/using-api/api-concepts.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

Co-authored-by: Tim Bannister <tim@scalefactory.com>
2020-01-31 01:52:21 -08:00
Karen Bradshaw 999be25909 update ref link for v1.16 (#18837)
Related to issue #18820.

remove links to prev API refs
2020-01-30 17:36:19 -08:00
Tim Bannister 3cf7ba1092 Clean up admission controller deprecation example (#18399) 2020-01-29 15:28:14 -08:00
Sascha Grunert c43b4a5dd5 Unify runtime references (#18493)
- Use the glossary to correctly reference runtimes
- Updated runtime class documentation for CRI-O
- Removed rktlet from runtimes since its EOL

Signed-off-by: Sascha Grunert <sgrunert@suse.com>
2020-01-29 15:24:14 -08:00
Mariyan Dimitrov 5cef2f771e en: Remove kubectl duplicate example (#18656)
With #16974 and the removal of --include-uninitialized flag, the
second
    and third examples of kubectl delete become equal, thus leading to
    duplication and being confusing. Suggest to remove the duplicate and
    replace it with another example in the future if needed.

    Observed in v1.16 and v1.17 documentation.

    Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>
2020-01-29 15:12:13 -08:00
Gerasimos Dimitriadis 6474db98a1 Small editorial fixes in glossary entries (#18807)
* Small editorial fixes in glossary entries

* Revert the wording in the glossary term for proxy
2020-01-29 14:16:14 -08:00
Joe Betz 6e83202424 Followup fixes for: Add resource version section to api-concepts (#18069)
* Followup fixes for: Add resource version section to api-concepts documentation

* Apply feedback

* Apply feedback

* Switch paragraph to active voice
2020-01-23 08:20:51 -08:00
Steve Bang e6308dc66e Correct description of kubectl (#18172)
* Correct description of kubectl

Given that `kubectl` is not a [command line interface (CLI)](https://en.wikipedia.org/wiki/Command-line_interface), I suggest calling it what it is -- a control utility (ctl = control). The term "tool" is commonly used in place of "utility," including the `kubectl` docs.

A CLI presents the user with a command prompt at which the user can enter multiple command lines that a command-line interpreter interprets and processes. Think of `bash`, `emacs`, or a SQL shell.  Since `kubectl` is not run in a shell, it is not a CLI.

Here are related docs that correctly refer to `kubectl` as a "command-line tool":

- https://kubernetes.io/docs/reference/tools/#kubectl
- https://kubernetes.io/docs/reference/glossary/?fundamental=true#term-kubectl
- https://kubernetes.io/docs/tasks/tools/install-kubectl/
- https://kubernetes.io/docs/reference/kubectl/kubectl/

* Update content/en/docs/reference/kubectl/overview.md

Co-Authored-By: Zach Corleissen <zacharysarah@users.noreply.github.com>

Co-authored-by: Zach Corleissen <zacharysarah@users.noreply.github.com>
2020-01-21 10:03:37 -08:00
YAMAMOTO Takashi 9bfc5d8966 Stop mentioning LegacyNodeRoleBehavior for ServiceNodeExclusion labels (#17542)
The text gives me an impression that LegacyNodeRoleBehavior somehow
affects which label is in effect. But actually it doesn't.
2020-01-18 09:43:35 -08:00
Gerasimos Dimitriadis 4e1f73a736 Add HPA as aka for Horizontal Pod Autoscaler (#18502) 2020-01-17 04:44:55 -08:00
Fabio Alessandro Locati 99ca9c0397 Use Control Plane instead of Master (#18438)
* Use Control Plane instead of Master

* improve image. The SVG was not matching the PNG, so I basically had to re-create it from scratch. I kept the visual similarities as mush as possible

* remove tautological phrase

* fix glossary references as well

* improve cluster glossary to move from Master to Control Plane

* improve english form
2020-01-16 05:24:22 -08:00