composable

Synopsis

A tool for generating a docker compose file based on git repo branches

Installing

$ make deps
$ make install

Tests

Running the tests:

make test

Usage

Generating a docker-compose file for testing

To generate a docker-compose file (default: docker-compose.yml), run the following command:

# community edition
$ composable generate definition.yml template.yml

# enterprise edition
$ composable generate --edition enterprise definition.yml template.yml

This will deploy git repos to the deployment directory (default: /tmp/composable). Please note, this directory must exist!

To override a specific branch in the definition yaml, you can run:

$ composable generate -b REPONAME:BRANCH definition.yml template.yml

Substitutiong REPONAME for the name of the repo and BRANCH for the desired branch you want to use.

For further options, you can run:

$ composable --help

Running a release

To create a release and publish images to a container registry, you can run:

$ composable release -v 1.x.x -L quay.io -O ernest definition.yml template.yml

This will:

• Clone all repositories
• Build all docker images, tagged as the release version
• Upload all docker images to the container registry
• Create a release docker-compose file with images tagged to the release version

Please note, you will be asked for your docker credentials upon running this command

Contributing

Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.

Moreover, if your pull request contains patches or features, you must include relevant unit tests.

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, this project is maintained under the Semantic Versioning guidelines.

Copyright and License

Code and documentation copyright since 2015 r3labs.io authors.

Code released under the Mozilla Public License Version 2.0.