Skip to content

Document new stable labels for zone, region and instance-type#17496

Closed
andrewsykim wants to merge 1 commit intokubernetes:masterfrom
andrewsykim:ga-topology-labels
Closed

Document new stable labels for zone, region and instance-type#17496
andrewsykim wants to merge 1 commit intokubernetes:masterfrom
andrewsykim:ga-topology-labels

Conversation

@andrewsykim
Copy link
Copy Markdown
Member

@andrewsykim andrewsykim commented Nov 8, 2019

Signed-off-by: Andrew Sy Kim kiman@vmware.com

Enhancement: kubernetes/enhancements#837
PRs: kubernetes/kubernetes#81431 kubernetes/kubernetes#82049

I didn't update examples/setup references to use the new labels because the old beta labels are still the source of truth for v1.17. Those will be updated for v1.18.

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Nov 8, 2019
@k8s-ci-robot
Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
To complete the pull request process, please assign jaredbhatti
You can assign the PR to them by writing /assign @jaredbhatti in a comment when ready.

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

Details 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 language/en Issues or PRs related to English language sig/docs Categorizes an issue or PR as relevant to SIG Docs. labels Nov 8, 2019
if you want to target certain workloads to certain instance types, but typically you want
to rely on the Kubernetes scheduler to perform resource-based scheduling. You should aim to schedule based on properties rather than on instance types (for example: require a GPU, instead of requiring a `g2.2xlarge`).

**NOTE**: this label is deprecated, use [node.kubernetes.io/instance-type](nodekubernetesioinstance-type) instead.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

probably worth noting what release this is deprecated/available in


See [failure-domain.beta.kubernetes.io/zone](#failure-domainbetakubernetesiozone).

**NOTE**: this label is deprecated, use [topology.kubernetes.io/region](topologykubernetesioregion) instead.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

note which release

@netlify
Copy link
Copy Markdown

netlify bot commented Nov 8, 2019

Deploy preview for kubernetes-io-master-staging ready!

Built with commit 1dd5ac5

https://deploy-preview-17496--kubernetes-io-master-staging.netlify.com

…de.kubernetes.io/instance-type labels to docs

Signed-off-by: Andrew Sy Kim <kiman@vmware.com>
@makoscafee
Copy link
Copy Markdown
Contributor

Hi @andrewsykim, This looks like docs for enhancement for release v1.17. if it is would you mind opening it against dev-1.17 ?

@andrewsykim
Copy link
Copy Markdown
Member Author

Should I close this one or keep both open?

if you want to target certain workloads to certain instance types, but typically you want
to rely on the Kubernetes scheduler to perform resource-based scheduling. You should aim to schedule based on properties rather than on instance types (for example: require a GPU, instead of requiring a `g2.2xlarge`).

**NOTE**: starting in v1.17, this label is deprecated in favor of [node.kubernetes.io/instance-type](nodekubernetesioinstance-type).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I recommend using a {{< note >}} shortcode here, and again below.

I would not put a deprecation warning in about a future release (see avoid statements about the future). It's OK to PR targeting v1.17 and say that the label is deprecated since v1.17, or just that it's deprecated.

@tengqm
Copy link
Copy Markdown
Contributor

tengqm commented Nov 12, 2019

My feeling is that we can close this in favor of #17498.

@andrewsykim
Copy link
Copy Markdown
Member Author

Thanks

/close

@k8s-ci-robot
Copy link
Copy Markdown
Contributor

@andrewsykim: Closed this PR.

Details

In response to this:

Thanks

/close

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants