Podman: A tool for managing OCI containers and pods.
Go to file
TomSweeneyRedHat 67f06cf1cf Touchup build to add missing -q flag
Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Closes: #247
Approved by: rhatdan
2018-01-20 05:41:24 +00:00
.github Rename all references to kpod to podman 2017-12-18 16:46:05 +00:00
.tool Disable interfacer linter 2018-01-16 14:58:06 +00:00
cmd/podman Cleanup of podman stats 2018-01-19 17:00:15 +00:00
cni cni: 98-podman-loopback.conf is not needed 2018-01-08 14:10:51 +00:00
completions/bash Remove --storage-opt from podman run/create 2018-01-17 14:49:23 +00:00
conmon Update Conmon to sync with CRI-O 2017-11-30 23:53:26 +00:00
docs Touchup build to add missing -q flag 2018-01-20 05:41:24 +00:00
hack Add fix_gofmt target 2017-12-13 20:52:51 +00:00
libkpod Remove kpod handling of conmon 2018-01-03 20:10:15 +00:00
libpod Cleanup of podman stats 2018-01-19 17:00:15 +00:00
logo Initial checkin from CRI-O repo 2017-11-01 11:24:59 -04:00
pkg Remove unused pkg/storage code 2018-01-11 18:44:05 -05:00
test Add dns tests 2018-01-19 18:23:32 +00:00
utils Initial checkin from CRI-O repo 2017-11-01 11:24:59 -04:00
vendor Fix seccomp support 2018-01-18 12:26:43 +00:00
.gitignore Initial checkin from CRI-O repo 2017-11-01 11:24:59 -04:00
.papr.sh Set NOTEST variable to skip tests in papr 2018-01-19 14:56:30 +00:00
.papr.yml switch to bats-core 2018-01-16 22:08:07 +00:00
.travis.yml Turn on travis bot 2018-01-10 18:23:26 +00:00
CONTRIBUTING.md Prune Server package. Convert to new github location. 2017-11-01 13:22:04 -04:00
Dockerfile Add default CNI configuration 2017-12-22 19:23:36 +00:00
LICENSE Initial commit 2017-11-01 11:01:27 -04:00
Makefile Touchup README.md and fix whitespace issues 2018-01-19 01:12:40 +00:00
OWNERS Update OWNERS. Remove unused version code 2017-11-01 13:49:21 -04:00
PODMAN_VERSION Rename all references to kpod to podman 2017-12-18 16:46:05 +00:00
README.md Touchup README.md and fix whitespace issues 2018-01-19 01:12:40 +00:00
Vagrantfile Enhancements to papr tests 2017-11-17 02:07:18 +00:00
code-of-conduct.md Initial checkin from CRI-O repo 2017-11-01 11:24:59 -04:00
commands.md Slim down README.md and make tutorials page 2018-01-17 15:49:06 -05:00
crio-umount.conf Initial checkin from CRI-O repo 2017-11-01 11:24:59 -04:00
docker Add support for mimicing docker CLI 2018-01-18 07:01:48 -05:00
hooks.md Rename all references to kpod to podman 2017-12-18 16:46:05 +00:00
install.md Rename all references to kpod to podman 2017-12-18 16:46:05 +00:00
seccomp.json Initial checkin from CRI-O repo 2017-11-01 11:24:59 -04:00
transfer.md Initial podman build 2017-12-23 11:47:33 +00:00
vendor.conf Add support for shm-size. 2018-01-11 12:39:06 +00:00

README.md

PODMAN logo

libpod - library for running OCI-based containers in Pods

Status: Active Development

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.

At a high level, we expect the scope of libpod/podman to the following functionalities:

  • 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.

What is not in scope for this project?

  • Building container images. See Buildah.
  • Signing and pushing images to various image storages. See Skopeo.
  • Container Runtimes daemons for working with Kubernetes CRIs See CRI-O.

OCI Projects Plans

The plan is to use OCI projects and best of breed libraries for different aspects:

Podman Information for Developers

Installation notes Information on how to install Podman in your environment.

OCI Hooks Support Information on how Podman configures OCI Hooks to run when launching a container.

Podman Commands A list of the Podman commands with links to their man pages and in many cases videos showing the commands in use.

Podman Usage Transfer Useful information for ops and dev transfer as it relates to infrastructure that utilizes Podman. This page includes tables showing Docker commands and their Podman equivalent commands.

Tutorials Tutorials on the Podman utility.

Communication with Fellow Developers

For async communication and long running discussions please use issues and pull requests on the github repo. This will be the best place to discuss design and implementation.

For sync communication we have an IRC channel #PODMAN, on chat.freenode.net, that everyone is welcome to join and chat about development.

Current Roadmap

  1. Basic pod/container lifecycle, basic image pull (done)
  2. Support for tty handling and state management (done)
  3. Basic integration with kubelet once client side changes are ready (done)
  4. Support for log management, networking integration using CNI, pluggable image/storage management (done)
  5. Support for exec/attach (done)