webhook

Documentation

Overview

Package webhook contains code for managing and serving webhook services, providing post push events to trigger builds.

Index

• func FindTriggerPolicy(triggerType api.BuildTriggerType, config *api.BuildConfig) (*api.BuildTriggerPolicy, bool)
• func GitRefMatches(eventRef, configRef string) bool
• func NewController(osClient webhookBuildInterface, plugins map[string]Plugin) http.Handler
• type Plugin

Functions

func FindTriggerPolicy

func FindTriggerPolicy(triggerType api.BuildTriggerType, config *api.BuildConfig) (*api.BuildTriggerPolicy, bool)

FindTrigger retrieves the BuildTrigger of a given type from a build configuration

func GitRefMatches

func GitRefMatches(eventRef, configRef string) bool

GitRefMatches determines if the ref from a webhook event matches a build configuration

func NewController

func NewController(osClient webhookBuildInterface, plugins map[string]Plugin) http.Handler

NewController creates new webhook controller and feed it with provided plugins.

Types

type Plugin

type Plugin interface {
	// Method extracts build information and returns:
	// - newly created build object or nil if default is to be created
	// - information whether to trigger the build itself
	// - eventual error.
	Extract(buildCfg *api.BuildConfig, secret, path string, req *http.Request) (*api.SourceRevision, bool, error)
}

Plugin for Webhook verification is dependent on the sending side, it can be eg. github, bitbucket or else, so there must be a separate Plugin instance for each webhook provider.