From 4c907ce81ab2c86ecbc70166561b686f393d7382 Mon Sep 17 00:00:00 2001 From: Matthew Heon Date: Fri, 11 May 2018 10:37:35 -0400 Subject: Update main README Signed-off-by: Matthew Heon Closes: #754 Approved by: baude --- README.md | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 891da53a8..386b80e34 100644 --- a/README.md +++ b/README.md @@ -6,30 +6,31 @@ ## What is the scope of this project? libpod provides a library for applications looking to use the Container Pod concept popularized by Kubernetes. -libpod also contains a tool podman, which allows you to manage Pods, Containers, and Container Images. +libpod also contains a tool called podman for managing Pods, Containers, and Container Images. -At a high level, we expect the scope of libpod/podman to be the following: +At a high level, the scope of libpod and podman is the following: * Support multiple image formats including the existing Docker/OCI image formats. * Support for multiple means to download images including trust & image verification. * Container image management (managing image layers, overlay filesystems, etc). -* Container and POD process lifecycle management. -* Resource isolation of containers and PODS. +* Full management of container lifecycle +* Support for pods to manage groups of containers together +* Resource isolation of containers and pods. ## What is not in scope for this project? -* Building container images. See [Buildah](https://github.com/projectatomic/buildah). * Signing and pushing images to various image storages. See [Skopeo](https://github.com/projectatomic/skopeo/). -* Container Runtimes daemons for working with Kubernetes CRIs. See [CRI-O](https://github.com/kubernetes-incubator/cri-o). +* Container Runtimes daemons for working with Kubernetes CRIs. See [CRI-O](https://github.com/kubernetes-incubator/cri-o). We are working to integrate libpod into CRI-O to share containers and backend code with Podman. ## OCI Projects Plans The plan is to use OCI projects and best of breed libraries for different aspects: -- Runtime: [runc](https://github.com/opencontainers/runc) (or any OCI runtime-spec implementation) and [oci runtime tools](https://github.com/opencontainers/runtime-tools) +- Runtime: [runc](https://github.com/opencontainers/runc) (or any OCI compliant runtime) and [oci runtime tools](https://github.com/opencontainers/runtime-tools) to generate the spec - Images: Image management using [containers/image](https://github.com/containers/image) -- Storage: Storage and management of image layers using [containers/storage](https://github.com/containers/storage) +- Storage: Container and image storage is managed by [containers/storage](https://github.com/containers/storage) - Networking: Networking support through use of [CNI](https://github.com/containernetworking/cni) -- Conmon: [conmon](https://github.com/kubernetes-incubator/cri-o) Conmon is a tool for monitoring OCI runtimes. Part of the CRI-O package +- Builds: Builds are supported via [Buildah](https://github.com/projectatomic/buildah). +- Conmon: [Conmon](https://github.com/kubernetes-incubator/cri-o) is a tool for monitoring OCI runtimes. It is part of the CRI-O package ## Podman Information for Developers @@ -48,18 +49,18 @@ Useful information for ops and dev transfer as it relates to infrastructure that includes tables showing Docker commands and their Podman equivalent commands. **[Podman API](/API.md)** -Documentation on the Podman API using varlink. +Documentation on the Podman API using [Varlink](https://www.varlink.org/). **[Tutorials](docs/tutorials)** -Tutorials on the Podman utility. +Tutorials on using Podman. **[Contributing](CONTRIBUTING.md)** Information about contributing to this project. ### Current Roadmap -1. Basic pod/container lifecycle, basic image pull (done) -1. Support for tty handling and state management (done) -1. Basic integration with kubelet once client side changes are ready (done) -1. Support for log management, networking integration using CNI, pluggable image/storage management (done) -1. Support for exec/attach (done) +1. Varlink API for Podman +1. Integrate libpod into CRI-O to replace its existing container management backend +1. Pod commands for Podman +1. Rootless containers +1. Support for cleaning up containers via post-run hooks -- cgit v1.2.3-54-g00ecf