1
0
Fork 0
mirror of https://codeberg.org/forgejo/forgejo.git synced 2025-08-05 01:45:22 +02:00

Actions Failure, Succes, Recover Webhooks (#7508)

Implement Actions Success, Failure and Recover webhooks for Forgejo, Gitea, Gogs, Slack, Discord, DingTalk, Telegram, Microsoft Teams, Feishu / Lark Suite, Matrix, WeCom (Wechat Work), Packagist. Some of these webhooks have not been manually tested.

Implement settings for these new webhooks.

## Checklist

The [contributor guide](https://forgejo.org/docs/next/contributor/) contains information that will be helpful to first time contributors. There also are a few [conditions for merging Pull Requests in Forgejo repositories](https://codeberg.org/forgejo/governance/src/branch/main/PullRequestsAgreement.md). You are also welcome to join the [Forgejo development chatroom](https://matrix.to/#/#forgejo-development:matrix.org).

### Tests

- I added test coverage for Go changes...
  - [x] in their respective `*_test.go` for unit tests.
  - [x] in the `tests/integration` directory if it involves interactions with a live Forgejo server.
- I added test coverage for JavaScript changes...
  - [ ] in `web_src/js/*.test.js` if it can be unit tested.
  - [ ] in `tests/e2e/*.test.e2e.js` if it requires interactions with a live Forgejo server (see also the [developer guide for JavaScript testing](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/tests/e2e/README.md#end-to-end-tests)).

### Documentation

- [ ] I created a pull request [to the documentation](https://codeberg.org/forgejo/docs) to explain to Forgejo users how to use this change.
- [x] I did not document these changes and I do not expect someone else to do it.

### Release notes

- [ ] I do not want this change to show in the release notes.
- [x] I want the title to show in the release notes with a link to this pull request.
- [ ] I want the content of the `release-notes/<pull request number>.md` to be be used for the release notes instead of the title.

<!--start release-notes-assistant-->

## Release notes
<!--URL:https://codeberg.org/forgejo/forgejo-->
- Features
  - [PR](https://codeberg.org/forgejo/forgejo/pulls/7508): <!--number 7508 --><!--line 0 --><!--description QWN0aW9ucyBGYWlsdXJlLCBTdWNjZXMsIFJlY292ZXIgV2ViaG9va3M=-->Actions Failure, Succes, Recover Webhooks<!--description-->
<!--end release-notes-assistant-->

Reviewed-on: https://codeberg.org/forgejo/forgejo/pulls/7508
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: christopher-besch <mail@chris-besch.com>
Co-committed-by: christopher-besch <mail@chris-besch.com>
This commit is contained in:
christopher-besch 2025-06-03 14:29:19 +02:00 committed by Earl Warren
parent 6ce9d764bc
commit d17aa98262
27 changed files with 683 additions and 12 deletions

View file

@ -3,6 +3,10 @@
package structs
import (
"time"
)
// ActionRunJob represents a job of a run
// swagger:model
type ActionRunJob struct {
@ -23,3 +27,54 @@ type ActionRunJob struct {
// the action run job status
Status string `json:"status"`
}
// ActionRun represents an action run
// swagger:model
type ActionRun struct {
// the action run id
ID int64 `json:"id"`
// the action run's title
Title string `json:"title"`
// the repo this action is part of
Repo *Repository `json:"repository"`
// the name of workflow file
WorkflowID string `json:"workflow_id"`
// a unique number for each run of a repository
Index int64 `json:"index_in_repo"`
// the user that triggered this action run
TriggerUser *User `json:"trigger_user"`
// the cron id for the schedule trigger
ScheduleID int64
// the commit/tag/… the action run ran on
PrettyRef string `json:"prettyref"`
// has the commit/tag/… the action run ran on been deleted
IsRefDeleted bool `json:"is_ref_deleted"`
// the commit sha the action run ran on
CommitSHA string `json:"commit_sha"`
// If this is triggered by a PR from a forked repository or an untrusted user, we need to check if it is approved and limit permissions when running the workflow.
IsForkPullRequest bool `json:"is_fork_pull_request"`
// may need approval if it's a fork pull request
NeedApproval bool `json:"need_approval"`
// who approved this action run
ApprovedBy int64 `json:"approved_by"`
// the webhook event that causes the workflow to run
Event string `json:"event"`
// the payload of the webhook event that causes the workflow to run
EventPayload string `json:"event_payload"`
// the trigger event defined in the `on` configuration of the triggered workflow
TriggerEvent string `json:"trigger_event"`
// the current status of this run
Status string `json:"status"`
// when the action run was started
Started time.Time `json:"started,omitempty"`
// when the action run was stopped
Stopped time.Time `json:"stopped,omitempty"`
// when the action run was created
Created time.Time `json:"created,omitempty"`
// when the action run was last updated
Updated time.Time `json:"updated,omitempty"`
// how long the action run ran for
Duration time.Duration `json:"duration,omitempty"`
// the url of this action run
HTMLURL string `json:"html_url"`
}

View file

@ -119,6 +119,7 @@ var (
_ Payloader = &RepositoryPayload{}
_ Payloader = &ReleasePayload{}
_ Payloader = &PackagePayload{}
_ Payloader = &ActionPayload{}
)
// _________ __
@ -484,3 +485,36 @@ type PackagePayload struct {
func (p *PackagePayload) JSONPayload() ([]byte, error) {
return json.MarshalIndent(p, "", " ")
}
// _ _ _
// / \ ___| |_(_) ___ _ __
// / _ \ / __| __| |/ _ \| '_ \
// / ___ \ (__| |_| | (_) | | | |
// /_/ \_\___|\__|_|\___/|_| |_|
// this name is ridiculous, yes
// it's the sub-type of hook that has something to do with Forgejo Actions
type HookActionAction string
const (
HookActionFailure HookActionAction = "failure"
HookActionRecover HookActionAction = "recover"
HookActionSuccess HookActionAction = "success"
)
// ActionPayload payload for action webhooks
type ActionPayload struct {
Action HookActionAction `json:"action"`
Run *ActionRun `json:"run"`
// the status of this run before it completed
// this must be a not done status
PriorStatus string `json:"prior_status"`
// the last run for the same workflow
// could be nil when Run is the first for it's workflow
LastRun *ActionRun `json:"last_run,omitempty"`
}
// JSONPayload return payload information
func (p *ActionPayload) JSONPayload() ([]byte, error) {
return json.MarshalIndent(p, "", " ")
}

View file

@ -4,6 +4,7 @@
package webhook
// HookEvents is a set of web hook events
// update TestCreateWebhook in models/webhook/webhook_test.go when adding or changing values here
type HookEvents struct {
Create bool `json:"create"`
Delete bool `json:"delete"`
@ -26,9 +27,12 @@ type HookEvents struct {
Repository bool `json:"repository"`
Release bool `json:"release"`
Package bool `json:"package"`
ActionRunFailure bool `json:"action_run_failure"`
ActionRunRecover bool `json:"action_run_recover"`
ActionRunSuccess bool `json:"action_run_success"`
}
// HookEvent represents events that will delivery hook.
// HookEvent represents events that will deliver a hook.
type HookEvent struct {
PushOnly bool `json:"push_only"`
SendEverything bool `json:"send_everything"`

View file

@ -7,6 +7,7 @@ package webhook
type HookEventType string
// Types of hook events
// update TestCreateWebhook in models/webhook/webhook_test.go when adding or changing values here
const (
HookEventCreate HookEventType = "create"
HookEventDelete HookEventType = "delete"
@ -33,6 +34,9 @@ const (
HookEventPackage HookEventType = "package"
HookEventSchedule HookEventType = "schedule"
HookEventWorkflowDispatch HookEventType = "workflow_dispatch"
HookEventActionRunFailure HookEventType = "action_run_failure"
HookEventActionRunRecover HookEventType = "action_run_recover"
HookEventActionRunSuccess HookEventType = "action_run_success"
)
// Event returns the HookEventType as an event string
@ -65,6 +69,12 @@ func (h HookEventType) Event() string {
return "repository"
case HookEventRelease:
return "release"
case HookEventActionRunFailure:
return "action_run_failure"
case HookEventActionRunRecover:
return "action_run_recover"
case HookEventActionRunSuccess:
return "action_run_success"
}
return ""
}