Files
meta-overc/docs/README.c3_app_container
Mark Asselstine e95f4a71e5 c3-app-container: Initial version of a basic app container
This adds a simple app container image which allows for the creation
of 1 app container image using only a local.conf variable, without the
need to touch any recipe files. As described in the included README
the use of an .inc file will allow users to create additional app
container images with only a few lines in a new image recipe file.

Eventually I would like to have a 'universal' app image which can
allow the building of any application (for which there is a recipe)
into its own container image, without the need to create image
recipes. This is the first (needed) step toward getting to this goal.

Signed-off-by: Mark Asselstine <mark.asselstine@windriver.com>
2018-01-30 17:13:53 -05:00

54 lines
1.8 KiB
Plaintext

c3-app-container
-------------------------
The meta-cube layer comes with a single 'flexible' image called
'c3-app-container'. This image allows you to build a single
application container where you select the application which the image
will contain. Application selection is made via local.conf, by setting
'C3_APP_CONTAINER_APP' to the name of the application.
Building
-------------------------
The image is built using the normal bitbake commands:
%> bitbake c3-app-container
The output will be found in the tmp/deploy/images/* directory
alongside the other images.
Usage
-------------------------
You can use the c3-app-container as an artifact to the cubeit
installer but more likely you will install the image on a running
system. This would be done by copying the image tarball to the target
running OverC and then running the following commands on dom0 or in a
container with bindings to dom0:
# c3 add -n app-container c3-app-container-genericx86-64.tar.bz2
# c3 cfg -o /opt/container/app-container set app:/usr/bin/<your_app> [options]
# c3 start [options] app-container
Image size
-------------------------
The image size will depend on your selected application. As with any
image, bitbake will include any dependencies in the image and as such
the size can easily grow. A small application with no/few dependencies
will result in a image of only a few MB.
Creating more than one app container
-------------------------
The use of the 'c3-app-container' and 'C3_APP_CONTAINER_APP' is
restricted to one application. However, you may use the
c3-app-container.inc in your own image recipe in a similar way
c3-app-container_*.bb does. This will allow you to write your own
application container images in only a few lines, and, any
improvements made to the c3-app-container.inc will immediately be
available in your image.