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

Document deprecated leader annotation #42054

Merged
merged 1 commit into from
Oct 10, 2023

Conversation

kundan2707
Copy link
Contributor

documented unregistered annotation "control-plane.alpha.kubernetes.io/leader"
fixes: #39297

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jul 17, 2023
@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. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Jul 17, 2023
@kundan2707
Copy link
Contributor Author

/language en

@netlify
Copy link

netlify bot commented Jul 17, 2023

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit f7df84d
🔍 Latest deploy log https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/6524f933d2f2be0008711795
😎 Deploy Preview https://deploy-preview-42054--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@kundan2707
Copy link
Contributor Author

@windsonsea pushed the changes suggested by you

@windsonsea
Copy link
Member

lgtm for the text. Could you squash your commits into a single one?

@sftim
Copy link
Contributor

sftim commented Jul 19, 2023

/sig api-machinery

@k8s-ci-robot k8s-ci-robot added the sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. label Jul 19, 2023
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.

Thanks

/retitle Document deprecated leader annotation


Type: Annotation

Example: `control-plane.alpha.kubernetes.io/leader={"holderIdentity":"controller-0","leaseDurationSeconds":15,"acquireTime":"2023-01-19T13:12:57Z","renewTime":"2023-01-19T13:13:54Z","leaderTransitions":1}`
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm afraid this isn't a valid representation of a YAML snippet. Try copying this from an actual Endpoints manifest.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@sftim this is not yaml snippet rather it is outcome of kubectl get command corresponding to this annotation

Copy link
Contributor

Choose a reason for hiding this comment

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

Thing is: all the other labels and annotations have their examples in the format of a YAML snippet. Let's follow that convention.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@sftim as its got deprecated i am not able to find exact example in any yaml file.
Can you help me in this?

Copy link
Contributor

Choose a reason for hiding this comment

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

You don't need to copy this from an actual Endpoints; another way is to make sure you are writing [a fragment of] valid YAML.

Try this:
https://learnxinyminutes.com/docs/yaml/

You've got the string value right, but you haven't quoted it, and you've used an = where YAML uses a :.

@@ -1086,6 +1086,23 @@ has been truncated to 1000.

If the number of backend endpoints falls below 1000, the control plane removes this annotation.

### control-plane.alpha.kubernetes.io/leader
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
### control-plane.alpha.kubernetes.io/leader
### control-plane.alpha.kubernetes.io/leader (deprecated) {#control-plane-alpha-kubernetes-io-leader}


Used on: Endpoints

The {{< glossary_tooltip text="control plane" term_id="control-plane" >}} adds this annotation to
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The {{< glossary_tooltip text="control plane" term_id="control-plane" >}} adds this annotation to
The {{< glossary_tooltip text="control plane" term_id="control-plane" >}} previously set annotation on

Used on: Endpoints

The {{< glossary_tooltip text="control plane" term_id="control-plane" >}} adds this annotation to
an [Endpoints](/docs/concepts/services-networking/service/#endpoints) object. This annotation provides
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
an [Endpoints](/docs/concepts/services-networking/service/#endpoints) object. This annotation provides
an [Endpoints](/docs/concepts/services-networking/service/#endpoints) object. This annotation provided

Copy link
Contributor

Choose a reason for hiding this comment

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

@kundan2707 In your next PR, please help mark these conversations as "resolved" by clicking the "Resolve conversation" button below when you agree to the suggests and you have revised the PR accordingly.
Checking conversation resolved helps the reviewers confirm that previous discussions are clean, the current reviewer may switch to different aspects of the PR, and a new reviewer wouldn't need to check the whole history of a PR.

@k8s-ci-robot k8s-ci-robot changed the title documented annotation leader Document deprecated leader annotation Jul 19, 2023
@kundan2707
Copy link
Contributor Author

lgtm for the text. Could you squash your commits into a single one?

@windsonsea i will squash all commits after resolving @sftim comments.

@tengqm
Copy link
Contributor

tengqm commented Oct 10, 2023

@kundan2707 Please check the latest comment and address it if possible.
/approve

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Oct 10, 2023
@kundan2707
Copy link
Contributor Author

@tengqm will incorporate latest comment

@k8s-ci-robot k8s-ci-robot added the language/id Issues or PRs related to Indonesian language label Oct 10, 2023
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: tengqm

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

@tengqm
Copy link
Contributor

tengqm commented Oct 10, 2023

All feedback resolved.
/lgtm
(reapplied).

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Oct 10, 2023
@k8s-ci-robot
Copy link
Contributor

LGTM label has been added.

Git tree hash: e4d4741dd3db8fb85f13afb7961e244496b77734

@k8s-ci-robot k8s-ci-robot merged commit 05a7760 into kubernetes:main Oct 10, 2023
3 checks passed
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 language/id Issues or PRs related to Indonesian language lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Annotation control-plane.alpha.kubernetes.io/leader not registered / documented
5 participants