Skip to content

Document deployment.kubernetes.io/* annotations - #53891

Merged
k8s-ci-robot merged 1 commit into
kubernetes:mainfrom
pmady:add-deployment-annotations
Jan 16, 2026
Merged

Document deployment.kubernetes.io/* annotations#53891
k8s-ci-robot merged 1 commit into
kubernetes:mainfrom
pmady:add-deployment-annotations

Conversation

@pmady

@pmady pmady commented Jan 2, 2026

Copy link
Copy Markdown
Contributor

Add documentation for three annotations used by the Deployment controller on ReplicaSets:

  • deployment.kubernetes.io/desired-replicas: Tracks desired replica count
  • deployment.kubernetes.io/max-replicas: Tracks max replicas during rolling updates
  • deployment.kubernetes.io/revision: Tracks deployment revision for rollout history

These annotations are internal to the Deployment API implementation and are used to manage rolling updates, scaling operations, and rollback functionality.

Fixes #53890

Description

Issue

Closes: #

@k8s-ci-robot k8s-ci-robot added the do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. label Jan 2, 2026
@k8s-ci-robot k8s-ci-robot added language/en Issues or PRs related to English language cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Jan 2, 2026
@k8s-ci-robot

k8s-ci-robot commented Jan 2, 2026

Copy link
Copy Markdown
Contributor

Welcome @pmady!

It looks like this is your first PR to kubernetes/website 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/website has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

@k8s-ci-robot k8s-ci-robot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Jan 2, 2026
@netlify

netlify Bot commented Jan 2, 2026 •
edited
Loading

Copy link
Copy Markdown

✅ Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 468127b
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/695d5de7d2196e00080c0aef
😎 Deploy Preview https://deploy-preview-53891--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 project configuration.

lmktfy
lmktfy reviewed Jan 6, 2026
View reviewed changes

@lmktfy lmktfy left a comment

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.

Content LGTM; the commit message needs amending though.

@pmady
pmady force-pushed the add-deployment-annotations branch from 860178a to 2880a43 Compare January 6, 2026 19:06
@pmady
content: document deployment.kubernetes.io/* annotations
468127b 
Add documentation for three annotations used by the Deployment controller
on ReplicaSets:

- deployment.kubernetes.io/desired-replicas: Tracks desired replica count
- deployment.kubernetes.io/max-replicas: Tracks max replicas during rolling updates
- deployment.kubernetes.io/revision: Tracks deployment revision for rollout history

These annotations are internal to the Deployment API implementation and are
used to manage rolling updates, scaling operations, and rollback functionality.

Signed-off-by: pmady <pavan4devops@gmail.com>
@pmady
pmady force-pushed the add-deployment-annotations branch from 2880a43 to 468127b Compare January 6, 2026 19:09
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. label Jan 6, 2026
@pmady

pmady commented Jan 6, 2026

Copy link
Copy Markdown
Contributor Author

@lmktfy Updated commit message

@pmady
pmady requested a review from lmktfy January 7, 2026 02:56
lmktfy
lmktfy reviewed Jan 15, 2026
View reviewed changes

@lmktfy lmktfy left a comment

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.

Thanks

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jan 15, 2026
@k8s-ci-robot

k8s-ci-robot commented Jan 15, 2026

Copy link
Copy Markdown
Contributor

LGTM label has been added.

DetailsGit tree hash: 8006fb00dda859c4f2c6929e35afbed0c6f841da

dipesh-rawat
dipesh-rawat reviewed Jan 16, 2026
View reviewed changes

@dipesh-rawat dipesh-rawat left a comment

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.

/approve

@k8s-ci-robot

k8s-ci-robot commented Jan 16, 2026

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: dipesh-rawat

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

The pull request process is described 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 the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jan 16, 2026
@k8s-ci-robot
k8s-ci-robot merged commit e7b6b15 into kubernetes:main Jan 16, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@dipesh-rawat dipesh-rawat dipesh-rawat left review comments
@lmktfy lmktfy lmktfy left review comments
@katcosgrove katcosgrove Awaiting requested review from katcosgrove

Assignees

@lmktfy lmktfy

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. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Document deployment.kubernetes.io/* annotations

4 participants

@pmady @k8s-ci-robot @dipesh-rawat @lmktfy