Skip to content

Conversation

shiavm006
Copy link
Contributor

@shiavm006 shiavm006 commented Jul 31, 2025

This PR updates the documentation and help text for the --annotation flag in podman kube play:

Makes it clear that the flag only adds Podman-specific annotations to containers in the created pods, not to the Kubernetes Pod object. Notes that the infra container does not receive the annotation. Addresses confusion reported in #26450 and related discussions.

No code behavior is changed; this is a documentation and UX clarification only.

docs:(kube play):clarify -- annotation flag only affects containers, not pods 

fixes : #26448

@openshift-ci openshift-ci bot added the do-not-merge/release-note-label-needed Enforce release-note requirement, even if just None label Jul 31, 2025
@shiavm006
Copy link
Contributor Author

@lsm5 @mheon Could you please apply the No New Tests label? This is a documentation-only PR.

@openshift-ci openshift-ci bot added release-note and removed do-not-merge/release-note-label-needed Enforce release-note requirement, even if just None labels Jul 31, 2025
@zhangguanzhang
Copy link
Collaborator

commit message should contain CI:DOCS

@lsm5 lsm5 added the No New Tests Allow PR to proceed without adding regression tests label Jul 31, 2025
@lsm5
Copy link
Member

lsm5 commented Jul 31, 2025

commit message should contain CI:DOCS

That shouldn't be the case anymore. @Luap99 correct me if i'm wrong.

@Luap99
Copy link
Member

Luap99 commented Jul 31, 2025

commit message should contain CI:DOCS

That shouldn't be the case anymore. @Luap99 correct me if i'm wrong.

Yes it has no effect on CI, we have to use the label

@@ -5,3 +5,5 @@
#### **--annotation**=*key=value*

Add an annotation to the container<<| or pod>>. This option can be set multiple times.

For `podman kube play`, this adds Podman-specific annotations to the containers and pods created by Podman, not to the Kubernetes YAML itself. These annotations can be used to configure Podman-specific features like user namespaces, volumes-from, and other container behaviors.
Copy link
Member

Choose a reason for hiding this comment

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

We should not add this to the general options description as this will also be shows for podman run/create.

The chnage you did in podman-kube-play.1.md.in should be sufficient I would say

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated and u were right its create confusion and is incorrect

@shiavm006 shiavm006 force-pushed the docs-fix-kube-play-annotation-flag branch from 5ddd864 to 5ab92a7 Compare July 31, 2025 14:47
Copy link
Member

@Luap99 Luap99 left a comment

Choose a reason for hiding this comment

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

LGTM

@openshift-ci openshift-ci bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jul 31, 2025
Copy link
Member

@lsm5 lsm5 left a comment

Choose a reason for hiding this comment

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

/lgtm

@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Aug 1, 2025
Copy link
Contributor

openshift-ci bot commented Aug 1, 2025

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: lsm5, Luap99, shiavm006

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

@openshift-merge-bot openshift-merge-bot bot merged commit 8e5ed09 into containers:main Aug 1, 2025
76 of 77 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. lgtm Indicates that a PR is ready to be merged. No New Tests Allow PR to proceed without adding regression tests release-note
Projects
None yet
Development

Successfully merging this pull request may close these issues.

docs(kube play): annotation flag is missleading
4 participants