QuickBuild Documentation
|
PrerequisitesQuickBuild utilizes the Mercurial command (hg) to interact with remote Mercurial repository. If this command is not in system path, you will need to specify location of the command by configuring Mercurial plugin as below: Further more, Mercurial command (hg) location can be specified on a per-node basis by following below steps:
NOTE: example above is just for demonstration, you can use any other user attribute name instead of hgPath. Creating a Mercurial RepositoryYou may refer to this page on how to add a repository. Supported URL prefixesCurrently, below URL prefixes are supported:
If https is used, and your credential need password, you need first add the credential manually to the nodes which you want check out code to. Proof build supportYour developers might need to push their local commits in local branches to a central official Mercurial repository occasionally. In this case, QuickBuild can validate these outgoing changes by running proof build before pushing them. Test proof build as administratorSince proof build set up is a bit tricky, we first set up proof build for the administrator account and make sure it works before we proceed to enable it for all developers. To set up proof build for administrator, please follow below steps:
Now proof build has been enabled for your account, please make some local commits into your local repository specified above, and then run the test configuration. If set up correctly, your local commits will be picked up and reflected in the build result. A local change tab will also appear to display local commits after build finishes. Your local commits will be pushed automatically if build is successful. Enable proof build for all developersNow that we have a concept of how proof build works. In order to get proof build works for all developers, we need to parameterize various proof build properties, so that different properties can be used for different developers. To do this, you will need to:
At last we suggest to set up the configuration to enable concurrent builds so that multiple builds in the same configuration can run concurrently. This is vital to get fast feedback in case multiple developers are requesting proof builds in the same time. |