Add ability to trigger manual builds

cli/build/build.go

@@ -23,5 +23,6 @@ var Command = &cli.Command{
 		buildQueueCmd,
 		buildKillCmd,
 		buildPsCmd,
+		buildCreateCmd,
 	},
 }

cli/build/build_create.go

@@ -0,0 +1,78 @@
+package build
+
+import (
+	"os"
+	"strings"
+	"text/template"
+
+	"github.com/woodpecker-ci/woodpecker/woodpecker-go/woodpecker"
+
+	"github.com/urfave/cli/v2"
+
+	"github.com/woodpecker-ci/woodpecker/cli/common"
+	"github.com/woodpecker-ci/woodpecker/cli/internal"
+)
+
+var buildCreateCmd = &cli.Command{
+	Name:      "create",
+	Usage:     "create new build",
+	ArgsUsage: "<repo/name>",
+	Action:    buildCreate,
+	Flags: append(common.GlobalFlags,
+		common.FormatFlag(tmplBuildList),
+		&cli.StringFlag{
+			Name:     "branch",
+			Usage:    "branch to create build from",
+			Required: true,
+		},
+		&cli.StringSliceFlag{
+			Name:  "var",
+			Usage: "<key>=<value>",
+		},
+	),
+}
+
+func buildCreate(c *cli.Context) error {
+	repo := c.Args().First()
+
+	owner, name, err := internal.ParseRepo(repo)
+	if err != nil {
+		return err
+	}
+
+	client, err := internal.NewClient(c)
+	if err != nil {
+		return err
+	}
+
+	branch := c.String("branch")
+	variables := make(map[string]string)
+
+	for _, vaz := range c.StringSlice("var") {
+		sp := strings.SplitN(vaz, "=", 2)
+		if len(sp) == 2 {
+			variables[sp[0]] = sp[1]
+		}
+	}
+
+	options := &woodpecker.BuildOptions{
+		Branch:    branch,
+		Variables: variables,
+	}
+
+	build, err := client.BuildCreate(owner, name, options)
+	if err != nil {
+		return err
+	}
+
+	tmpl, err := template.New("_").Parse(c.String("format") + "\n")
+	if err != nil {
+		return err
+	}
+
+	if err := tmpl.Execute(os.Stdout, build); err != nil {
+		return err
+	}
+
+	return nil
+}

docs/docs/20-usage/20-pipeline-syntax.md

@@ -348,10 +348,10 @@ when:
 :::info
 **By default steps are filtered by following event types:**
 
-`push`, `pull_request`, `tag`, `deployment`.
+`push`, `pull_request`, `tag`, `deployment`, `manual`.
 :::
 
-Available events: `push`, `pull_request`, `tag`, `deployment`, `cron`
+Available events: `push`, `pull_request`, `tag`, `deployment`, `cron`, `manual`
 
 Execute a step if the build event is a `tag`: