Create scenarios to automate any execution of processes. Objectives are
- Unit test and regression: You need to verify that a process reacts the same if you create a process instance with the variable "amount=100", and that the process comes to the user task "review".
- Unit performance test: The process calls a service task "getCreditScore," and you want to verify this execution stays under 200 ms
- Developer reason: you developed the task "getCreditScore", and this task is in the process after 4 user tasks and 3 service tasks that you need to simulate
The Unit Test section covers these goals.
- Load test: to verify that the platform can handle 1000 process instances created every 10 minutes and can process this throughput: it should terminate this 1000 process every 10 minutes.
- Generate process instances: For any reason, you want to generate 400 process instances and advance them to the user task "Review" to check your user application
The Load Test section covers these goals.
Process-Automator executes scenario. One scenario pilot a process.
It is possible to execute multiple at the same time to handle a use case like "generate 100 process instances/minute on process Review, 5 process instances per second on process Expense."
Automator does not start a Camunda Engine; it communicates with it. It can be a Camunda 7 server or a Camunda 8 server.
The goal of the Automator is not to simulate the execution. It is to pilot an execution on a real system, and to verify that the process reacts as expected.
From a scenario, the Process-Automator calls the Camunda Engine server (C7 or C8) and executes the different steps in the scenario. Let's take an example with this scenario:
Create a new process instance with the variable "subscriptionLevel: "GOLD", "customerId": 14422
The Camunda Engine (C7 or C8) creates and processes the process. The Camunda Engine executes the GetContext
operation, and, according to the information, the process instance moves to the task Review Level 1
.
In the scenario, Process-Automator waits for this user task. It will execute it and set ReviewLevel2Needed.
to True. The Camunda Engine moves the process instance to Review Level 2
. In the scenario, Process-Automator waits for this user task. It will execute it. The Camunda engine continues the execution. It
executes Register Application
, waits for the message, executes Notify Applicant
, and completes the process instance.
Another scenario can execute only Review Level 1
or no review.
What Process-Automator do:
- It creates a process instance with some specific value
- It executes user tasks with some specific value
- It can throw a BPMN Message
- Simulate execute service task in Flow Scenario
Process-Automator do not
- Execute service task in unit-scenario
- It is not expected to catch a BPMN Message in the flow: Process-Automator piloted a real system.
Process-Automator needs to connect to a running platform, Camunda 7 or Camunda 8. Automator is not a process simulator. The running platform will execute all service tasks.
A scenario can be executed on a Camunda 7 or a Camunda 8 server. Process-Automator provides:
- a server running under Springboot
- a docker image
- An API to be integrated into any other tools
The unit scenario describes one process instance execution. Creation and user tasks are described. This functionality is used to run regression tests, coverage tests, or just advance process instances in the process for the development.
Visit Unit Scenario
The flow scenario describes an environment and sends requirements like "generate 500 PI every 40 seconds". The flow scenario has a duration and objective to verify.
You can specify objectives: produce 1000 Process Instances, end 500 process instances, and produce 300 tasks in a user task.
The method to conduct a Load Test is available here.
Visit Load Test Scenario and the Load test Tutorial
Process-Execution-Automator execute a scenario.
A scenario define
- a list of robots. A robot
- Create process instances,
- Execute service task,
- Execute user tasks
- some objectives
- How many process instance must be created
- How many service task has to be executed
- Time to execute a section in the process
- a warm up section
Due to the “backoff strategy”, workers need to be wake up
Robots can be registered in the same pod
Or multiple pods can be defined. Each pod run the process-execution-automator on the same scenario, but limit which robots are executed
For unit testing, the execution is different. The pod is started, but don't start immediately the scenario.
This section references all the information to build a scenario. Visit Scenario reference
Process-Automator does not contain any Camunda server. It connects to an existing Camunda Engine. Two communication interfaces exist, one for Camunda 7 and one for Camunda 8. A scenario can then pilot a Camunda 7 or a Camunda 8 server.
The scenario does not contain any server information.
Process-Automator references a list of servers in the configuration in multiple ways:
- serverConnection : String, containing a list of connections separated by ;
- serverList: List of records.
- camunda7 : information to connect a Camunda 7 server
- camunda8 : information to connect a Camunda 8 server
- camunda8Saas: information to connect a Camunda 8 Saas server
So, you can choose the best way to overide the information to connect to your own server.
At the execution, two parameters are mandatory:
- the scenario to run
- the server to connect to run the scenario
In this way, using the same scenario in different environments is possible.
For example, let's say you want to start the tool in a Kubernetes deployment.
The best way is then to use the Spring capability's to override a parameter via the -D options.
You check the application.yaml, and decided the simple ways is to override the automator.servers.camunda8
section.
1/ you specify which server the tool will connect the server given at the configuration. For example, using the SpringBoot functionality to override a configuration variable:
-Dautomator.startup.serverName=MyTestServer
2/ Now, the tool will search the MyTestServer
in the list of servers.
The simple way is to override the automator.servers.camunda8
values (or camunda7 to connect to a Camunda 7 server).
To know the different parameters, check the example in the serverList section in the YAML file. To connect to a C8 self-manage with no authentication, the Camunda8Ruby is the best way
-Dautomator.servers.camunda8.name=MyTestServer
-Dautomator.servers.camunda8.zeebeGatewayAddress="127.0.0.1:26500"
-Dautomator.servers.camunda8.operateUserName="demo"
-Dautomator.servers.camunda8.operateUserPassword="demo"
-Dautomator.servers.camunda8.operateUrl="http://localhost:8081"
-Dautomator.servers.camunda8.taskListUserName="demo"
-Dautomator.servers.camunda8.taskListUserPassword="demo"
-Dautomator.servers.camunda8.taskListUrl="http://localhost:8082"
-Dautomator.servers.camunda8.workerExecutionThreads=200
So, the application starts,know it will search for the server name MyTestServer
, and search for that
server name definition in all sources. It will found it behind of the definition of automator.servers.camunda8
and use this definition to connect.
The example in the list of server is Camunda8Ruby
-Dautomator.servers.camunda8.name=MyTestServer
-Dautomator.servers.camunda8.zeebeGatewayAddress="127.0.0.1:26500"
-Dautomator.servers.camunda8.operateUserName="demo"
-Dautomator.servers.camunda8.operateUserPassword="demo"
-Dautomator.servers.camunda8.operateUrl="http://localhost:8081"
-Dautomator.servers.camunda8.taskListUserName="demo"
-Dautomator.servers.camunda8.taskListUserPassword="demo"
-Dautomator.servers.camunda8.taskListUrl="http://localhost:8082"
-Dautomator.servers.camunda8.workerExecutionThreads=200
The example in the list of server is Camunda8Lazuli
-Dautomator.servers.camunda8.zeebeGatewayAddress=127.0.0.1:26500
-Dautomator.servers.camunda8.zeebeClientId=zeebe
-Dautomator.servers.camunda8.zeebeClientSecret=LHwdAq56bZ
-Dautomator.servers.camunda8.zeebeAudience=zeebe
-Dautomator.servers.camunda8.zeebePlainText=true
-Dautomator.servers.camunda8.authenticationUrl=http://localhost:18080/auth/realms/camunda-platform/protocol/openid-connect/token
-Dautomator.servers.camunda8.operateClientId=operate
-Dautomator.servers.camunda8.operateClientSecret=Ns0ZGTrm24
-Dautomator.servers.camunda8.operateUserName=demo
-Dautomator.servers.camunda8.operateUserPassword=demo
-Dautomator.servers.camunda8.operateUrl=http://localhost:8081
-Dautomator.servers.camunda8.taskListClientId=tasklist
-Dautomator.servers.camunda8.taskListClientSecret=DCjtjiIwmd
-Dautomator.servers.camunda8.taskListUserName=demo
-Dautomator.servers.camunda8.taskListUserPassword=demo
-Dautomator.servers.camunda8.taskListUrl=http://localhost:8082
-Dautomator.servers.camunda8.taskListKeycloakUrl=http://localhost:18080/auth/realms/camunda-platform
-Dautomator.servers.camunda8.workerExecutionThreads=200
The example in the list of server is Camunda8Grena
-Dautomator.servers.camunda8.zeebeGatewayAddress=127.0.0.1:26500
-Dautomator.servers.camunda8.region=jfk-1
-Dautomator.servers.camunda8.clusterId=b16d70cb-b654-4d76-a3a4-d4e438e4447c
-Dautomator.servers.camunda8.zeebeClientId=nDyNLPuBqNrlQs4_3RsTDsFCgn~LkmJB
-Dautomator.servers.camunda8.zeebeClientSecret=6HwNaOHVjHCUSjVmzm4J8zDtyohyxk7b~JF1PatZqnpDjujneQ62~dEh6M-j3APc
-Dautomator.servers.camunda8.authenticationUrl=https://login.cloud.camunda.io/oauth/token
-Dautomator.servers.camunda8.zeebeAudience=zeebe.camunda.io
-Dautomator.servers.camunda8.operateUrl=https://bru-2.operate.camunda.io/4b..e2
-Dautomator.servers.camunda8.operateClientId=SJRsNvQ3sS~LeLh.bYkkIZsRCKs-Y3jr
-Dautomator.servers.camunda8.operateClientSecret=zyB5ihdg62L5afrOcPU.RR~O4poL97BoF5k8YUv.f3WBg9QqadYypp09ffIEXchW
-Dautomator.servers.camunda8.taskListUrl=https://bru-2.tasklist.camunda.io/4b..e2
-Dautomator.servers.camunda8.taskListClientId=H5uyrOHGkG8C8S~FlbA3EWsWsyzXP8mr
-Dautomator.servers.camunda8.taskListClientSecret=.7~Lhx0~dntq5hfRc0kbD_5iZLyWWIZ6ZZXbg.LG5snMYIDIaaCDtj8~r~dq.yxk
Example to run the CLI command
in the CLI command, the connection information must be stored in the application.yaml. To address multiple server, the simple way is to use the list of server.
`java -jar target/process-execution-automator.jar \
-s Camunda8Ruby \
-v \
-l MAIN \
-x run doc/unittestscenario/resources/C8LoanManagementScn.json
A docker image is created. The image can be used in a docker-compose.
Visit Docker documentation
Scenario and Server configuration can be set up at startup.
The project can be used in a docker environment to create, for example,
- one container to run a scenario within a context, creating 500 process instances every 40 seconds
- one container to simulate the service task
getCreditScore
. This worker runs 200 threads - twenty containers to simulate the service task
checkRisk
. This worker runs 100 threads in ThreadExecutionWorker implementation.
Visit Kubernetes documentation
The project can simulate the service task. Different implementations are available: the classical and the Thread implementation.
Visit Different Worker Implementation project to have an explanation of the different implementations.
Different properties:
This section gives different parameters to execute at startup.
parameter | explanation | default |
---|---|---|
serverName | server to use at startup. The server name must exist in the list of servers | |
scenarioPath | Path to load the scenario to run at startup. The path must be accessible by the application | |
scenarioResourceAtStartup | Resource to load the scenario. Useful in the Kubernetes word to give the scenario in a config map | |
logLevel | "DEBUG", "INFO", "MONITORING", "MAIN", "NOTHING" | |
policyExecution | "DEPLOYPROCESS", "WARMINGUP", "CREATION", "SERVICETASK"", "USERTASK" see bellow | |
filterService | in combinaison with SERVICETASK. Topic name | |
deepTracking | If true, more information are coming on the log (each execution for example) | false |
policyExecution A combinaison of "DEPLOYPROCESS", "WARMINGUP","CREATION","SERVICETASK"", "USERTASK", for example "WARMINUP|CREATION|USERTASK"
SERVICETASK is running in combination with the filterService value. The application runs only these role. Doing that, in a cluster, it's possible to start 10 pods running the creation and 5 pods running specific service tasks.
parameter | explanation | default |
---|---|---|
logDebug | Specify the information to log | false |
The string contains a list of connections, separate by a semi-colon (":"). Each parameter in the connection is separated by a comma (,)
First parameters are
- Server name
- Type of server: CAMUNDA_7, CAMUNDA_8, ,CAMUNDA_7,CAMUNDA_8_SAAS
The following parameters depend on the type.
CAMUNDA_7
- URL to connect the server
CAMUNDA_8
- ZeebeGatewayAddress,
- OperateUserName,
- OperateUserPassword,
- OperateUrl,
- ExecutionThreads,
- MaxJobActive
CAMUNDA_8_SAAS
- zeebeSaasRegion,
- zeebeSaasClusterId,
- zeebeSaasClientId,
- clientSecret,
- zeebeAudience
- OperateClientId,
- OperateClientPassword,
- TaskClientId TaskClientSecret
- ExecutionThreads,
- MaxJobActive
Example
automator.serversConnection: \
Camunda7Diamond,CAMUNDA_7,http://localhost:8080/engine-rest; \
Camunda8Safir,CAMUNDA_8,127.0.0.1:26500,demo,demo,http://localhost:8081
Yaml list
automator.serversList:
- type: "camunda7"
name: "camunda7Emeraud"
url: "http://localhost:8080/engine-rest"
workerMaxJobsActive: 20
- type: "camunda8"
name: "Camunda8Ruby"
zeebeGatewayAddress: "127.0.0.1:26500"
operateUserName: "demo"
operateUserPassword: "demo"
operateUrl: "http://localhost:8081"
taskListUrl: "http://localhost:8082"
workerExecutionThreads: 10
workerMaxJobsActive: 10
- type: "camunda8saas"
name: "Camunda8Grena"
region: "bru-2"
clusterId: "4b...e2"
clientId: "bs...6a"
secret: "-Ez...ZG"
oAuthUrl: "https://login.cloud.camunda.io/oauth/token"
audience: "zeebe.camunda.io"
operateUrl: "https://bru-2.operate.camunda.io/4b..e2"
taskListUrl: "https://bru-2.tasklist.camunda.io/4b..e2"
workerExecutionThreads: 10
workerMaxJobsActive: 10
This definition is straightforward to use in the Kubernetes definition because one variable can be override
automator.servers:
camunda7:
name: "Camunda7Granit"
url: "http://localhost:8080/engine-rest"
workerMaxJobsActive: 20
camunda8:
name: "Camunda8Calcair"
zeebeGatewayAddress: "127.0.0.1:26500"
operateUserName: "demo"
operateUserPassword: "demo"
operateUrl: "http://localhost:8081"
taskListUrl: "http://localhost:8082"
workerExecutionThreads: 10
workerMaxJobsActive: 10
camunda8Saas:
name: "Camunda8Marbble"
workerExecutionThreads: 10
workerMaxJobsActive: 10
operateUrl: "https://ont-1.operate.camunda.io/25fdd1e6-e4a1-4362-b49c-5eced08cb893"
taskListUrl: "https://ont-1.tasklist.camunda.io/25fdd1e6-e4a1-4362-b49c-5eced08cb893"
operateUserName: "demo"
operateUserPassword: "demo"
region: "ont-1"
clusterId: "25fdd1e6-e4a1-4362-b49c-5eced08cb893"
clientId: "eknOoiO5GYDdFf4ZjDSh8yaLG-BVCw9L"
oAuthUrl: "https://login.cloud.camunda.io/oauth/token"
audience: ""
secret: "4BPUva1U4lDtoG2-torvAtx6w5RbHULUFhGZ-bBXOMWwZJG3d3VDlfPHjVO3Kz-N"
Rebuilt the image via
mvn clean install
The docker image is build using the Dockerfile present on the root level.
Push the image to
docker build -t pierre-yves-monnet/process-execution-automator:1.8.1 .
Push the image to the Camunda hub (you must be login first to the docker registry)
docker tag pierre-yves-monnet/process-execution-automator:1.8.1 ghcr.io/camunda-community-hub/process-execution-automator:1.8.1
docker push ghcr.io/camunda-community-hub/process-execution-automator:1.8.1
Tag as the latest:
docker tag pierre-yves-monnet/process-execution-automator:1.8.1 ghcr.io/camunda-community-hub/process-execution-automator:latest
docker push ghcr.io/camunda-community-hub/process-execution-automator:latest