Support spec.replicas > 1 in podman play kube — allow multiple Deployment replicas

[arsenalzp]

Hello,
This PR closes #26769.
I decided to introduce this PR as draft one, because the issue doesn't have solid decision on publish port behavior.
The code introduces a new option --multiple-pods, which allows users to create multiple Pods (Deployment.spec.replicas > 1) and it changes --publish option behavior as user has to set

So, the idea is to use as many publishing ports as many Replicas is created, therefore it is user's responsibility on which ports are used on host side; no need to take random ports as those port might be blocked on firewalls, etc.
For example, if Replicas = 2 then it is necessary to use option--publish with 8080:80,8081:80 value.

Once final decision on this solution is approved then I will update Docs and crate tests

Does this PR introduce a user-facing change?

No

[openshift-ci]

Adding the "do-not-merge/release-note-label-needed" label because no release-note block was detected, please follow our release note process to remove it.

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-sigs/prow repository.

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: arsenalzp
Once this PR has been reviewed and has the lgtm label, please assign giuseppe for approval. For more information see the Code Review Process.

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

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[TomSweeneyRedHat]

@arsenalzp good start on this, TYVM!

I agree with @flouthoc 's comments, and we'll need some tests added before we can merge this.

[TomSweeneyRedHat]

And you'll need to tweak the man pages a bit per the CI:

hack/man-page-checker
hack/xref-helpmsgs-manpages
xref-helpmsgs-manpages: 'podman kube play --help' lists '--multiple-pods', which is not in docs/source/markdown/podman-kube-play.1.md
make: *** [Makefile:608: xref-helpmsgs-manpages] Error 1

[arsenalzp]

And you'll need to tweak the man pages a bit per the CI:

hack/man-page-checker
hack/xref-helpmsgs-manpages
xref-helpmsgs-manpages: 'podman kube play --help' lists '--multiple-pods', which is not in docs/source/markdown/podman-kube-play.1.md
make: *** [Makefile:608: xref-helpmsgs-manpages] Error 1

Thank you for feedback!
Of course, I will do it. I marked this PR as draft one until solution is approved.

[packit-as-a-service]

[NON-BLOCKING] Packit jobs failed. @containers/packit-build please check. Everyone else, feel free to ignore.

[arsenalzp]

Test has been created as well as the man page amendment.

[arsenalzp]

Remote calls were fixed just now.

[arsenalzp]

This PR conflicts with my previous PR which was merged today.

[arsenalzp]

All conflicts have been resolved