builds.md

Build Tasks

You can queue, show, and list builds using tfx.

Queue

Queues a build for a given project with a given definition.

Options

--project <string>         - Required. The name of the project to queue a build for.
AND
--definition-id <number>    - The id of the build definition to build against.
OR
--definition-name <string>  - The name of the build definition to build against.

Example

~$ tfx build queue --project MyProject --definition-name TestDefinition
Copyright Microsoft Corporation

Queued new build:
id              : 1
definition name : TestDefinition
requested by    : Teddy Ward
status          : NotStarted
queue time      : Fri Aug 21 2015 15:07:49 GMT-0400 (Eastern Daylight Time)

Show

Shows information for a given build.

Options

--project <string> - Required. The name of the project to queue a build for.
--id <number>      - Required. The id of the build to show.

Example

$ tfx build show --project MyProject --id 1
Copyright Microsoft Corporation


id              : 1
definition name : TestDefinition
requested by    : Teddy Ward
status          : NotStarted
queue time      : Fri Aug 21 2015 15:07:49 GMT-0400 (Eastern Daylight Time)

List

Queries for a list of builds.

Options

--project <string>        - Required. The name of the project to queue a build for.
--defintion-id <number>    - The id of a build definition.
--definition-name <string> - The name of a build definition.
--status <string>         - The status of the build (eg: NotStarted, Completed).
--top <number>            - Show the first X builds that satisfy the other query criteria.

Example

~$ tfx build list

Copyright Microsoft Corporation

...

id              : 1
definition name : TestDefinition
requested by    : Teddy Ward
status          : NotStarted
queue time      : Fri Aug 21 2015 15:07:49 GMT-0400 (Eastern Daylight Time)