Go ScriptTrigger
CertifiedTrigger on Go script condition
Go ScriptTrigger
Trigger on Go script condition
Polls by running an inline Go script in a container (default image golang) and emits when exitCondition matches. Supports edge mode to emit only on transitions and polls every 60s by default. Accepts 'exit N' or a regex (fallback substring) matched against emitted vars and failure logs.
type: io.kestra.plugin.scripts.go.ScriptTriggerExamples
Trigger when the script fails with an implicit error (exit 1).
id: script_trigger
namespace: company.team
triggers:
- id: script_failure
type: io.kestra.plugin.scripts.go.ScriptTrigger
interval: PT10S
exitCondition: "exit 1"
edge: true
containerImage: golang
script: |
package main
import "os"
func main() {
// This fails with non-zero exit code.
os.Exit(1)
}
tasks:
- id: log
type: io.kestra.plugin.core.log.Log
message: "Triggered with exitCode={{ trigger.exitCode }} (condition={{ trigger.condition }})"
Properties
exitCondition *Requiredstring
Condition to match
Rendered condition evaluated after each execution; the trigger emits only when it matches. 'exit N' compares the exit code, otherwise the string is used as a regex (or substring fallback) against emitted vars (from ::{"outputs": ...}::) and failure logs.
script *Requiredstring
Inline Go script
Multi-line Go script executed on each poll, with the same semantics as the Go Script task.
allowConcurrent Non-dynamicboolean
falseSpecifies whether a trigger is allowed to start a new execution even if a previous run is still in progress.
containerImage string
golangContainer image for script execution
Image used by the Script task to run the inline Go script; defaults to 'golang'. Provide an image that includes Go runtime tooling.
edge booleanstring
trueEdge trigger mode
When true (default), emit only on a transition from not matching to matching. When false, emit on every poll that matches.
interval Non-dynamicstring
PT1MdurationCheck interval
Interval between polls; default PT60S. The scheduler uses this to schedule the next evaluation.
stopAfter Non-dynamicarray
CREATEDSUBMITTEDRUNNINGPAUSEDRESTARTEDKILLINGSUCCESSWARNINGFAILEDKILLEDCANCELLEDQUEUEDRETRYINGRETRIEDSKIPPEDBREAKPOINTRESUBMITTEDList of execution states after which a trigger should be stopped (a.k.a. disabled).
when string
trueA condition that determines whether the trigger should run.
A Pebble expression evaluated at trigger time. The trigger fires only when the expression evaluates to a truthy value (true, a non-empty string, a non-zero number). Use this to gate trigger execution on dynamic runtime values such as execution labels, flow variables, or environment conditions.
Outputs
condition string
Rendered condition
Rendered value of the exitCondition property for this poll.
exitCode integer
Script exit code
Exit code returned by the Go process (may be null if not available).
timestamp string
date-timeTimestamp of the event that fired the trigger
vars object
Script vars
Vars produced by the task (e.g. via ::{"outputs": {...}}:: convention). This is the main structured way to evaluate non-exit conditions on successful runs.
