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

README: update "out of scope" section #2428

Merged

Conversation

vrothberg
Copy link
Member

  • Remove the Skopeo entry as Podman allows signing and pushing to
    various various now.

  • Mention that Podman does/will not support docker-compose.

Fixes: #746 (comment)
Signed-off-by: Valentin Rothberg rothberg@redhat.com

@openshift-ci-robot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: vrothberg

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-ci-robot openshift-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Feb 25, 2019
@vrothberg
Copy link
Member Author

@baude @mheon @rhatdan @TomSweeneyRedHat PTAL.

@@ -31,10 +31,13 @@ This project tests all builds against each supported version of Fedora, the late

## Out of scope

* Signing and pushing images to various image storages.
Copy link
Member

Choose a reason for hiding this comment

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

Should we leave this, with a note that Podman does it, but we still recommend Skopeo for serious work? Our sign/verify code isn't as mature as theirs

README.md Outdated
See [CRI-O](https://github.com/kubernetes-sigs/cri-o).
* Supporting `docker-compose`. We believe that Kubernetes is the defacto
standard for container orchestration. Hence, Podman allows to create PODs
Copy link
Member

Choose a reason for hiding this comment

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

Don't all-caps POD, no need

* Supporting `docker-compose`. We believe that Kubernetes is the defacto
standard for container orchestration. Hence, Podman allows to create PODs
from a Kubernetes YAML file. See
[podman-play-kube](https://github.com/containers/libpod/blob/master/docs/podman-play-kube.1.md)
Copy link
Member

Choose a reason for hiding this comment

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

Link generate too

Copy link
Member

Choose a reason for hiding this comment

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

Are you going to add generate too per @mheon's suggestion?

Copy link
Member Author

Choose a reason for hiding this comment

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

Sorry, the PR is in already. Shall I update? I think that the podman play manpage could mention it as well.

Copy link
Member

Choose a reason for hiding this comment

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

Sure open a new PR.

README.md Outdated
See [CRI-O](https://github.com/kubernetes-sigs/cri-o).
* Supporting `docker-compose`. We believe that Kubernetes is the defacto
standard for container orchestration. Hence, Podman allows to create PODs
Copy link
Member

Choose a reason for hiding this comment

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

suggest: "allows to create PODs" to "allows the creation of Pods"

@AkihiroSuda
Copy link
Collaborator

The equivalent of docker network create is also out of scope?

@mheon
Copy link
Member

mheon commented Feb 25, 2019

I think a podman network command would be a fine addition, though what we can do with it is a bit more limited by Podman's architecture and CNI (for example, we can't easily attach existing containers to new networks, due to Podman's immutable container model). But I would be happy to accept patches implementing what we can do, so I wouldn't say it's out of scope

Also mention that Podman does/will not support `docker-compose`.

Fixes: containers#746 (comment)
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
@vrothberg
Copy link
Member Author

Updated, @mheon & @TomSweeneyRedHat, thanks for the comments!

@mheon
Copy link
Member

mheon commented Feb 25, 2019

LGTM

@rhatdan
Copy link
Member

rhatdan commented Feb 25, 2019

@TomSweeneyRedHat PTAL

See [Skopeo](https://github.com/containers/skopeo/).
* Container Runtimes daemons for working with the Kubernetes CRI interface.
See [CRI-O](https://github.com/kubernetes-sigs/cri-o).
* Specializing in signing and pushing images to various storage backends.
Copy link
Member

Choose a reason for hiding this comment

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

I like how you handled this @vrothberg

[CRI-O](https://github.com/kubernetes-sigs/cri-o) specializes in that.
* Supporting `docker-compose`. We believe that Kubernetes is the defacto
standard for container orchestration. Hence, Podman allows the creation of
Pods from a Kubernetes YAML file. See

Choose a reason for hiding this comment

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

This doesn't make sense as a term for out of scope. docker-compose is not the same as Docker Swarm. Essentially, docker-compose is a way to spin up a pod on your machine using your single container engine instance.

Making someone deploy Kubernetes for that is madness. However, it is nice that podman can generate Kubernetes YAML for translation to a Kubernetes system, it makes no sense to not have the facility built in so that people can develop these things to eventually host in an OpenShift/Kubernetes system.

Copy link
Member

Choose a reason for hiding this comment

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

docker compose is not part of Docker it is a separate project. And it is Huge. So we currently do not have the man power to do everything that is involved in doing this. If someone wants to start a project called podman-compose, then we would support them.

We don't want to force anyone to do kubernetes. We are just suggesting alternatives and looking at the problem from a different point of view.

Copy link
Member Author

Choose a reason for hiding this comment

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

This doesn't make sense as a term for out of scope. docker-compose is not the same as Docker Swarm. Essentially, docker-compose is a way to spin up a pod on your machine using your single container engine instance.

Right. You can use podman play kube in a similar fashion but with Kubernetes yaml.

Making someone deploy Kubernetes for that is madness. However, it is nice that podman can generate Kubernetes YAML for translation to a Kubernetes system, it makes no sense to not have the facility built in so that people can develop these things to eventually host in an OpenShift/Kubernetes system.

I suggest cooling down a bit.

Noone is forcing users into Kubernetes. podman play kube is meant for the exact use-case you describe but it requires a Kubernetes yaml instead of Compose yaml.

You were referring to podman generate kube which generates this yaml file based on a set of containers/pods and allows migrating to Kubernetes, if desired.

However, the text must be corrected as it was meant to refer to podman-play-kube.

Copy link
Member Author

Choose a reason for hiding this comment

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

However, the text must be corrected as it was meant to refer to podman-play-kube.

Actually, it's fine in this regard: "Hence, Podman allows the creation of Pods from a Kubernetes YAML file."

Not sure if we should avoid mentioning "orchestrating" and rephrase it.

@rhatdan
Copy link
Member

rhatdan commented Feb 26, 2019

/lgtm

@openshift-ci-robot openshift-ci-robot added the lgtm Indicates that a PR is ready to be merged. label Feb 26, 2019
@openshift-merge-robot openshift-merge-robot merged commit 05450f3 into containers:master Feb 26, 2019
@vrothberg vrothberg deleted the docker-compose-out-of-scope branch February 26, 2019 10:00
vrothberg added a commit to vrothberg/libpod that referenced this pull request Feb 26, 2019
Based on user feedback, refine the "Out of scope" section regarding
`docker-compose`:

* Explain why Podman uses Kubernetes YAML.
* Explain how `podman-play-kube` and `podman-generate-kube` fit into the
  picture.

Addresses: containers#2428 (comment)
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
vrothberg added a commit to vrothberg/libpod that referenced this pull request Feb 26, 2019
Addresses: containers#2428 (comment)
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
vrothberg added a commit to vrothberg/libpod that referenced this pull request Feb 26, 2019
Based on user feedback, refine the "Out of scope" section regarding
`docker-compose`:

* Explain why Podman uses Kubernetes YAML.
* Explain how `podman-play-kube` and `podman-generate-kube` fit into the
  picture.

Addresses: containers#2428 (comment)
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
vrothberg added a commit to vrothberg/libpod that referenced this pull request Feb 26, 2019
Addresses: containers#2428 (comment)
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
vrothberg added a commit to vrothberg/libpod that referenced this pull request Feb 26, 2019
Based on user feedback, refine the "Out of scope" section regarding
`docker-compose`:

* Explain why Podman uses Kubernetes YAML.
* Explain how `podman-play-kube` and `podman-generate-kube` fit into the
  picture.

Addresses: containers#2428 (comment)
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
vrothberg added a commit to vrothberg/libpod that referenced this pull request Feb 26, 2019
Addresses: containers#2428 (comment)
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
vrothberg added a commit to vrothberg/libpod that referenced this pull request Feb 26, 2019
Addresses: containers#2428 (comment)
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
@github-actions github-actions bot added the locked - please file new issue/PR Assist humans wanting to comment on an old issue or PR with locked comments. label Sep 27, 2023
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Sep 27, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
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. locked - please file new issue/PR Assist humans wanting to comment on an old issue or PR with locked comments.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

8 participants