vbatts/containerd
1
0
Fork 0
Code Pull requests Releases Activity

Update README

Browse source 
Signed-off-by: Qiang Huang <h.huangqiang@huawei.com>
This commit is contained in:
Qiang Huang 2016-03-22 13:58:33 +08:00
parent 54c213e8a7
commit f6313ebfaf
1 changed files with 55 additions and 60 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

115
README.md
View file

@ -86,25 +86,20 @@ USAGE:
containerd [global options] command [command options] [arguments...] containerd [global options] command [command options] [arguments...]
VERSION: VERSION:
0.0.4 0.1.0 commit: 54c213e8a719d734001beb2cb8f130c84cc3bd20
AUTHOR(S):
@crosbymichael <crosbymichael@gmail.com>
COMMANDS: COMMANDS:
help, h Shows a list of commands or help for one command help, h Shows a list of commands or help for one command
GLOBAL OPTIONS: GLOBAL OPTIONS:
--id "deathstar" unique containerd id to identify the instance --debug enable debug output in the logs
--debug enable debug output in the logs --state-dir "/run/containerd" runtime state directory
--state-dir "/run/containerd" runtime state directory --metrics-interval "5m0s" interval for flushing metrics to the store
-c, --concurrency "10" set the concurrency level for tasks --listen, -l "/run/containerd/containerd.sock" Address on which GRPC API will listen
--metrics-interval "1m0s" interval for flushing metrics to the store --runtime, -r "runc" name of the OCI compliant runtime to use when executing containers
--listen, -l "/run/containerd/containerd.sock" Address on which GRPC API will listen --graphite-address Address of graphite server
--oom-notify enable oom notifications for containers --help, -h show help
--graphite-address Address of graphite server --version, -v print the version
--help, -h show help
--version, -v print the version
``` ```
# Roadmap # Roadmap
@ -127,37 +122,58 @@ There is a default cli named `ctr` based on the GRPC api.
This cli will allow you to create and manage containers run with containerd. This cli will allow you to create and manage containers run with containerd.
``` ```
$ ctr -h
NAME: NAME:
ctr - High performance container daemon controller ctr - High performance container daemon cli
USAGE: USAGE:
ctr [global options] command [command options] [arguments...] ctr [global options] command [command options] [arguments...]
VERSION: VERSION:
0.0.4 0.1.0 commit: 54c213e8a719d734001beb2cb8f130c84cc3bd20
AUTHOR(S):
@crosbymichael <crosbymichael@gmail.com>
COMMANDS: COMMANDS:
checkpoints list all checkpoints checkpoints list all checkpoints
containers interact with running containers containers interact with running containers
events receive events from the containerd daemon events receive events from the containerd daemon
help, h Shows a list of commands or help for one command state get a raw dump of the containerd state
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS: GLOBAL OPTIONS:
--debug enable debug output in the logs --debug enable debug output in the logs
--address "/run/containerd/containerd.sock" address of GRPC API --address "/run/containerd/containerd.sock" address of GRPC API
--help, -h show help --help, -h show help
--version, -v print the version --version, -v print the version
``` ```
### Starting a container
```
$ ctr containers start -h
NAME:
ctr containers start - start a container
USAGE:
ctr containers start [command options] [arguments...]
OPTIONS:
--checkpoint, -c checkpoint to start the container from
--attach, -a connect to the stdio of the container
--label, -l [--label option --label option] set labels for the container
```
```bash
$ sudo ctr containers start redis /containers/redis
```
Note: `/containers/redis` is the path of bundle you have to prepare before
running a contianer, see [bundle](docs/bundle.md) to get more information.
### Listing containers ### Listing containers
```bash ```bash
$ sudo ctr containers $ sudo ctr containers
ID PATH STATUS PID1 ID PATH STATUS PROCESSES
1 /containers/redis running 14063 1 /containers/redis running 14063
19 /containers/redis running 14100 19 /containers/redis running 14100
14 /containers/redis running 14117 14 /containers/redis running 14117
@ -180,38 +196,18 @@ ID PATH STATUS PID1
0 /containers/redis running 14006 0 /containers/redis running 14006
``` ```
### Starting a container
```
$ ctr containers start -h
NAME:
start - start a container
USAGE:
command start [command options] [arguments...]
OPTIONS:
--checkpoint, -c checkpoint to start the container from
--attach, -a connect to the stdio of the container
```
```bash
$ sudo ctr containers start redis /containers/redis
```
### Kill a container's process ### Kill a container's process
``` ```
$ ctr containers kill -h $ ctr containers kill -h
NAME: NAME:
kill - send a signal to a container or its processes ctr containers kill - send a signal to a container or its processes
USAGE: USAGE:
command kill [command options] [arguments...] ctr containers kill [command options] [arguments...]
OPTIONS: OPTIONS:
--pid, -p "0" pid of the process to signal within the container --pid, -p "init" pid of the process to signal within the container
--signal, -s "15" signal to send to the container --signal, -s "15" signal to send to the container
``` ```
@ -220,20 +216,20 @@ OPTIONS:
``` ```
$ ctr containers exec -h $ ctr containers exec -h
NAME: NAME:
exec - exec another process in an existing container ctr containers exec - exec another process in an existing container
USAGE: USAGE:
command exec [command options] [arguments...] ctr containers exec [command options] [arguments...]
OPTIONS: OPTIONS:
--id container id to add the process to --id container id to add the process to
--pid process id for the new process
--attach, -a connect to the stdio of the container --attach, -a connect to the stdio of the container
--cwd current working directory for the process --cwd current working directory for the process
--tty, -t create a terminal for the process --tty, -t create a terminal for the process
--env, -e [--env option --env option] environment variables for the process --env, -e [--env option --env option] environment variables for the process
--uid, -u "0" user id of the user for the process --uid, -u "0" user id of the user for the process
--gid, -g "0" group id of the user for the process --gid, -g "0" group id of the user for the process
``` ```
### Stats for a container ### Stats for a container
@ -241,10 +237,10 @@ OPTIONS:
``` ```
$ ctr containers stats -h $ ctr containers stats -h
NAME: NAME:
stats - get stats for running container ctr containers stats - get stats for running container
USAGE: USAGE:
command stats [arguments...] ctr containers stats [arguments...]
``` ```
### List checkpoints ### List checkpoints
@ -261,17 +257,16 @@ test2 false false false
``` ```
$ ctr checkpoints create -h $ ctr checkpoints create -h
NAME: NAME:
create - create a new checkpoint for the container ctr checkpoints create - create a new checkpoint for the container
USAGE: USAGE:
command create [command options] [arguments...] ctr checkpoints create [command options] [arguments...]
OPTIONS: OPTIONS:
--tcp persist open tcp connections --tcp persist open tcp connections
--unix-sockets perist unix sockets --unix-sockets perist unix sockets
--exit exit the container after the checkpoint completes successfully --exit exit the container after the checkpoint completes successfully
--shell checkpoint shell jobs --shell checkpoint shell jobs
``` ```
### Get events ### Get events