Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Scheduling Configuration reference doc #21437

Merged

Conversation

alculquicondor
Copy link
Member

@alculquicondor alculquicondor commented Jun 2, 2020

kubernetes/enhancements#1451
kubernetes/enhancements#785

Updates include:

  • Changes from v1alpha2
  • New VolumeBinding extension points
  • Redirect from old path

@k8s-ci-robot k8s-ci-robot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Jun 2, 2020
@k8sio-netlify-preview-bot
Copy link
Collaborator

k8sio-netlify-preview-bot commented Jun 2, 2020

Deploy preview for kubernetes-io-vnext-staging processing.

Building with commit 9ed3f42

https://app.netlify.com/sites/kubernetes-io-vnext-staging/deploys/5f0489b67e14fa000717a31d

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Jun 2, 2020
@k8s-ci-robot k8s-ci-robot added the sig/docs Categorizes an issue or PR as relevant to SIG Docs. label Jun 2, 2020
@sftim
Copy link
Contributor

sftim commented Jun 2, 2020

/sig scheduling

@k8s-ci-robot k8s-ci-robot added the sig/scheduling Categorizes an issue or PR as relevant to SIG Scheduling. label Jun 2, 2020
Copy link
Contributor

@sftim sftim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some early / informal feedback

content/en/docs/reference/scheduling/config.md Outdated Show resolved Hide resolved
content/en/docs/reference/scheduling/config.md Outdated Show resolved Hide resolved
@alculquicondor
Copy link
Member Author

Thanks all for the feedback. This PR is still WIP, but section header and id is now in its intended state.

@savitharaghunathan
Copy link
Member

/milestone 1.19

@k8s-ci-robot k8s-ci-robot added this to the 1.19 milestone Jun 3, 2020
@k8s-ci-robot k8s-ci-robot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Jun 18, 2020
@savitharaghunathan
Copy link
Member

Hi @alculquicondor 👋 , Please rebase your PR to avoid major merge conflicts :) Thanks!

@k8s-ci-robot k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Jul 6, 2020
@alculquicondor
Copy link
Member Author

/assign @Huang-Wei

cc @pancernik

@alculquicondor alculquicondor changed the title WIP: Add Scheduling Configuration reference doc Add Scheduling Configuration reference doc Jul 6, 2020
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Jul 6, 2020
Built from the existing Scheduling Profiles doc.

Signed-off-by: Aldo Culquicondor <acondor@google.com>
Copy link
Contributor

@sftim sftim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Markdown looks OK to me.

The new text:

The KubeSchedulerConfiguration is a configuration API for kube-scheduler
that can be provided as a file via --config command line flag.

could be a bit confusing to readers, but if this merges as-is I'm fine with that.

@alculquicondor you can revise again or move forward towards a technical LGTM and either approach works for me.

content/en/docs/reference/scheduling/config.md Outdated Show resolved Hide resolved
content/en/docs/reference/scheduling/config.md Outdated Show resolved Hide resolved
content/en/docs/reference/scheduling/config.md Outdated Show resolved Hide resolved
static/_redirects Show resolved Hide resolved
Signed-off-by: Aldo Culquicondor <acondor@google.com>
@ahg-g
Copy link
Member

ahg-g commented Jul 6, 2020

Latest revision looks good to me.

@sftim
Copy link
Contributor

sftim commented Jul 6, 2020

I'm not sure who is reviewing for SIG Scheduling. I think that this should have technical review (and I also hope that this is easy to review).

@kubernetes/sig-scheduling-pr-reviews this is reach ready for tech review. Please /lgtm when happy.

@sftim
Copy link
Contributor

sftim commented Jul 6, 2020

@alculquicondor
Copy link
Member Author

@ahg-g mind giving lgtm?

@ahg-g
Copy link
Member

ahg-g commented Jul 6, 2020

/lgtm

Tin, I already reviewed the PR

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jul 6, 2020
Copy link
Member

@Huang-Wei Huang-Wei left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sry for the late review. Some nits.

content/en/docs/reference/scheduling/config.md Outdated Show resolved Hide resolved
content/en/docs/reference/scheduling/config.md Outdated Show resolved Hide resolved
@@ -33,33 +44,57 @@ extension points:
sort pending Pods in the scheduling queue. Exactly one queue sort plugin
may be enabled at a time.
1. `PreFilter`: These plugins are used to pre-process or check information
about a Pod or the cluster before filtering.
about a Pod or the cluster before filtering. They can mark a pod as
unschedulable.
1. `Filter`: These plugins are the equivalent of Predicates in a scheduling
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will submit another PR finishing the PostFilter part.

weight: 1
```

You can use `*` as name in the disabled array to disable all default plugins
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can use `*` as name in the disabled array to disable all default plugins
You can use `*` as name in the disabled array to disable all default plugins

@savitharaghunathan
Copy link
Member

/assign

@cofyc
Copy link
Member

cofyc commented Jul 7, 2020

cc @cofyc for VolumeBinding changes

VolumeBinding changes LGTM

score:
disabled:
- name: '*'
```

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it make sense to explain this example? For example by adding a paragraph:

The example above will configure kube-scheduler to run two schedulers: the default one and no-scoring-scheduler with the score extension point disabled for all plugins.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good suggestion

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is interesting, so are we saying we will be able to use the same scheduler binary to act as two different schedulers based on the scheduler field in the Pod ?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Correct.

Signed-off-by: Aldo Culquicondor <acondor@google.com>
@k8s-ci-robot k8s-ci-robot removed the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jul 7, 2020
@pancernik
Copy link

LGTM

@alculquicondor
Copy link
Member Author

@savitharaghunathan or @sftim anything else for approval?

@sftim
Copy link
Contributor

sftim commented Jul 8, 2020

Changes since #21437 (comment) look good to me
/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jul 8, 2020
Copy link
Member

@savitharaghunathan savitharaghunathan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/approve

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: savitharaghunathan

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jul 8, 2020
@k8s-ci-robot k8s-ci-robot merged commit 754c6b1 into kubernetes:dev-1.19 Jul 8, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/docs Categorizes an issue or PR as relevant to SIG Docs. sig/scheduling Categorizes an issue or PR as relevant to SIG Scheduling. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet