diff options
author | Matthew Heon <matthew.heon@gmail.com> | 2018-05-11 10:37:35 -0400 |
---|---|---|
committer | Atomic Bot <atomic-devel@projectatomic.io> | 2018-05-11 15:32:27 +0000 |
commit | 4c907ce81ab2c86ecbc70166561b686f393d7382 (patch) | |
tree | 18831afcedfbe7c0bda458d01208b7cd96ce63d6 | |
parent | 608f0b9596cf8f0913c4a086eeed654b589f79f4 (diff) | |
download | podman-4c907ce81ab2c86ecbc70166561b686f393d7382.tar.gz podman-4c907ce81ab2c86ecbc70166561b686f393d7382.tar.bz2 podman-4c907ce81ab2c86ecbc70166561b686f393d7382.zip |
Update main README
Signed-off-by: Matthew Heon <matthew.heon@gmail.com>
Closes: #754
Approved by: baude
-rw-r--r-- | README.md | 33 |
1 files changed, 17 insertions, 16 deletions
@@ -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 |