Create Build
- 14 May 2021
- 1 Minute to read
- Print
- DarkLight
- PDF
Create Build
- Updated on 14 May 2021
- 1 Minute to read
- Print
- DarkLight
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
This is generated from the built in components of BuildMaster 7.0.0, and may be different than what you have installed (especially if you have extensions); go to [User Icon] -> Documentation within your BuildMaster instance to see exactly what operations are available.
Create Build
Creates a new build in BuildMaster of an application, and optionally waits for it to complete.
Script usage:
Create-Build( Application: <text>, [ReleaseNumber: <text>], [Pipeline: <text>], [Variables: <%(key1: value1, ...)>], [ForcePromotion: <true/false>], [Wait: <true/false>], [FailIfCannotCreate: <true/false>], [DeployToFirstStage: <true/false>] );
This operation may be prefixed with BuildMaster::, although this is a built-in namespace and isn't really necessary.
Arguments:
| Name | Format | Script Usage | Usage Notes |
|---|---|---|---|
| ☆ In application | text | Application | This argument is required. |
| For release number | text | ReleaseNumber | This may be a specific release number, "latest" or "all". |
| With pipeline | text | Pipeline | This is used if ReleaseNumber is empty. |
| Build variables | %(key1: value1, ...) | Variables | |
| Force past gate | true/false | ForcePromotion | |
| Wait for execution | true/false | Wait | |
| Fail if nothing created | true/false | FailIfCannotCreate | |
| Deploy to first stage | true/false | DeployToFirstStage |
Note: When all releases is specified, then a build in *each* release will be created.
Note: When FailIfCannotCreate is specified, the execution will halt if there are no valid builds to create; for example, if the targeted release number doesn't exist. Otherwise, a warning will be issued.
Example:
Create-Build
(
Application: Hdars.Packager,
ReleaseNumber: latest,
Variables: %(ReleaseCandidate: true, PackageType: $PackageType)
);Was this article helpful?
