An open and reliable container runtime https://github.com/containerd/containerd
Find a file
Zhang Wei 59720469ac Provide more useful help information for ctr
`ctr containers/checkpoints` contains lots of important subcommands,
but now help command can't show subcommands. Adding subcommands to
help information will avoid user from digging into the code for
getting necessary command list.

Signed-off-by: Zhang Wei <zhangwei555@huawei.com>
2016-04-18 15:32:46 +08:00
api api: grpc: add Limit to PidsStats 2016-04-05 01:47:32 +10:00
archutils Merge pull request #192 from hqhq/hq_epool_flag 2016-04-15 13:56:32 -07:00
containerd Add timeout flag for container start times 2016-04-05 13:38:49 -07:00
containerd-shim Remove dep on larger packages 2016-04-06 11:21:49 -07:00
ctr Provide more useful help information for ctr 2016-04-18 15:32:46 +08:00
docs Move docs in readme to separate pages 2016-04-06 14:14:51 -07:00
hack Vendor go-check in 2016-03-25 11:03:48 -07:00
integration-test Add test for pause/resume commands 2016-04-04 11:10:32 -07:00
osutils Remove dep on larger packages 2016-04-06 11:21:49 -07:00
runtime Change sleep to 15ms 2016-04-05 14:07:26 -07:00
specs Add exec rlimit support to containerd 2016-03-15 11:46:47 -07:00
supervisor Error oom if container has not stopped 2016-04-07 10:44:36 -07:00
vendor/src Vendor go-check in 2016-03-25 11:03:48 -07:00
.gitignore Add integration-test/test-artifacts to .gitignore 2016-03-28 10:09:16 -07:00
CONTRIBUTING.md Move sign off instructions to CONTRIBUTING.md 2016-04-06 14:14:51 -07:00
Dockerfile Remove govet 2016-04-07 10:40:09 -07:00
LICENSE.code Update readme and version to 0.1.0 2016-03-21 13:01:28 -07:00
LICENSE.docs Update copyright and license 2015-12-18 00:08:16 +01:00
MAINTAINERS Add tonis and mickael as maintainers 2016-03-21 13:16:12 -07:00
Makefile Remove govet 2016-04-07 10:40:09 -07:00
NOTICE Update readme and documentation for release 2015-12-16 12:15:22 -08:00
README.md Provide more useful help information for ctr 2016-04-18 15:32:46 +08:00
version.go Bump to version 0.2.0 2016-04-14 14:28:13 -07:00

containerd

containerd is a daemon to control runC, built for performance and density. containerd leverages runC's advanced features such as seccomp and user namespace support as well as checkpoint and restore for cloning and live migration of containers.

Getting started

The easiest way to start using containerd is to download binaries from the releases page.

The included ctr command-line tool allows you interact with the containerd daemon:

$ sudo ctr containers start redis /containers/redis
$ sudo ctr containers list
ID                  PATH                STATUS              PROCESSES
redis               /containers/redis   running             14063

/containers/redis is the path to an OCI bundle. See the docs for more information.

Docs

All documentation is contained in the /docs directory in this repository.

Building

You will need to make sure that you have Go installed on your system and the containerd repository is cloned in your $GOPATH. You will also need to make sure that you have all the dependencies cloned as well. Currently, contributing to containerd is not for the first time devs as many dependencies are not vendored and work is being completed at a high rate.

After that just run make and the binaries for the daemon and client will be localed in the bin/ directory.

Performance

Starting 1000 containers concurrently runs at 126-140 containers per second.

Overall start times:

[containerd] 2015/12/04 15:00:54   count:        1000
[containerd] 2015/12/04 14:59:54   min:          23ms
[containerd] 2015/12/04 14:59:54   max:         355ms
[containerd] 2015/12/04 14:59:54   mean:         78ms
[containerd] 2015/12/04 14:59:54   stddev:       34ms
[containerd] 2015/12/04 14:59:54   median:       73ms
[containerd] 2015/12/04 14:59:54   75%:          91ms
[containerd] 2015/12/04 14:59:54   95%:         123ms
[containerd] 2015/12/04 14:59:54   99%:         287ms
[containerd] 2015/12/04 14:59:54   99.9%:       355ms

Roadmap

The current roadmap and milestones for alpha and beta completion are in the github issues on this repository. Please refer to these issues for what is being worked on and completed for the various stages of development.

Copyright © 2016 Docker, Inc. All rights reserved, except as follows. Code is released under the Apache 2.0 license. The README.md file, and files in the "docs" folder are licensed under the Creative Commons Attribution 4.0 International License under the terms and conditions set forth in the file "LICENSE.docs". You may obtain a duplicate copy of the same license, titled CC-BY-SA-4.0, at http://creativecommons.org/licenses/by/4.0/.