Skip to content

Latest commit

 

History

History
72 lines (59 loc) · 3.29 KB

pouch_create.md

File metadata and controls

72 lines (59 loc) · 3.29 KB
Raw

pouch create

Create a new container with specified image

Synopsis

Create a static container object in Pouchd. When creating, all configuration user input will be stored in memory store of Pouchd. This is useful when you wish to create a container configuration ahead of time so that Pouchd will preserve the resource in advance. The container you created is ready to start when you need it.

pouch create [OPTIONS] IMAGE [ARG...]

Examples

$ pouch create --name foo busybox:latest
container ID: e1d541722d68dc5d133cca9e7bd8fd9338603e1763096c8e853522b60d11f7b9, name: foo

Options

      --blkio-weight uint16         Block IO (relative weight), between 10 and 1000, or 0 to disable
      --blkio-weight-device value   Block IO weight (relative device weight) (default [])
      --cap-add strings             Add Linux capabilities
      --cap-drop strings            Drop Linux capabilities
      --cpu-share int               CPU shares
      --cpuset-cpus string          CPUs in cpuset
      --cpuset-mems string          MEMs in cpuset
      --device strings              Add a host device to the container
      --device-read-bps value       Limit read rate (bytes per second) from a device (default [])
      --device-read-iops value      Limit read rate (IO per second) from a device (default [])
      --device-write-bps value      Limit write rate (bytes per second) from a device (default [])
      --device-write-iops value     Limit write rate (IO per second) from a device (default [])
      --enableLxcfs                 Enable lxcfs
      --entrypoint string           Overwrite the default entrypoint
  -e, --env strings                 Set environment variables for container
  -h, --help                        help for create
      --hostname string             Set container's hostname
      --ipc string                  IPC namespace to use
  -l, --label strings               Set label for a container
  -m, --memory string               Container memory limit
      --memory-swap string          Container swap limit
      --memory-wappiness int        Container memory swappiness [0, 100] (default -1)
      --name string                 Specify name of container
      --net strings                 Set networks to container
      --pid string                  PID namespace to use
      --privileged                  Give extended privileges to the container
      --restart string              Restart policy to apply when container exits
      --runtime string              Specify oci runtime
      --security-opt strings        Security Options
      --sysctl strings              Sysctl options
  -t, --tty                         Allocate a tty device
      --uts string                  UTS namespace to use
  -v, --volume strings              Bind mount volumes to container
  -w, --workdir string              Set the working directory in a container

Options inherited from parent commands

  -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

SEE ALSO

  • pouch - An efficient container engine