# SYNOPSIS
Run Ado pipelines and list builds using `azure devops cli`
# INSTALL
$ s6 --install ado-pipeline-build
# USAGE
Queue pipeline build for the current branch:
$ s6 --plg-run ado-pipeline-build@name=WebApp,action=run
List builds for the current branch and pipeline WebApp:
$ s6 --plg-run ado-pipeline-build@action=list,name=WebApp
Use as Sparrow6 tasks:
# queue new build
my %state = task_run "run my build", "ado-pipeline-build", %(
name => "WebApp",
variables => "foo:1 bar:2"
action => "run"
);
# wait till the my build finishes
task_run "wait my build", "ado-pipeline-build", %(
action => "wait",
build_id => %state<build_id>
);
# list all builds for given build definition and current branch
task_run "last builds", "ado-pipeline-build", %(
name => "WebApp",
action => "list"
);
# Parameters
## name
Ado pipeline definition name
## action
Action to execute. `run|list|wait`. Default value is `list` ( list builds )
* `run`
Run build.
* `wait`
Wait till build has finished. Should supply `build_id`
* `list`
List all builds for given build definition and current branch
## project
Set Ado project for a pipeline to run. Optional.
## branch
Git branch to run a build against. If not set current branch is taken
## verbose
Set verbosity for `action=wait`, by default is `False` ( verbosity is disabled )
## variables
Ado variables being set for a build run. Variables format:
```
var1_name:$var_value
var2_name:$var_value
var3_name:$var_value
```
# Dependencies
* powershell
* azure devops cli
# See also
[azure devops cli](https://docs.microsoft.com/en-us/azure/devops/cli/get-started?view=azure-devops)
# Author
Alexey Melezhik