Skip to content

bkabrda/atomicapp-builder

Repository files navigation

Atomicapp Builder

Build Status Code Health Coverage Status

An application to build application images from Nulecule.

Usage:

atomicapp-builder build [-h] [--cccp-index CCCP_INDEX]
                             [--build-image BUILD_IMAGE]
                             [--docker-registry DOCKER_REGISTRY]
                             [--registry-insecure] [--check-binar-images]
                             [--keep-tmpdir] [--skip-if-in-registry]
                             [-q | -v]
                             PATH | cccp:<app-id>

positional arguments:
  PATH | cccp:<app-id>  Path to directory with Nulecule file to build or app id prefixed by "cccp:"

optional arguments:
  -h, --help            show this help message and exit
  --cccp-index CCCP_INDEX
                        URI of raw cccp index file (can be file:// for local file), defaults to
                        https://raw.githubusercontent.com/kbsingh/cccp-index/master/index.yml
  --build-image BUILD_IMAGE
                        Name of image that Dock should use to build images (defaults to "atomic-reactor")
  --docker-registry DOCKER_REGISTRY
                        URL of Docker registry to poll for existing images and
                        push built images to. Must be without http/https
                        scheme.
  --registry-insecure   If used, plain http will be used to connect to
                        registry instead of https
  --check-binary-images
                        Check whether binary images are obtainable from given
                        registry
  --keep-tmpdir         Keep tmpdir with sources of all the resolved apps and
                        print a path to it
  --skip-if-in-registry
                        Skip building images that are available in provided
  -q, --quiet           Only output names of built images after build is done
  -v, --verbose         Print lots of debugging information

Note: checking for binary images for an application expects usage of Nulecule Images extension.

Requires anymarkup, atomic_reactor and requests. You can get the requirements just by typing pip install --user -r requirements.txt. This also requires Atomic Reactor build image. You can either get one by docker pull slavek/atomic-reactor or you can build one yourself.

You can get stable versions from PyPI by using

pip install --user atomicapp-builder