meta-intel-clear-containers - Layer enabling Intel Clear Containers

This layer enables the clear containers runtime (cc-runtime) for Docker:

Details about the Clear Containers project can be found at:

https://github.com/clearcontainers/runtime

https://clearlinux.org/features/intel%C2%AE-clear-containers

Dependencies
============

This layer depends on:

  URL: git://git.yoctoproject.org/poky.git
  layers: meta meta-poky meta-yocto-bsp
  branch: master

  URL: git://git.openembedded.org/meta-openembedded
  layers: meta-oe meta-python meta-networking meta-filesystems
  branch: master

  URI: git://git.yoctoproject.org/meta-virtualization
  branch: master

Patches
=======

Please submit any patches for meta-intel-clear-containers layer to the
meta-intel mailing list (meta-intel@yoctoproject.org):


Table of Contents
=================

  I. Adding the meta-intel-clear-containers layer to your build
 II. Misc


I. Adding the meta-intel-clear-containers layer to your build
=================================================

The clear containers runtime can be added to your images with the cc-runtime recipe.

Example (add to conf/local.conf):
IMAGE_INSTALL_append += " cc-runtime "

In order to use this layer, you need to make the build system aware of
it.

Assuming the meta-intel-clear-containers layer exists at the top-level of your
yocto build tree, you can add it to the build system by adding the
location of the meta-intel-clear-containers layer to bblayers.conf, along with any
other layers needed. e.g.:

  BBLAYERS ?= " \
    /path/to/yocto/meta \
    /path/to/yocto/meta-poky \
    /path/to/yocto/meta-yocto-bsp \
    /path/to/yocto/meta-openembedded/meta-oe \
    /path/to/yocto/meta-openembedded/meta-python \
    /path/to/yocto/meta-openembedded/meta-networking \
    /path/to/yocto/meta-openembedded/meta-filesystems \
    /path/to/yocto/meta-virtualization  \
    /path/to/yocto/meta-intel-clear-containers \
    "

II. Misc
========
* Clear Containers depends on the following kernel module.
It will be automatically enabled for 3.9.* and 3.10.* kernels

CONFIG_VHOST_NET=m

* To modify the amount of memory available to QEMU. Add the following variable to your conf/local.conf

QEMU_CC_MEM = "1024"

* When building docker with clear containers support, the default docker runtime will be set to runc. To change the default docker runtime, please modify the docker.service file and restart docker.

Example for runc (docker.service):
ExecStart=/usr/bin/dockerd -D --add-runtime cc-runtime=/usr/local/bin/cc-runtime --default-runtime=cc-runtime -H fd://