Commit Graph

286 Commits

Author SHA1 Message Date
Kubernetes Prow Robot c40d90f67e
Merge pull request #43336 from Affan-7/image-gc
Remove misleading docs around eviction and image garbage collection
2023-10-24 12:55:07 +02:00
oculushut e124688855
Clearer information about the emptyDir and correction for how topologyKey works (#42780)
* removes "tmpfs is cleared on node reboot"

I believe the statement is confusing since we are in the emptyDir section of the documentation.  

If a Node is restarted then all pods that resided on that node will be rescheduled onto another Node.  Rescheduled pods will have an empty volume  whether you choose emptyDir.medium "Memory" or not.

* removes bad comma

* improves memory limit description

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

* removes incorrect explanation for topologyKey in an affinity or anti-affinity rule (#1)

The existing text does not make sense to me.  

There is no zone "V" or "R" in the example.  

I have changed the text to be consistent with top answer here which seems to make more sense: https://stackoverflow.com/questions/72240224/what-is-topologykey-in-pod-affinity

* gives more context to node label configuration

* manually wraps text and replaces absolute links with relative ones

* Update assign-pod-node.md

---------

Co-authored-by: Tim Bannister <tim@scalefactory.com>
Co-authored-by: Qiming Teng <tengqm@outlook.com>
2023-10-17 03:40:52 +02:00
Karena Angell 6573fead87
Update pod-scheduling-readiness.md to beta
Pod Scheduling Readiness graduated to beta in 1.27, this minor update reflects that feature state.
2023-10-11 23:50:41 -06:00
Aritra Ghosh 76756833c1
Update taint-and-toleration.md with types of taint effects (#42315)
* Update taint-and-toleration.md

Revamped the taint effect to introduce the effects early in the article

* Update taint-and-toleration.md

* Update taint-and-toleration.md

* Update taint-and-toleration.md

* Update taint-and-toleration.md

* Update content/en/docs/concepts/scheduling-eviction/taint-and-toleration.md

Co-authored-by: Mauren Berti <698465+stormqueen1990@users.noreply.github.com>

* Update content/en/docs/concepts/scheduling-eviction/taint-and-toleration.md

Co-authored-by: Mauren Berti <698465+stormqueen1990@users.noreply.github.com>

* Update content/en/docs/concepts/scheduling-eviction/taint-and-toleration.md

Co-authored-by: Mauren Berti <698465+stormqueen1990@users.noreply.github.com>

* Update taint-and-toleration.md

* Update taint-and-toleration.md

* Update taint-and-toleration.md

* Update taint-and-toleration.md

* Apply suggestions from code review

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

* Update content/en/docs/concepts/scheduling-eviction/taint-and-toleration.md

Co-authored-by: Qiming Teng <tengqm@outlook.com>

* Apply suggestions from code review

Co-authored-by: Qiming Teng <tengqm@outlook.com>

---------

Co-authored-by: Mauren Berti <698465+stormqueen1990@users.noreply.github.com>
Co-authored-by: Tim Bannister <tim@scalefactory.com>
Co-authored-by: Qiming Teng <tengqm@outlook.com>
2023-10-10 05:04:38 +02:00
Tamilselvan 33d2511be5
Fix stale info about spread minDomains (#42758)
* Stale information about minDomains

* Update topology-spread-constraints.md

* Update topology-spread-constraints.md

* Update topology-spread-constraints.md

* Update content/en/docs/concepts/scheduling-eviction/topology-spread-constraints.md

Co-authored-by: Qiming Teng <tengqm@outlook.com>

---------

Co-authored-by: Qiming Teng <tengqm@outlook.com>
2023-10-06 00:03:46 +02:00
Mohammed Affan 2b61bd9cfe Remove misleading docs around eviction and image garbage collection 2023-10-05 12:07:29 +05:30
tamilselvan1102 97fbcee7dc Fix - Remove details about SelectorSpread plugin 2023-09-27 12:24:04 +05:30
Kubernetes Prow Robot ca57565f16
Merge pull request #42920 from sftim/20230622_add_pod_affinity_text
Add pod affinity note
2023-09-06 13:52:55 -07:00
Kubernetes Prow Robot fe22087638
Merge pull request #42178 from sftim/20230724_revise_node_pressure_eviction_concept
Revise node pressure eviction concept
2023-09-06 12:54:52 -07:00
Daniel Shebib b4652d7304 add pod affinity note 2023-09-06 17:13:26 +01:00
Mengjiao Liu e8b136c3b3 Use code_sample shortcode instead of code shortcode 2023-09-05 17:10:14 +08:00
Tim Bannister a5560747df Mention tainting nodes by condition 2023-09-04 18:23:36 +01:00
Tim Bannister f971ce2815 Link to pod phase 2023-09-04 18:23:36 +01:00
Tim Bannister 35fa37e0fb Mention static pods and node-pressure eviction 2023-09-04 18:23:36 +01:00
Tim Bannister 43e61bdadf Revise node-pressure eviction concept
Co-authored-by: Michael <haifeng.yao@daocloud.io>
2023-09-04 18:23:36 +01:00
Tim Bannister 20b43d6095
Merge branch 'main' into 'dev-1.28' 2023-08-09 11:13:31 +01:00
Kubernetes Prow Robot a0abc5b5c4
Merge pull request #42445 from pohly/dra-update
dra: cleanup of Kubernetes 1.28 update
2023-08-08 02:22:16 -07:00
Tim Bannister 98b52d510b dra: cleanup of Kubernetes 1.28 update
This is a follow-up to https://github.com/kubernetes/website/pull/41856 with
the suggested enhancements.
2023-08-08 09:02:44 +02:00
Kubernetes Prow Robot d9091f38c9
Merge pull request #41856 from pohly/dra-update
dra: update for Kubernetes 1.28
2023-08-07 14:44:32 -07:00
Kubernetes Prow Robot cc4e3ec66d
Merge pull request #42236 from sftim/20230726_link_to_node_labels
Link to specific node labels rather than entire list
2023-08-02 10:10:42 -07:00
Patrick Ohly 6c926cb5db dra: update for Kubernetes 1.28
Several improvements under the hood which don't need to be documented here. API
changes (like storing generated resource claim names in the pod status) are
part of the generated API documentation.

What is worth mentioning because it was listed as "limitation" before is that
pre-scheduled pods are now supported better.
2023-08-02 16:09:18 +02:00
Kubernetes Prow Robot 8766ddab71
Merge pull request #42344 from radimih/patch-1
Fix description of Gt and Lt operators in selectors
2023-08-02 01:44:09 -07:00
Radimir Mikhailov d267b7b3a9
Fixed description of Gt and Lt operators 2023-08-01 17:09:12 +07:00
Mengjiao Liu 68ba9633a2 Switch English to use code not codenew shortcode 2023-08-01 16:57:17 +08:00
Tim Bannister 29c6a60501 Link to specific node labels rather than entire list
Less visual space compared to the original approach, but still shows
which labels you can expect to find set on a node.

Co-authored-by: Ritikaa96 <ritika@india.nec.com>
2023-07-27 11:26:33 +01:00
Andrey Goran eb522c126f
Replace {{< codenew ... >}} with {{% codenew ... %}} in all English docs (#42180)
* Replaced {{< codenew ... >}} with {{% codenew ... %}} in all files

* Reverted changes in non-english localizations
2023-07-25 05:54:06 -07:00
Mohammed Affan b64e69439c Add link for descheduler 2023-07-24 15:31:46 +05:30
Rishit Dagli e7cf1ca19b
Merge dev-1.28 into main 2023-07-04 19:21:49 -04:00
Max d61f12d86f
fixed typo for taint-and-toleration.md 2023-06-29 12:50:35 +01:00
Max 4116be05c0
Update taint-and-toleration.md
fixed some typos
2023-06-28 17:33:53 +01:00
Rishit Dagli e2dc67dbc1
Merge pull request #3 from Rishit-dagli/main
Merged main dev-1.28
2023-06-21 13:09:03 -04:00
Qian_Xiao 972abbf09f
Fix node score calculation in resource-bin-packing.md
The nodescore calculation formula misses parentheses causing it confusing to understand.
2023-06-14 13:41:54 -07:00
Vaibhav Goel 290b12ca94
Removed the keyword new from dynamic-resource-allocation.md (#41483)
* Removed the new keyword from dynamic-resource-allocation.md

* Updated the grammar in dynamic-resource-allocation.md
2023-06-12 17:59:57 -07:00
Sreeram Venkitesh 81fd15afe4
Added section on operators for `nodeAffinity` and `podAffinity` (#39742)
* Added section in the docs about the behaviour of operator in the node and pod affinity docs

* Fixes from review

* Fixed podAffinity and added note about non-integer values

* Fixes from review

* Fixed review comments

* Fixes from review
2023-05-24 01:18:50 -07:00
Ruslan Stelmachenko 4d051d9b29
Fix well-known label name 2023-04-28 21:27:29 +02:00
Wei Huang 625b031344
fixup: address comments 2023-04-13 14:37:57 -07:00
Wei Huang 936ac5574f
fixup: address comments 2023-04-13 11:36:02 -07:00
Wei Huang 9c88b40f05
Update scheduler framework doc to include PreEnqueue 2023-04-12 20:48:56 -07:00
Kubernetes Prow Robot 4dcb78cdbd
Merge pull request #40008 from denkensk/update-match
doc: forbid to set matchLabelKeys when labelSelector isn’t set in topologySpreadConstraints
2023-04-05 16:57:47 -07:00
Kubernetes Prow Robot f62d58d9bd
Merge pull request #39978 from moshe010/pod-resource-api-dra-doc-upstream
Extend PodResources API for Dynamic Resource Allocation
2023-04-04 08:35:53 -07:00
Moshe Levi eaf9199d07 doc: extend PodResources API for Dynamic Resource Allocation
Signed-off-by: Moshe Levi <moshele@nvidia.com>
2023-04-04 10:17:03 +03:00
Kubernetes Prow Robot 40a6ff8ad1
Merge pull request #40048 from tzneal/remove-pod-eviction-timeout-docs
remove pod-eviction-timeout documentation
2023-04-03 08:27:51 -07:00
Daniel Vega-Myhre a6d1ec99df
Add docs for mutable scheduling directives on gated Pods (#40000)
* initial commit

* address comments

* Update content/en/docs/concepts/scheduling-eviction/pod-scheduling-readiness.md

Co-authored-by: Aldo Culquicondor <1299064+alculquicondor@users.noreply.github.com>

* adjust phrasing

* Update content/en/docs/concepts/scheduling-eviction/pod-scheduling-readiness.md

Co-authored-by: Qiming Teng <tengqm@outlook.com>

* Update content/en/docs/concepts/scheduling-eviction/pod-scheduling-readiness.md

Co-authored-by: Qiming Teng <tengqm@outlook.com>

---------

Co-authored-by: Aldo Culquicondor <1299064+alculquicondor@users.noreply.github.com>
Co-authored-by: Qiming Teng <tengqm@outlook.com>
2023-04-03 07:59:51 -07:00
Alex Wang 1378908574 doc: forbid to set matchLabelKeys when labelSelector isn’t set in topologySpreadConstraints
Signed-off-by: Alex Wang <wangqingcan1990@gmail.com>
2023-04-02 22:55:01 +08:00
Todd Neal 3a81c94ba8 remove pod-eviction-timeout documentation
pod-eviction-timeout has been removed from v1.27, update the docs to
reference the taint based eviction that is now the default and only
mechanism.
2023-03-21 08:00:33 -05:00
Mickey Boxell 79fd7f88d6 Merge remote-tracking branch 'upstream/main' into dev-1.27 2023-03-20 21:58:19 -05:00
Patrick Ohly 5beb348e62 dynamic resource allocation: update for 1.27
The API group was bumped to make some incompatible internal changes and the
user-visible renaming of PodScheduling to PodSchedulingContext.
2023-03-17 20:31:48 +01:00
Dhairya-Arora01 64af02f281 fixed the outdated link 2023-03-12 14:17:00 +00:00
Kubernetes Prow Robot bd456cf518
Merge pull request #39824 from mickeyboxell/merged-main-dev-1.27
Merged main dev 1.27
2023-03-10 07:00:40 -08:00
Kubernetes Prow Robot d3979d5150
Merge pull request #39773 from Huang-Wei/1.27/PodSchedulingReadiness-beta
Doc for Beta feature PodSchedulingReadiness
2023-03-08 23:14:01 -08:00
Alex Wang d84256921b doc: graduate matchLabelKeys in podTopologySpread to beta
Signed-off-by: Alex Wang <wangqingcan1990@gmail.com>
2023-03-07 11:07:09 +08:00
Wei Huang fc019615ab
Doc for Beta feature PodSchedulingReadiness 2023-03-06 09:02:48 -08:00
Dipesh Rawat bee8feccc2
Add minimum and maximum values for PriorityClass
Co-authored-by: Tim Bannister <tim@scalefactory.com>
2023-02-23 17:39:00 +00:00
Dipesh Rawat 4df5efbaea
Add minimum and maximum values for PriorityClass 2023-02-23 16:37:18 +00:00
zhuzhenghao 07526a10ce Clean up page assign-pod-node 2023-02-19 14:58:34 +08:00
Todd Neal f9a19295ee
Update content/en/docs/concepts/scheduling-eviction/assign-pod-node.md
Co-authored-by: Aldo Culquicondor <1299064+alculquicondor@users.noreply.github.com>
2023-02-14 09:51:42 -06:00
Todd Neal 47e6adfcc9 add a node indicating when nodeName should be used 2023-02-14 09:27:50 -06:00
Kubernetes Prow Robot 61a122963f
Merge pull request #39271 from Zhuzhenghao/en/resource-bin-package
Tweak page style for resource-bin-packing.md
2023-02-04 23:44:29 -08:00
zhuzhenghao 87e8d214e1 Tweak page style for resource-bin-packing.md 2023-02-05 14:49:26 +08:00
zhuzhenghao 3aa5fe0cca Cleanup node-pressure-eviction.md 2023-02-05 14:17:55 +08:00
Yi-Han Chen e66d61d9a6 fix(#38432): Use Kubernetes colors in stateDiagram
improve stateDiagram's style in pod-scheduling-readiness page
2022-12-29 00:03:07 -05:00
Mengjiao Liu b272f1c4ce Fix minDomains note in topology-spread-constraints page 2022-12-20 11:21:43 +08:00
carolina valencia 7cd85d1fc4 Merge remote-tracking branch 'upstream/main' into dev-1.26 2022-12-07 11:40:37 -03:00
Hamza Sheikh dfda271e99
Update kube-scheduler.md (#38264)
* Update kube-scheduler.md

A clearer way to write this paragraph explaining the scheduler.

Previous version: For every newly created pod or other unscheduled pods, kube-scheduler selects an optimal node for them to run on. However, every container in pods has different requirements for resources and every pod also has different requirements. Therefore, existing nodes need to be filtered according to the specific scheduling requirements.

Proposed version: Kube-scheduler selects an optimal node to run newly created or not yet scheduled (unscheduled) pods. Since containers in pods, and pods themselves have different requirements, existing nodes need to be filtered according to the specific scheduling requirements.

* Update kube-scheduler.md

I tried merging both our versions to make it a bit more concise, since feasibility is discussed in the subsequent paragraphs.
2022-12-05 21:26:37 -08:00
Tim Bannister 8f9446f87d
Merge branch 'main' into dev-1.26 2022-12-03 21:36:34 +00:00
Kubernetes Prow Robot cec61c1754
Merge pull request #38052 from krol3/merged-main-dev-1.26
Merge main branch into dev-1.26
2022-11-29 11:59:09 -08:00
Aldo Culquicondor 58d150dc8a
Clarify node affinity API (#38032)
* Clarify node affinity API

* Refer to the items by their names

* Clarify cardinality
2022-11-29 07:43:23 -08:00
Wei Huang 0025a584be
Remove redundant mermaid bits 2022-11-28 10:09:27 -08:00
Kubernetes Prow Robot be09333a58
Merge pull request #37766 from pohly/dynamic-resource-allocation-concepts
dynamic resource allocation concepts
2022-11-28 04:44:07 -08:00
Patrick Ohly 197de4f5ba document dynamic resource allocation concepts
The documentation intentionally only gives an overview. The API documentation
and the KEP have more details. Specific examples will be provided by hardware
vendors that provide resource drivers.

The new page gets placed between "Scheduling Framework" (because that
introduces the concept of a scheduler plugin) and "Scheduler Performance
Tuning" (which seems like a more advanced topic).
2022-11-28 11:48:35 +01:00
carolina valencia b4ad83ef13 Merge remote-tracking branch 'upstream/main' into dev-1.26 2022-11-24 11:49:25 -03:00
Wei Huang 0e70ff0230
fixup: address comments 2022-11-18 10:43:45 -08:00
Wei Huang 21a7c4cc7e
Doc for Alpha feature PodSchedulingReadiness 2022-11-18 10:41:53 -08:00
Thomas VIVET f0ae13bd0a
Update topology-spread-constraints.md
Fix typo MinDomainsInPodToplogySpread -> MinDomainsInPodTopologySpread
2022-11-14 15:52:37 +01:00
carolina valencia 4d9111a85c Merge remote-tracking branch 'upstream/main' into dev-1.26 2022-11-08 18:17:11 -03:00
Abigail McCarthy 3174fdf2d4 Adjust page weights for /docs/concepts section
Changes the page weights of the index files for folders in the /docs/concepts folder. There were some overlapping weights and weights that were close together.
2022-11-04 10:13:53 -04:00
kerthcet d8e7a7a700 Feat: graduate NodeInclusionPolicy to beta
Signed-off-by: kerthcet <kerthcet@gmail.com>
2022-11-03 19:17:49 +08:00
Christopher Negus 66df1d729e Add page weights to concepts -> scheduling-eviction pages 2022-10-25 15:58:57 +00:00
Michael e039acdca8 fix alignment in topology-spread-constraints.md 2022-10-19 08:16:01 +08:00
Kubernetes Prow Robot 342456405d
Merge pull request #36396 from kadtendulkar/kad33
Fix hyperlink on Pod Topology Spread Constraints page
2022-10-18 14:57:02 -07:00
Vaibhav Goel 8ff7e1845d
Updated the behaviour of evictionHard (#36961)
* Updated the behaviour of evictionHard

* Modified the changes in documenting hard eviction behaviour

* Updated the changes
2022-10-02 08:28:13 -07:00
Natan Yellin 3a701b3ea8
Remove misleading word from node eviction docs
Do not imply that node eviction can occur based on CPU. This isn't possible AFAIK.
2022-09-24 18:26:51 +03:00
kadtendulkar 8ebd741c83 Update content/en/docs/concepts/scheduling-eviction/topology-spread-constraints.md 2022-08-29 22:26:36 +05:30
Tanmay Bangalore 9b3288927d Change requestedToCapacityRatioParam to requestedToCapacityRatio in bin-packing docs.
The name requestedToCapacityRatioParam is actually the *type* of the
requestedToCapacityRatio field, as specified in the docs.
2022-08-24 13:16:06 -07:00
kerthcet 3b0b5b9d1c Document the new NodeInclusionPolicyInPodTopologySpread feature gate
Signed-off-by: kerthcet <kerthcet@gmail.com>
2022-08-17 10:31:51 +08:00
Kubernetes Prow Robot 6bb496b6f8
Merge pull request #35966 from kerthcet/feat/update
update the documents of podTopologySpread
2022-08-16 11:18:11 -07:00
kerthcet 5aa74d45b5 address comments
Signed-off-by: kerthcet <kerthcet@gmail.com>
2022-08-16 15:10:16 +08:00
Kubernetes Prow Robot 936b5859ba
Merge pull request #35165 from denkensk/doc-respect-PodTopologySpread
Add docs for MatchLabelKeysInPodTopologySpread feature
2022-08-15 19:27:07 -07:00
kerthcet 391ed0294a revert the chang of remove newline
Signed-off-by: kerthcet <kerthcet@gmail.com>
2022-08-15 20:13:58 +08:00
kerthcet d0e8a08ab1 update the documents of podTopologySpread
Signed-off-by: kerthcet <kerthcet@gmail.com>
2022-08-15 10:37:52 +08:00
Alex Wang cce49fe7e6 add doc for MatchLabelKeysInPodTopologySpread
Signed-off-by: Alex Wang <wangqingcan1990@gmail.com>
2022-08-09 10:59:16 +08:00
Kensei Nakada b26ae49d9a
Update the doc for minDomains to graduate minDomains to beta 2022-08-06 15:29:27 +09:00
Kubernetes Prow Robot 723ae44d5a
Merge pull request #35104 from balaramvedulla/patch-1
Updates to Node affinity weight section
2022-07-25 00:16:58 -07:00
Kubernetes Prow Robot 7078c38d3b
Merge pull request #33792 from sftim/20220510_assign_pod_node_affinity_updates
Revise scheduling-related docs
2022-07-24 03:38:57 -07:00
Balaram Vedulla e8cb7ec9ba
Update assign-pod-node.md 2022-07-17 19:02:52 +02:00
windsonsea 1e550e9604 [en] updated /node-pressure-eviction.md 2022-07-17 16:33:29 +08:00
Tim Bannister bfff661ac0 Clarify known limitation of Pod topology spread constraints
The limitation is more around cluster autoscaling; nonetheless it seems
to belong under Known limitations.
2022-07-14 23:59:07 +01:00
Tim Bannister 72a070e619 Improve Pod Topology Spread Constraints concept
- Adjust heading levels
- Link to API reference for Pod
- Clarify examples
- Add introductory text
- Split two combined examples
- Explain that Pods in a group should set the same topology spread
  constraints
- Write headings in sentence case
- Avoid using “we”
2022-07-14 23:59:07 +01:00
Tim Bannister 829dee0940 Wrap text for Pod Topology Spread Constraints
Wrapping helps localization teams pick up and work with changes.
2022-07-14 23:59:07 +01:00
Tim Bannister 311cdc386a Reword topic Assigning Pods to Nodes
- Rewording
- Tidying

Co-authored-by: Abdullah Gharaibeh <40361897+ahg-g@users.noreply.github.com>
2022-07-14 23:59:07 +01:00