Install GO:

brew install go

Export GOPATH and add to PATH the $GOPATH/bin directory:

Get cloudbreak-deployer project with GO:

go get -d github.com/hortonworks/cloudbreak-deployer

Development process happens on separate branches. Open a pull-request to contribute your changes.

To build the project:

cd $GOPATH/src/github.com/hortonworks/cloudbreak-deployer
# make deps and bindata only need to be run once
make bindata
make deps
make install

To run the unit tests:

make tests

We recommend that you always use the latest release, but you might also want to check new features or bugfixes in the master branch. All successful builds from the master branch are uploaded to the public S3 bucket. You can download it using:

curl -s https://raw.githubusercontent.com/hortonworks/cloudbreak-deployer/master/install-dev | sh && cbd --version

Instead of overwriting the released version, download it to a local directory and use it by referring to it as ./cbd

./cbd --version

Shell scripts shouldn’t raise exceptions when it comes to unit testing. basht is used for testing. See this link to learn why not bats or shunit2.

You must cover your bash functions with unit tests and run the test with:

make tests

The master branch is always built on Jenkins.

When you want to create a new release, run:

make release-next-ver

The make release-next-ver performs the following steps:

• On the master branch:
  • Updates the VERSION file by increasing the patch version number (For example, from 0.5.2 to 0.5.3).
  • Updates CHANGELOG.md with the release date.
  • Creates a new Unreleased section at the top of CHANGELOG.md.
• Creates a PullRequest for the release branch:
  • Creates a new branch with a name like release-0.5.x.
  • This branch should be the same as origin/master.
  • Creates a pull request on the release branch.

Now you should test this release. You can update to it by running curl -L -s https://github.com/hortonworks/cloudbreak-deployer/archive/release-x.y.z.tar.gz | tar -xz -C $(dirname $(which cbd)). Comment with LGTM (Looking Good To Me).

Once the PR is merged, CircleCI will build it:

• Create a new release on GitHub releases tab, with the help of gh-release.
• Create the git tag with v prefix like: v0.0.3.