You may want to trigger a Plan build when another Plan's build has successfully completed. This ensures that changes to any Job's source code associated with one Plan does not break the build of another dependent Plan (known in this context as a 'child' Plan).
For example, there could be two Plans in Bamboo:
In this scenario, the Acme – Plugin Plan is a child of Acme – Core. Any changes to source code associated with the Acme – Core Plan should trigger a build of Acme – Plugin. In turn, every time a Acme – Plugin Plan build completes successfully, you may want to run builds for some additional Plans (e.g Acme – Functional Tests and Acme – Unit Tests). In this case, Acme – Plugin is a parent of the Acme – Functional Tests and Acme – Unit Tests Plans, as well as being a child of the Acme – Core Plan.
On this page:
To trigger a build when another build finishes:
Automatic Dependency Management is a feature for users who use Maven 2 and wish for their Parent and Child dependencies to be setup according to the dependencies in the Maven pom.xml. Every time the plan is run, the Bamboo Automatic Dependencies are updated to reflect any additions or removals of Maven dependencies.
To setup Automatic Dependency Management:
Click Add Task and add the Maven Dependency Processor task to the job. For best results, ensure that the task runs last by dragging it to the bottom of the task list. For more information on configuring tasks, see Configuring Tasks.
| 設定 | 注意 |
|---|---|
| プロジェクト ファイルのオーバーライド | オプション。プロジェクト ファイル(pom.xml)のある作業ディレクトリまたはサブ作業ディレクトリに対する相対位置。 |
| Working Sub Directory | オプション。タスクがプロジェクト ファイル(pom.xml)を探すサブ ディレクトリ。 |
| 別の settings.xml の場所 | オプション。タスクが特定の Maven リポジトリからの依存関係を解決する必要がある場合に使用される別の settings.xml を指定します。 |
| Maven ローカル リポジトリのパス | オプション。依存関係の解決に使用するタスクのローカル Maven リポジトリのフル パスを指定します。 |
Dependency blocking is a advanced feature of dependent build triggering that can be used to manage Plan builds with parent build dependencies. This ensures that a "tree" of dependent builds always runs in tree hierarchy order, even if child Plan builds are triggered independently of their parents. For more information, see Dependency Blocking Strategies. Please note, dependency blocking only works when the Plan uses a build strategy based on source code updates.
Build dependencies work together with the build strategies of plans to trigger builds of these plans. For example, you can set up Plan A to poll its repository for changes as well as configure a build dependency on a parent plan (Plan B). In this case, builds of Plan A will be triggered when code changes are detected in its repository and also when builds of Plan B complete successfully.
If you want your builds to only be triggered by successful parent builds from your build dependencies, you can do this by specifying Manual as the build strategy for your plan. See Triggering a Plan Build Manually.
4 Comments
Anonymous
Jan 18, 2011Hmmm... am I the only one to think that these terms parent and child kind of oddly defined in Bamboo. I think they in other areas in sw development there meaning is vice-versa? And also maybe parent and child are not good terms to be used for dependencies.
Anonymous
Jul 21, 2011I agree, these child and parent terms are confusing.
Anonymous
Aug 12, 2011How do we get the Artifact Sharing to come up? I don't see that when I look and I'm on 3.2. Under Manual Dependency I only see a list of all the plans and I can choose plans to be a child or parent of the plan I'm on?
Anonymous
Feb 27, 2012Is it possible for a plan to have two parents, but only be triggered on successful completion of both?
Here's my scenario:
Build Plan
TestA Plan
TestB Plan
Publish Plan
The "Build" plan triggers two children, "TestA" and "TestB". (These are different kinds of tests, and we want to run them in parallel for speed and resource reasons)
Now, I only want "Publish" to run if the two "Test" plans succeed. I can see that I can make both "TestA" and "TestB" be parents of "Publish", but "Publish" gets run when the first of his parents completes, which isn't what I want.
Any documentation on how to implement this kind of scheme in Bamboo 3.3?