2016-09-28 18:33:53 +00:00
% ocid(8) Open Container Initiative Daemon
% Dan Walsh
% SEPTEMBER 2016
# NAME
ocid - Enable OCI Kubernetes Container Runtime daemon
# SYNOPSIS
**ocid**
2016-10-13 13:25:31 +00:00
[**--config**=[*value*]]
2016-09-28 19:49:46 +00:00
[**--conmon**=[*value*]]
2016-09-28 18:33:53 +00:00
[**--debug**]
2016-10-18 14:48:33 +00:00
[**--default-transport**=[*value*]]
2016-10-07 18:52:24 +00:00
[**--help**|**-h**]
2016-10-09 17:36:43 +00:00
[**--listen**=[*value*]]
2016-09-28 18:33:53 +00:00
[**--log**=[*value*]]
[**--log-format value**]
2016-10-18 14:48:33 +00:00
[**--pause-command**=[*value*]]
[**--pause-image**=[*value*]]
2016-10-07 18:52:24 +00:00
[**--root**=[*value*]]
2016-10-18 14:48:33 +00:00
[**--runroot**=[*value*]]
2016-10-07 18:52:24 +00:00
[**--runtime**=[*value*]]
2016-10-18 14:48:33 +00:00
[**--signature-policy**=[*value*]]
[**--storage-driver**=[*value*]]
2017-02-24 22:05:07 +00:00
[**--storage-opt**=[*value*]]
2016-10-09 17:36:43 +00:00
[**--selinux**]
2016-11-23 09:41:48 +00:00
[**--seccomp-profile**=[*value*]]
2016-11-30 08:36:07 +00:00
[**--apparmor-profile**=[*value*]]
2016-12-17 11:23:07 +00:00
[**---cni-config-dir**=[*value*]]
[**---cni-plugin-dir**=[*value*]]
2016-09-28 18:33:53 +00:00
[**--version**|**-v**]
# DESCRIPTION
OCI-based implementation of Kubernetes Container Runtime Interface Daemon
ocid is meant to provide an integration path between OCI conformant runtimes and the kubelet. Specifically, it implements the Kubelet Container Runtime Interface (CRI) using OCI conformant runtimes. The scope of ocid is tied to the scope of the CRI.
* Support multiple image formats including the existing Docker image format
* Support for multiple means to download images including trust & image verification
* Container image management (managing image layers, overlay filesystems, etc)
* Container process lifecycle management
* Monitoring and logging required to satisfy the CRI
* Resource isolation as required by the CRI
2016-10-09 17:36:43 +00:00
**ocid [GLOBAL OPTIONS]**
2016-09-28 18:33:53 +00:00
2016-10-09 17:36:43 +00:00
**ocid [GLOBAL OPTIONS] config [OPTIONS]**
# GLOBAL OPTIONS
2016-09-28 18:33:53 +00:00
2016-10-18 14:48:33 +00:00
**--apparmor_profile**=""
Name of the apparmor profile to be used as the runtime's default (default: "ocid-default")
2016-10-13 13:25:31 +00:00
**--config**=""
path to configuration file
2016-09-28 19:49:46 +00:00
**--conmon**=""
2017-03-29 14:17:38 +00:00
path to the conmon executable (default: "/usr/local/libexec/ocid/conmon")
2016-09-28 19:49:46 +00:00
2016-09-28 18:33:53 +00:00
**--debug**
Enable debug output for logging
2016-10-18 14:48:33 +00:00
**--default-transport**
A prefix to prepend to image names that can't be pulled as-is.
2016-10-07 18:52:24 +00:00
**--help, -h**
Print usage statement
2016-10-09 17:36:43 +00:00
**--listen**=""
Path to ocid socket (default: "/var/run/ocid.sock")
2016-09-28 18:33:53 +00:00
**--log**=""
Set the log file path where internal debug information is written
**--log-format**=""
Set the format used by logs ('text' (default), or 'json') (default: "text")
2016-10-18 14:48:33 +00:00
**--pause-command**=""
Path to the pause executable in the pause image (default: "/pause")
**--pause-image**=""
Image which contains the pause executable (default: "kubernetes/pause")
2016-10-07 18:52:24 +00:00
**--root**=""
2017-03-16 21:28:54 +00:00
OCID root dir (default: "/var/lib/containers/storage")
2016-10-18 14:48:33 +00:00
**--runroot**=""
2017-03-16 21:28:54 +00:00
OCID state dir (default: "/var/run/containers/storage")
2016-10-07 18:52:24 +00:00
**--runtime**=""
OCI runtime path (default: "/usr/bin/runc")
2016-11-30 08:36:07 +00:00
**--selinux**=*true*|*false*
2016-10-09 17:36:43 +00:00
Enable selinux support (default: false)
2016-09-28 18:33:53 +00:00
2016-10-18 14:48:33 +00:00
**--seccomp-profile**=""
2016-11-23 09:41:48 +00:00
Path to the seccomp json profile to be used as the runtime's default (default: "/etc/ocid/seccomp.json")
2016-10-18 14:48:33 +00:00
**--signature-policy**=""
Path to the signature policy json file (default: "", to use the system-wide default)
**--storage-driver**
OCI storage driver (default: "devicemapper")
2017-02-24 22:05:07 +00:00
**--storage-opt**
2016-10-18 14:48:33 +00:00
OCI storage driver option (no default)
2016-11-30 08:36:07 +00:00
2016-12-17 11:23:07 +00:00
**--cni-config-dir**=""
2016-10-18 14:48:33 +00:00
CNI configuration files directory (default: "/etc/cni/net.d/")
2016-12-17 11:23:07 +00:00
**--cni-plugin-dir**=""
2016-10-18 14:48:33 +00:00
CNI plugin binaries directory (default: "/opt/cni/bin/")
2016-12-17 11:23:07 +00:00
2016-09-28 18:33:53 +00:00
**--version, -v**
Print the version
2016-10-09 17:36:43 +00:00
# COMMANDS
OCID's default command is to start the daemon. However, it currently offers a
single additional subcommand.
## config
Outputs a commented version of the configuration file that would've been used
by OCID. This allows you to save you current configuration setup and then load
it later with ** --config**. Global options will modify the output.
**--default**
Output the default configuration (without taking into account any configuration options).
# SEE ALSO
ocid.conf(5)
2016-09-28 18:33:53 +00:00
# HISTORY
2016-10-09 17:36:43 +00:00
Sept 2016, Originally compiled by Dan Walsh < dwalsh @ redhat . com > and Aleksa Sarai < asarai @ suse . de >