Awesome Open Source
Awesome Open Source

cb - a Container Builder

It builds container images locally using Google Cloud Container Builder config file.

Why not just do docker build? It will be useful to provide an easy way to manage multiple steps builds.

  • We love small docker images:
    • Don't want to contain golang environment. We love a single go binary docker image.
    • Don't Want to contain frontend js build environment for a web app.

What it looks like?

- name:
  args: ["build", "-t", "cb-build", "-f", "", "."]
- name: cb-build
  args: ["cp", "/go/src/cb/cb", "/workspace"]
- name:
  args: ["build", "-t", "cb", "."]

This is an example config file. It will build a golang single binary image of cb command itself (not useful though).

  • 1st step - Build a temporary image. It builds a go binary using golang base image as usual.
  • 2nd step - Run the resulted image of 1st step. It copies the golang binary in the image to workspace volume.
  • 3rd step - Build a final image from scratch. Just add the cb command from workplace volume.
$ docker images
REPOSITORY      TAG          IMAGE ID            CREATED             SIZE
cb              latest       05994f135ea4        2 days ago          3.208 MB
cb-build        latest       61f9b946f604        2 days ago          680.9 MB


go get -u

Make sure you have $GOPATH/bin in your $PATH.


cb SOURCE.tar.gz --config CONFIG.(json|yml)


  • The source field in config will be ignored as well as gcloud alpha container builds create do. Specify SOURCE as 1st argument.
  • The images field in config will be ignored. The cb command is intended for local builds so always pushing images are not supposed to be welcome.

How it works

    1. Create a volume for workspace with docker volume create.
    1. Expand SOURCE into the workspace volume with docker copy.
    1. docker run an image with volumes /var/run/docker.sock//var/run/docker.sock/, WORKSPACE_VOLUME:/workspace.
    • If the image have docker command like this, you can do docker build or anything in container with SOURCE at hand.
    1. Repeat 3) with different image and args as you specifed in steps field of CONFIG.

Do you get it? No? See and run examples, I hope it may help you understand.


make run-example


  • Support wait_for and id fields of steps


Alternatives To Cb
Select To Compare

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Go (171,741
Golang (171,741
Cloud (29,201
Docker Image (12,073
Builder (10,711
Volume (8,205
Container Builder (8