zeebe

README

Start the environment

In Visual Studio Code run Remote-Containers: Open Folder in Container... from the Command Palette (F1) and select the tests/e2e/bindings/zeebe folder.

Run the tests on the command line

cd tests/e2e/bindings/zeebe/
docker-compose up -d
docker exec -w /go/src/github.com/dapr/components-contrib -it zeebe-dapr-1 make e2e-tests-zeebe

Run the tests in VS Code

To run the tests you have to add the e2etests build flag to your VSCode buildTags settings: "go.buildTags": "e2etests".

BPMN process files

The test suite uses two BPMN processes which are located in the processes folder. These processes can be edited with the Camunda Modeler

Missing tests

Incident related tests

Currently it's not possible to get an incident key which is needed to resolve an incident.

Documentation

Index

• Constants
• func ActicateJob(cmd *command.ZeebeCommand, ctx context.Context, payload map[string]interface{}) (*[]pb.ActivatedJob, error)
• func Command() (*command.ZeebeCommand, error)
• func CreateProcessInstance(cmd *command.ZeebeCommand, ctx context.Context, payload map[string]interface{}) (*pb.CreateProcessInstanceResponse, error)
• func DeployProcess(cmd *command.ZeebeCommand, ctx context.Context, fileName string, ...) (*pb.ProcessMetadata, error)
• func GetTestFile(fileName string, modifiers ...func(string) string) ([]byte, error)
• func InitTestProcess(cmd *command.ZeebeCommand, ctx context.Context, id string, ...) error
• func JobTypeModifier(from string, to string) func(string) string
• func JobWorker(jobType string, additionalMetadata ...MetadataPair) (*jobworker.ZeebeJobWorker, error)
• func NameModifier(name string) func(string) string
• func ProcessIDModifier(id string) func(string) string
• func RetryModifier(jobType string, retries int) func(string) string
• func TestID() string
• type EnvVars
  • func GetEnvVars() EnvVars
• type MetadataPair

Constants

const (
	// TestProcessFile contains the basic test process file name.
	TestProcessFile string = "test.bpmn"
	// CalcProcessFile contains the calculation process file name.
	CalcProcessFile string = "calc.bpmn"
)

Functions

func ActicateJob

func ActicateJob(
	cmd *command.ZeebeCommand,
	ctx context.Context,
	payload map[string]interface{},
) (*[]pb.ActivatedJob, error)

func Command

func Command() (*command.ZeebeCommand, error)

Command initializes the Zeebe command binding and returns it.

func CreateProcessInstance

func CreateProcessInstance(
	cmd *command.ZeebeCommand,
	ctx context.Context,
	payload map[string]interface{},
) (*pb.CreateProcessInstanceResponse, error)

CreateProcessInstance creates a process instance and returns the process instance data.

func DeployProcess

func DeployProcess(
	cmd *command.ZeebeCommand,
	ctx context.Context,
	fileName string,
	modifiers ...func(string) string,
) (*pb.ProcessMetadata, error)

DeployProcess deploys a test BPMN file. The function also accepts a list of modifier functions which allows to manipulate the content of the returned BPMN file. On success the function returns a JSON with the deployment information.

func GetTestFile

func GetTestFile(fileName string, modifiers ...func(string) string) ([]byte, error)

GetTestFile loads the content of a BPMN process file. The function also accepts a list of modifier functions which allows to manipulate the content of the returned BPMN file.

func InitTestProcess

func InitTestProcess(
	cmd *command.ZeebeCommand,
	ctx context.Context,
	id string,
	testWorker bindings.Handler,
	additionalMetadata ...MetadataPair,
) error

InitTestProcess initializes a test process.

func JobTypeModifier

func JobTypeModifier(from string, to string) func(string) string

JobTypeModifier modifies the job type of a process.

func JobWorker

func JobWorker(jobType string, additionalMetadata ...MetadataPair) (*jobworker.ZeebeJobWorker, error)

JobWorker initializes the Zeebe job worker binding and returns it.

func NameModifier

func NameModifier(name string) func(string) string

NameModifier modifies the name of a process.

func ProcessIDModifier

func ProcessIDModifier(id string) func(string) string

ProcessIDModifier modifies the process ID in a BPMN file.

func RetryModifier

func RetryModifier(jobType string, retries int) func(string) string

RetryModifier modifies the job retries for a specific job type.

func TestID

func TestID() string

TestID creates a valid test ID for the isolation of processes during test. This ID is optimized for the usage inside a BPMN file because some values inside a BPMN must always start with a character. This function will ensure that this is always the case.

Types

type EnvVars

type EnvVars struct {
	ZeebeVersion                 string
	ZeebeBrokerHost              string
	ZeebeBrokerGatewayPort       string
	ZeebeBrokerClusterSize       string
	ZeebeBrokerReplicationFactor string
	ZeebeBrokerPartitionsCount   string
}

func GetEnvVars

func GetEnvVars() EnvVars

GetEnvVars returns the Zeebe environment vars.

type MetadataPair

type MetadataPair struct {
	Key, Value string
}