From c339c5bb6e1d3d894d8020dc63ae8cf3c2f50e56 Mon Sep 17 00:00:00 2001 From: Matthew Heon Date: Fri, 11 May 2018 10:43:34 -0400 Subject: Update Podman-specific readme Signed-off-by: Matthew Heon Closes: #754 Approved by: baude --- cmd/podman/README.md | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/cmd/podman/README.md b/cmd/podman/README.md index 6978b056a..0fee7eafa 100644 --- a/cmd/podman/README.md +++ b/cmd/podman/README.md @@ -1,16 +1,15 @@ # podman - Simple debugging tool for pods and images -podman is a simple client only tool to help with debugging issues when daemons such as CRI runtime and the kubelet are not responding or -failing. A shared API layer could be created to share code between the daemon and podman. podman does not require any daemon running. podman -utilizes the same underlying components that crio uses i.e. containers/image, container/storage, oci-runtime-tool/generate, runc or -any other OCI compatible runtime. podman shares state with crio and so has the capability to debug pods/images created by crio. +podman is a daemonless container runtime for managing containers, pods, and container images. +It is intended as a counterpart to CRI-O, to provide low-level debugging not available through the CRI interface used by Kubernetes. +It can also act as a container runtime independent of CRI-O, creating and managing its own set of containers. ## Use cases -1. List pods. -2. Launch simple pods (that require no daemon support). -3. Exec commands in a container in a pod. -4. Launch additional containers in a pod. -5. List images. -6. Remove images not in use. -7. Pull images. -8. Check image size. -9. Report pod disk resource usage. +1. Create containers +2. Start, stop, signal, attach to, and inspect existing containers +3. Run new commands in existing containers +4. Push and pull images +5. List and inspect existing images +6. Create new images by committing changes within a container +7. Create pods +8. Start, stop, signal, and inspect existing pods +9. Populate pods with containers -- cgit v1.2.3-54-g00ecf