Support github deploy task

cli/exec/flags.go

@@ -204,6 +204,10 @@ var flags = []cli.Flag{
 		EnvVars: []string{"CI_PIPELINE_TARGET"},
 		Name:    "pipeline-target",
 	},
+	&cli.StringFlag{
+		EnvVars: []string{"CI_PIPELINE_TASK"},
+		Name:    "pipeline-task",
+	},
 	&cli.StringFlag{
 		EnvVars: []string{"CI_COMMIT_SHA"},
 		Name:    "commit-sha",

cli/exec/metadata.go

@@ -61,6 +61,7 @@ func metadataFromContext(c *cli.Context, axis matrix.Axis) metadata.Metadata {
 			Event:    c.String("pipeline-event"),
 			ForgeURL: c.String("pipeline-url"),
 			Target:   c.String("pipeline-target"),
+			Task:     c.String("pipeline-task"),
 			Commit: metadata.Commit{
 				Sha:     c.String("commit-sha"),
 				Ref:     c.String("commit-ref"),

cmd/server/docs/docs.go

@@ -3916,6 +3916,9 @@ const docTemplate = `{
                 "created_at": {
                     "type": "integer"
                 },
+                "deploy_task": {
+                    "type": "string"
+                },
                 "deploy_to": {
                     "type": "string"
                 },

docs/docs/20-usage/50-environment.md

@@ -85,6 +85,7 @@ This is the reference list of all environment variables available to your pipeli
 | `CI_PIPELINE_URL`                | link to the web UI for the pipeline                                                                                |
 | `CI_PIPELINE_FORGE_URL`          | link to the forge's web UI for the commit(s) or tag that triggered the pipeline                                    |
 | `CI_PIPELINE_DEPLOY_TARGET`      | pipeline deploy target for `deployment` events (i.e. production)                                                   |
+| `CI_PIPELINE_DEPLOY_TASK`        | pipeline deploy task for `deployment` events (i.e. migration)                                                      |
 | `CI_PIPELINE_STATUS`             | pipeline status (success, failure)                                                                                 |
 | `CI_PIPELINE_CREATED`            | pipeline created UNIX timestamp                                                                                    |
 | `CI_PIPELINE_STARTED`            | pipeline started UNIX timestamp                                                                                    |
@@ -118,6 +119,7 @@ This is the reference list of all environment variables available to your pipeli
 | `CI_PREV_PIPELINE_URL`           | previous pipeline link in CI                                                                                       |
 | `CI_PREV_PIPELINE_FORGE_URL`     | previous pipeline link to event in forge                                                                           |
 | `CI_PREV_PIPELINE_DEPLOY_TARGET` | previous pipeline deploy target for `deployment` events (ie production)                                            |
+| `CI_PREV_PIPELINE_DEPLOY_TASK`   | previous pipeline deploy task for `deployment` events (ie migration)                                               |
 | `CI_PREV_PIPELINE_STATUS`        | previous pipeline status (success, failure)                                                                        |
 | `CI_PREV_PIPELINE_CREATED`       | previous pipeline created UNIX timestamp                                                                           |
 | `CI_PREV_PIPELINE_STARTED`       | previous pipeline started UNIX timestamp                                                                           |

docs/versioned_docs/version-2.1/20-usage/20-workflow-syntax.md

@@ -803,6 +803,17 @@ when:
   event: deployment
 ```
 
+### `task`
+
+Execute a step for deployment events matching the target deployment task:
+
+```diff
+when:
+  task: migration
+  event: deployment
+```
+
+
 ### `instance`
 
 Execute a step only on a certain Woodpecker instance matching the specified hostname:

pipeline/frontend/metadata/environment.go

@@ -77,6 +77,7 @@ func (m *Metadata) Environ() map[string]string {
 		"CI_PIPELINE_URL":           m.getPipelineWebURL(m.Curr, 0),
 		"CI_PIPELINE_FORGE_URL":     m.Curr.ForgeURL,
 		"CI_PIPELINE_DEPLOY_TARGET": m.Curr.Target,
+		"CI_PIPELINE_DEPLOY_TASK":   m.Curr.Task,
 		"CI_PIPELINE_STATUS":        m.Curr.Status,
 		"CI_PIPELINE_CREATED":       strconv.FormatInt(m.Curr.Created, 10),
 		"CI_PIPELINE_STARTED":       strconv.FormatInt(m.Curr.Started, 10),
@@ -108,6 +109,7 @@ func (m *Metadata) Environ() map[string]string {
 		"CI_PREV_PIPELINE_URL":           m.getPipelineWebURL(m.Prev, 0),
 		"CI_PREV_PIPELINE_FORGE_URL":     m.Prev.ForgeURL,
 		"CI_PREV_PIPELINE_DEPLOY_TARGET": m.Prev.Target,
+		"CI_PREV_PIPELINE_DEPLOY_TASK":   m.Prev.Task,
 		"CI_PREV_PIPELINE_STATUS":        m.Prev.Status,
 		"CI_PREV_PIPELINE_CREATED":       strconv.FormatInt(m.Prev.Created, 10),
 		"CI_PREV_PIPELINE_STARTED":       strconv.FormatInt(m.Prev.Started, 10),

pipeline/frontend/metadata/types.go

@@ -53,6 +53,7 @@ type (
 		Event    string `json:"event,omitempty"`
 		ForgeURL string `json:"forge_url,omitempty"`
 		Target   string `json:"target,omitempty"`
+		Task     string `json:"task,omitempty"`
 		Trusted  bool   `json:"trusted,omitempty"`
 		Commit   Commit `json:"commit,omitempty"`
 		Parent   int64  `json:"parent,omitempty"`

pipeline/frontend/yaml/constraint/constraint.go

@@ -42,6 +42,7 @@ type (
 		Instance    List
 		Platform    List
 		Environment List
+		Task        List
 		Branch      List
 		Cron        List
 		Status      List
@@ -164,6 +165,7 @@ func (c *Constraint) Match(m metadata.Metadata, global bool, env map[string]stri
 
 	match = match && c.Platform.Match(m.Sys.Platform) &&
 		c.Environment.Match(m.Curr.Target) &&
+		c.Task.Match(m.Curr.Task) &&
 		c.Event.Match(m.Curr.Event) &&
 		c.Repo.Match(path.Join(m.Repo.Owner, m.Repo.Name)) &&
 		c.Ref.Match(m.Curr.Commit.Ref) &&

pipeline/frontend/yaml/linter/schema/.woodpecker/test-when.yaml

@@ -76,6 +76,7 @@ steps:
       - echo "test"
     when:
       environment: production
+      task: migration
       event: deployment
 
   when-matrix:

pipeline/frontend/yaml/linter/schema/schema.json

@@ -255,6 +255,10 @@
           "description": "Execute a step only for a specific environment. Read more: https://woodpecker-ci.org/docs/usage/workflow-syntax#environment",
           "$ref": "#/definitions/constraint_list"
         },
+        "task": {
+          "description": "Execute a step only for a specific task. Read more: https://woodpecker-ci.org/docs/usage/pipeline-syntax#task",
+          "$ref": "#/definitions/constraint_list"
+        },
         "instance": {
           "description": "Read more: https://woodpecker-ci.org/docs/usage/workflow-syntax#instance",
           "$ref": "#/definitions/constraint_list"
@@ -438,6 +442,10 @@
           "description": "Execute a step only for a specific environment. Read more: https://woodpecker-ci.org/docs/usage/workflow-syntax#environment",
           "$ref": "#/definitions/constraint_list"
         },
+        "task": {
+          "description": "Execute a step only for a specific task. Read more: https://woodpecker-ci.org/docs/usage/pipeline-syntax#task",
+          "$ref": "#/definitions/constraint_list"
+        },
         "matrix": {
           "description": "Read more: https://woodpecker-ci.org/docs/usage/matrix-workflows",
           "type": "object",

server/api/pipeline.go

@@ -409,6 +409,9 @@ func PostPipeline(c *gin.Context) {
 	// make Deploy overridable
 	pl.Deploy = c.DefaultQuery("deploy_to", pl.Deploy)
 
+	// make Deploy task overridable
+	pl.DeployTask = c.DefaultQuery("deploy_task", pl.DeployTask)
+
 	// make Event overridable to deploy
 	// TODO refactor to use own proper API for deploy
 	if event, ok := c.GetQuery("event"); ok {

server/forge/github/convert_test.go

@@ -224,6 +224,7 @@ func Test_helper(t *testing.T) {
 			from := &github.DeploymentEvent{Deployment: &github.Deployment{}, Sender: &github.User{}}
 			from.Deployment.Description = github.String(":shipit:")
 			from.Deployment.Environment = github.String("production")
+			from.Deployment.Task = github.String("deploy")
 			from.Deployment.ID = github.Int64(42)
 			from.Deployment.Ref = github.String("main")
 			from.Deployment.SHA = github.String("f72fc19")

server/forge/github/parse.go

@@ -120,16 +120,17 @@ func parsePushHook(hook *github.PushEvent) (*model.Repo, *model.Pipeline) {
 // If the commit type is unsupported nil values are returned.
 func parseDeployHook(hook *github.DeploymentEvent) (*model.Repo, *model.Pipeline) {
 	pipeline := &model.Pipeline{
-		Event:    model.EventDeploy,
-		Commit:   hook.GetDeployment().GetSHA(),
-		ForgeURL: hook.GetDeployment().GetURL(),
-		Message:  hook.GetDeployment().GetDescription(),
-		Ref:      hook.GetDeployment().GetRef(),
-		Branch:   hook.GetDeployment().GetRef(),
-		Deploy:   hook.GetDeployment().GetEnvironment(),
-		Avatar:   hook.GetSender().GetAvatarURL(),
-		Author:   hook.GetSender().GetLogin(),
-		Sender:   hook.GetSender().GetLogin(),
+		Event:      model.EventDeploy,
+		Commit:     hook.GetDeployment().GetSHA(),
+		ForgeURL:   hook.GetDeployment().GetURL(),
+		Message:    hook.GetDeployment().GetDescription(),
+		Ref:        hook.GetDeployment().GetRef(),
+		Branch:     hook.GetDeployment().GetRef(),
+		Deploy:     hook.GetDeployment().GetEnvironment(),
+		Avatar:     hook.GetSender().GetAvatarURL(),
+		Author:     hook.GetSender().GetLogin(),
+		Sender:     hook.GetSender().GetLogin(),
+		DeployTask: hook.GetDeployment().GetTask(),
 	}
 	// if the ref is a sha or short sha we need to manually construct the ref.
 	if strings.HasPrefix(pipeline.Commit, pipeline.Ref) || pipeline.Commit == pipeline.Ref {

server/forge/github/parse_test.go

@@ -119,6 +119,8 @@ func Test_parser(t *testing.T) {
 				g.Assert(b).IsNotNil()
 				g.Assert(p).IsNil()
 				g.Assert(b.Event).Equal(model.EventDeploy)
+				g.Assert(b.Deploy).Equal("production")
+				g.Assert(b.DeployTask).Equal("deploy")
 			})
 		})
 

server/model/pipeline.go

@@ -33,6 +33,7 @@ type Pipeline struct {
 	Started             int64                   `json:"started_at"              xorm:"pipeline_started"`
 	Finished            int64                   `json:"finished_at"             xorm:"pipeline_finished"`
 	Deploy              string                  `json:"deploy_to"               xorm:"pipeline_deploy"`
+	DeployTask          string                  `json:"deploy_task"             xorm:"pipeline_deploy_task"`
 	Commit              string                  `json:"commit"                  xorm:"pipeline_commit"`
 	Branch              string                  `json:"branch"                  xorm:"pipeline_branch"`
 	Ref                 string                  `json:"ref"                     xorm:"pipeline_ref"`

server/pipeline/stepbuilder/metadata.go

@@ -116,6 +116,7 @@ func metadataPipelineFromModelPipeline(pipeline *model.Pipeline, includeParent b
 		Event:    string(pipeline.Event),
 		ForgeURL: pipeline.ForgeURL,
 		Target:   pipeline.Deploy,
+		Task:     pipeline.DeployTask,
 		Commit: metadata.Commit{
 			Sha:     pipeline.Commit,
 			Ref:     pipeline.Ref,

server/pipeline/stepbuilder/metadata_test.go

@@ -47,11 +47,11 @@ func TestMetadataFromStruct(t *testing.T) {
 				"CI_COMMIT_AUTHOR": "", "CI_COMMIT_AUTHOR_AVATAR": "", "CI_COMMIT_AUTHOR_EMAIL": "", "CI_COMMIT_BRANCH": "",
 				"CI_COMMIT_MESSAGE": "", "CI_COMMIT_PULL_REQUEST": "", "CI_COMMIT_PULL_REQUEST_LABELS": "", "CI_COMMIT_REF": "", "CI_COMMIT_REFSPEC": "", "CI_COMMIT_SHA": "", "CI_COMMIT_SOURCE_BRANCH": "",
 				"CI_COMMIT_TAG": "", "CI_COMMIT_TARGET_BRANCH": "", "CI_COMMIT_URL": "", "CI_FORGE_TYPE": "", "CI_FORGE_URL": "",
-				"CI_PIPELINE_CREATED": "0", "CI_PIPELINE_DEPLOY_TARGET": "", "CI_PIPELINE_EVENT": "", "CI_PIPELINE_FINISHED": "0", "CI_PIPELINE_FILES": "[]", "CI_PIPELINE_NUMBER": "0",
+				"CI_PIPELINE_CREATED": "0", "CI_PIPELINE_DEPLOY_TARGET": "", "CI_PIPELINE_DEPLOY_TASK": "", "CI_PIPELINE_EVENT": "", "CI_PIPELINE_FINISHED": "0", "CI_PIPELINE_FILES": "[]", "CI_PIPELINE_NUMBER": "0",
 				"CI_PIPELINE_PARENT": "0", "CI_PIPELINE_STARTED": "0", "CI_PIPELINE_STATUS": "", "CI_PIPELINE_URL": "/repos/0/pipeline/0", "CI_PIPELINE_FORGE_URL": "",
 				"CI_PREV_COMMIT_AUTHOR": "", "CI_PREV_COMMIT_AUTHOR_AVATAR": "", "CI_PREV_COMMIT_AUTHOR_EMAIL": "", "CI_PREV_COMMIT_BRANCH": "",
 				"CI_PREV_COMMIT_MESSAGE": "", "CI_PREV_COMMIT_REF": "", "CI_PREV_COMMIT_REFSPEC": "", "CI_PREV_COMMIT_SHA": "", "CI_PREV_COMMIT_URL": "", "CI_PREV_PIPELINE_CREATED": "0",
-				"CI_PREV_PIPELINE_DEPLOY_TARGET": "", "CI_PREV_PIPELINE_EVENT": "", "CI_PREV_PIPELINE_FINISHED": "0", "CI_PREV_PIPELINE_NUMBER": "0", "CI_PREV_PIPELINE_PARENT": "0",
+				"CI_PREV_PIPELINE_DEPLOY_TARGET": "", "CI_PREV_PIPELINE_DEPLOY_TASK": "", "CI_PREV_PIPELINE_EVENT": "", "CI_PREV_PIPELINE_FINISHED": "0", "CI_PREV_PIPELINE_NUMBER": "0", "CI_PREV_PIPELINE_PARENT": "0",
 				"CI_PREV_PIPELINE_STARTED": "0", "CI_PREV_PIPELINE_STATUS": "", "CI_PREV_PIPELINE_URL": "/repos/0/pipeline/0", "CI_PREV_PIPELINE_FORGE_URL": "", "CI_REPO": "", "CI_REPO_CLONE_URL": "", "CI_REPO_CLONE_SSH_URL": "", "CI_REPO_DEFAULT_BRANCH": "", "CI_REPO_REMOTE_ID": "",
 				"CI_REPO_NAME": "", "CI_REPO_OWNER": "", "CI_REPO_PRIVATE": "false", "CI_REPO_SCM": "git", "CI_REPO_TRUSTED": "false", "CI_REPO_URL": "", "CI_STEP_FINISHED": "",
 				"CI_STEP_NAME": "", "CI_STEP_NUMBER": "0", "CI_STEP_STARTED": "", "CI_STEP_STATUS": "", "CI_STEP_URL": "/repos/0/pipeline/0", "CI_SYSTEM_HOST": "", "CI_SYSTEM_NAME": "woodpecker",
@@ -82,11 +82,11 @@ func TestMetadataFromStruct(t *testing.T) {
 				"CI_COMMIT_AUTHOR": "", "CI_COMMIT_AUTHOR_AVATAR": "", "CI_COMMIT_AUTHOR_EMAIL": "", "CI_COMMIT_BRANCH": "",
 				"CI_COMMIT_MESSAGE": "", "CI_COMMIT_PULL_REQUEST": "", "CI_COMMIT_PULL_REQUEST_LABELS": "", "CI_COMMIT_REF": "", "CI_COMMIT_REFSPEC": "", "CI_COMMIT_SHA": "", "CI_COMMIT_SOURCE_BRANCH": "",
 				"CI_COMMIT_TAG": "", "CI_COMMIT_TARGET_BRANCH": "", "CI_COMMIT_URL": "", "CI_FORGE_TYPE": "gitea", "CI_FORGE_URL": "https://gitea.com",
-				"CI_PIPELINE_CREATED": "0", "CI_PIPELINE_DEPLOY_TARGET": "", "CI_PIPELINE_EVENT": "", "CI_PIPELINE_FINISHED": "0", "CI_PIPELINE_FILES": `["test.go","markdown file.md"]`,
+				"CI_PIPELINE_CREATED": "0", "CI_PIPELINE_DEPLOY_TARGET": "", "CI_PIPELINE_DEPLOY_TASK": "", "CI_PIPELINE_EVENT": "", "CI_PIPELINE_FINISHED": "0", "CI_PIPELINE_FILES": `["test.go","markdown file.md"]`,
 				"CI_PIPELINE_NUMBER": "3", "CI_PIPELINE_PARENT": "0", "CI_PIPELINE_STARTED": "0", "CI_PIPELINE_STATUS": "", "CI_PIPELINE_URL": "https://example.com/repos/0/pipeline/3", "CI_PIPELINE_FORGE_URL": "",
 				"CI_PREV_COMMIT_AUTHOR": "", "CI_PREV_COMMIT_AUTHOR_AVATAR": "", "CI_PREV_COMMIT_AUTHOR_EMAIL": "", "CI_PREV_COMMIT_BRANCH": "",
 				"CI_PREV_COMMIT_MESSAGE": "", "CI_PREV_COMMIT_REF": "", "CI_PREV_COMMIT_REFSPEC": "", "CI_PREV_COMMIT_SHA": "", "CI_PREV_COMMIT_URL": "", "CI_PREV_PIPELINE_CREATED": "0",
-				"CI_PREV_PIPELINE_DEPLOY_TARGET": "", "CI_PREV_PIPELINE_EVENT": "", "CI_PREV_PIPELINE_FINISHED": "0", "CI_PREV_PIPELINE_NUMBER": "2", "CI_PREV_PIPELINE_PARENT": "0",
+				"CI_PREV_PIPELINE_DEPLOY_TARGET": "", "CI_PREV_PIPELINE_DEPLOY_TASK": "", "CI_PREV_PIPELINE_EVENT": "", "CI_PREV_PIPELINE_FINISHED": "0", "CI_PREV_PIPELINE_NUMBER": "2", "CI_PREV_PIPELINE_PARENT": "0",
 				"CI_PREV_PIPELINE_STARTED": "0", "CI_PREV_PIPELINE_STATUS": "", "CI_PREV_PIPELINE_URL": "https://example.com/repos/0/pipeline/2", "CI_PREV_PIPELINE_FORGE_URL": "", "CI_REPO": "testUser/testRepo", "CI_REPO_CLONE_URL": "https://gitea.com/testUser/testRepo.git", "CI_REPO_CLONE_SSH_URL": "git@gitea.com:testUser/testRepo.git",
 				"CI_REPO_DEFAULT_BRANCH": "main", "CI_REPO_NAME": "testRepo", "CI_REPO_OWNER": "testUser", "CI_REPO_PRIVATE": "true", "CI_REPO_REMOTE_ID": "",
 				"CI_REPO_SCM": "git", "CI_REPO_TRUSTED": "false", "CI_REPO_URL": "https://gitea.com/testUser/testRepo", "CI_STEP_FINISHED": "",