Create a new container and start it
Create a container object in Pouchd, and start the container. This is useful when you just want to use one command to start a container.
pouch run [OPTIONS] IMAGE [ARG...]
$ pouch run --name test registry.hub.docker.com/library/busybox:latest echo "hi"
hi
$ pouch ps -a
Name ID Status Image Runtime Created
test 23f852 stopped registry.hub.docker.com/library/busybox:latest runc 4 seconds ago
$ pouch run -d --name test registry.hub.docker.com/library/busybox:latest
90719b5f9a455b3314a49e72e3ecb9962f215e0f90153aa8911882acf2ba2c84
$ pouch ps -a
Name ID Status Image Runtime Created
test 90719b stopped registry.hub.docker.com/library/busybox:latest runc 5 seconds ago
$ pouch run --device /dev/zero:/dev/testDev:rwm --name test registry.hub.docker.com/library/busybox:latest ls -l /dev/testDev
crw-rw-rw- 1 root root 1, 3 Jan 8 09:40 /dev/testnull
--add-host stringArray Add a custom host-to-IP mapping (host:ip)
--annotation stringArray Additional annotation for runtime
-a, --attach Attach container's STDOUT and STDERR
--blkio-weight uint16 Block IO (relative weight), between 10 and 1000, or 0 to disable
--blkio-weight-device strings Block IO weight (relative device weight), need CFQ IO Scheduler enable (default [])
--cap-add strings Add Linux capabilities
--cap-drop strings Drop Linux capabilities
--cgroup-parent string Optional parent cgroup for the container
--cpu-period int Limit CPU CFS (Completely Fair Scheduler) period, range is in [1000(1ms),1000000(1s)]
--cpu-quota int Limit CPU CFS (Completely Fair Scheduler) quota, range is in [1000,∞)
--cpu-shares int CPU shares (relative weight)
--cpuset-cpus string CPUs in which to allow execution (0-3, 0,1)
--cpuset-mems string MEMs in which to allow execution (0-3, 0,1)
-d, --detach Run container in background and print container ID
--detach-keys string Override the key sequence for detaching a container
--device strings Add a host device to the container
--device-read-bps strings Limit read rate (bytes per second) from a device (default [])
--device-read-iops strings Limit read rate (IO per second) from a device (default [])
--device-write-bps strings Limit write rate (bytes per second) from a device (default [])
--device-write-iops strings Limit write rate (IO per second) from a device (default [])
--disable-network-files Disable the generation of network files(/etc/hostname, /etc/hosts and /etc/resolv.conf) for container. If true, no network files will be generated. Default false
--disk-quota strings Set disk quota for container
--dns stringArray Set DNS servers
--dns-option strings Set DNS options
--dns-search stringArray Set DNS search domains
--enableLxcfs Enable lxcfs for the container, only effective when enable-lxcfs switched on in Pouchd
--entrypoint string Overwrite the default ENTRYPOINT of the image
-e, --env stringArray Set environment variables for container('--env A=' means setting env A to empty, '--env B' means removing env B from container env inherited from image)
--env-file stringArray Read in a file of environment variables
--expose strings Set expose container's ports
--group-add strings Add additional groups to join
-h, --help help for run
--hostname string Set container's hostname
--initscript string Initial script executed in container
--intel-rdt-l3-cbm string Limit container resource for Intel RDT/CAT which introduced in Linux 4.10 kernel
-i, --interactive Attach container's STDIN
--ip string Set IPv4 address of container endpoint
--ip6 string Set IPv6 address of container endpoint
--ipc string IPC namespace to use
--kernel-memory string Kernel memory limit (in bytes)
-l, --label stringArray Set labels for a container
--log-driver string Logging driver for the container (default "json-file")
--log-opt stringArray Log driver options
--mac-address string Set mac address of container endpoint
-m, --memory string Memory limit
--memory-reservation string Memory soft limit
--memory-swap string Swap limit equal to memory + swap, '-1' to enable unlimited swap
--memory-swappiness int Container memory swappiness [0, 100]
--name string Specify name of container
--net strings Set networks to container
--net-priority int net priority
--nvidia-capabilities string NvidiaDriverCapabilities controls which driver libraries/binaries will be mounted inside the container
--nvidia-visible-devs string NvidiaVisibleDevices controls which GPUs will be made accessible inside the container
--oom-kill-disable Disable OOM Killer
--oom-score-adj int Tune host's OOM preferences (-1000 to 1000) (default -500)
--pid string PID namespace to use
--pids-limit int Set container pids limit
--privileged Give extended privileges to the container
-p, --publish strings Set container ports mapping
-P, --publish-all Publish all exposed ports to random ports
--quota-id string Specified quota id, if id < 0, it means pouchd alloc a unique quota id
--restart string Restart policy to apply when container exits
--rich Start container in rich container mode. (default false)
--rich-mode string Choose one rich container mode. dumb-init(default), systemd, sbin-init
--rm Automatically remove the container after it exits
--runtime string OCI runtime to use for this container
--security-opt strings Security Options
--shm-size string Size of /dev/shm, default value is 64MB
--specific-id string Specify id of container, length of id should be 64, characters of id should be in '0123456789abcdef'
--sysctl strings Sysctl options
-t, --tty Allocate a pseudo-TTY
--ulimit ulimit Set container ulimit (default [])
-u, --user string UID
--uts string UTS namespace to use
-v, --volume volumes Bind mount volumes to container, format is: [source:]<destination>[:mode], [source] can be volume or host's path, <destination> is container's path, [mode] can be "ro/rw/dr/rr/z/Z/nocopy/private/rprivate/slave/rslave/shared/rshared" (default [])
--volume-driver string set volume driver for container's volumes
--volumes-from strings set volumes from other containers, format is <container>[:mode]
-w, --workdir string Set the working directory in a container
-D, --debug Switch client log level to DEBUG mode
-H, --host string Specify connecting address of Pouch CLI (default "unix:///var/run/pouchd.sock")
--tlscacert string Specify CA file of TLS
--tlscert string Specify cert file of TLS
--tlskey string Specify key file of TLS
--tlsverify Use TLS and verify remote
- pouch - An efficient container engine