09.12.24

Видеокурс Camunda 8: Создаем первый процесс

Мстислав Мартынюк
Автор:Мстислав Мартынюк
10 мин · Обучающие



Обзор


В рамках сегодняшнего урока мы объясним, как создать и развернуть в Camunda 8 (Zeebe) первый исполняемый процесс. Если вы хотите узнать больше о том, что такое Camunda 8, как выглядит архитектура системы и из каких компонентов она состоит, рекомендуется обратиться к статьям в нашем блоге:



Также, необходимы базовые знания нотации моделирования бизнес-процессов BPMN 2.0.


Необходимые компоненты


Долгое время было весьма затруднительно использовать Camunda 8 в качестве песочницы для отладки исполняемых процессов. Приходилось поднимать отдельный кластер Zeebe + Operate или покупать подписку на SaaS-версию (Camunda Cloud). С выходом версии 8.6 появилась отдельная сборка, предназначенная для запуска в девелоперских средах – Camunda 8 Run.


Чтобы запустить Camunda 8 локально, необходимо перейти на сайт Camunda.


Camunda 8 Download

На странице, приведенной по ссылке выше, расположены дистрибутивы:


  • Camunda Modeler – кроссплатформенное приложение (MacOS Intel, MacOS ARM, Linux, Windows) для моделирования бизнес-процессов в нотации BPMN, таблиц решений (бизнес-правил) в нотации DMN и создания экранных форм пользовательских задач в формате JSON.

  • Camunda 8 Run – Java-приложение, содержащее BPMN Workflow Engine, DMN Decision Engine, Tasklist и Operate, позволяющее развертывать, тестировать и запускать рабочие процессы локально.


Установка и запуск


Установка и запуск Camunda Modeler не представляет особых сложностей. С запуском Camunda 8 Run все несколько сложнее, в силу специфических системных требований:


  • JDK 21+ (можно использовать любую подходящую сборку OpenJDK версии 21 и новее, например Temurin;

  • Путь к Java должен быть указан в системной переменной JAVA_HOME;

  • Не менее 16 Гбайт RAM и 20 Гбайт свободного пространства на диске (требуется для запуска Elasticsearch).


Проверка версии Java

Запуск Camunda 8 Run


Для запуска необходимо распаковать скачанный архив и запустить скрипт start.sh (start.bat – для Windows). При возникновении проблем необходимо убедиться, что используемый вами стенд соответствует системным требованиям – проверить версию Java (java -version) и переменную JAVA_HOME. Запуск системы может занять до нескольких минут, в зависимости от производительности вашего стенда. В случае успешного запуска, в консоли будет выведено сообщение со ссылками на веб-приложения и API:


Waiting for Camunda to start. 20 retries left
Camunda has successfully been started.

-------------------------------------------
Access each component at the following urls:

Operate:                     http://localhost:8080/operate
Tasklist:                    http://localhost:8080/tasklist
Zeebe Cluster Endpoint:      http://localhost:26500
Inbound Connectors Endpoint: http://localhost:8085

When using the Desktop Modeler, Authentication may be set to None.

Также, откроется браузер с Operate.


Войти в Operate можно с именем пользователя и паролем: demo / demo.


Camunda 8 Operate Login


Моделирование первого процесса


Для того, чтобы смоделировать процесс в нотации BPMN, необходимо запустить Camunda Modeler и выбрать пункт BPMN Diagram.


Смоделируем простой процесс, содержащий в себе:


  • Начальное событие (None Start Event);

  • Задачу (Undefined Task);

  • Конечное событие (None End Event).


Желательно задать имя задачи и процесса (поле Name), а также указать им человекочитаемые идентификаторы (ID).


Для использования нужного элемента BPMN, необходимо перетащить его с панели инструментов слева, а изменить его параметры можно, выделив его на рабочей области, находящейся в центре экрана. В этом случае, справа будет выведена панель свойств элемента (Property Panel).


Camunda Modeler

Развертывание (Deploy) и запуск процесса


После моделирования процесса его необходимо загрузить (задеплоить) в Camunda 8 Run. Это может быть исполнено разными способами, в том числе, с использованием Camunda Modeler.


Camunda Modeler развертывание процесса

Необходимо нажать кнопку Deploy с изображением ракеты в правой нижней части рабочей области. Если диаграмма ранее не была сохранена в файл, приложение предложит вам это сделать, а после – выведет форму Deploy Diagram, где необходимо указать параметры для загрузки:


  • Deployment name – любое имя, позволяющее идентифицировать вашу загрузку;

  • Target – тип кластера (SaaS или Self-Managed) – выбираем Self Managed;

  • Cluster Endpoint – необходимо указать локальный URL Zeebe: http://localhost:26500

  • Authentication – тип аутентификации – None.


Camunda 8 развертывание процесса

По нажатию кнопки Deploy модель процесса будет развернута в кластере Zeebe и её можно будет увидеть в Operate.


Запуск процесса может быть выполнен:


  • Через Zeebe Client;

  • Вызовом gRPC-команды;

  • Zeebe CLI;

  • Из приложения Tasklist;

  • Из Camunda Modeler.


Для запуска из Camunda Modeler нужно нажать кнопку Play, размещенную справа от кнопки Deploy. В появившемся окне можно задать переменные процесса в формате JSON и нажать кнопку Start.


Camunda Modeler запуск процесса

Задача (Undefined Task), используемая нами в модели процесса, обрабатывается BPM-движком как сквозная – после запуска токен проследует через нее не останавливаясь, после чего процесс будет автоматически завершен.


Перейдите в Operate в меню Processes – в истории процессов должна появиться новая запись о завершенном экземпляре процесса (Process Instance). Если запись не видна, убедитесь, что в фильтре слева отмечен чекбокс Finished Instances.


Поздравляем! Вы успешно смоделировали и исполнили в Camunda 8 ваш первый процесс!


Camunda Operate первый процесс