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

@pmadypmady 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-robotk8s-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-robotk8s-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-robotk8s-ci-robot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Jan 2, 2026
@netlify

netlifyBot commented Jan 2, 2026•
edited
Loading

Copy link
Copy Markdown

✅ Pull request preview available for checking

Built without sensitive environment variables

NameLink
🔨 Latest commit468127b
🔍 Latest deploy loghttps://app.netlify.com/projects/kubernetes-io-main-staging/deploys/695d5de7d2196e00080c0aef
😎 Deploy Previewhttps://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

@lmktfylmktfy 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
pmadyforce-pushed the add-deployment-annotations branch from 860178a to 2880a43CompareJanuary 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
pmadyforce-pushed the add-deployment-annotations branch from 2880a43 to 468127bCompareJanuary 6, 2026 19:09
@k8s-ci-robotk8s-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
ContributorAuthor

@lmktfy Updated commit message

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

@lmktfylmktfy 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-robotk8s-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-rawatdipesh-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-robotk8s-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:mainJan 16, 2026
6 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@dipesh-rawatdipesh-rawatdipesh-rawat left review comments
@lmktfylmktfylmktfy left review comments
@katcosgrovekatcosgroveAwaiting requested review from katcosgrove

Assignees

@lmktfylmktfy

Labels

approvedIndicates a PR has been approved by an approver from all required OWNERS files.cncf-cla: yesIndicates the PR's author has signed the CNCF CLA.language/enIssues or PRs related to English languagelgtm"Looks good to me", indicates that a PR is ready to be merged.size/MDenotes 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