Установка

Портативная сборка

Портативная сборка подходит для быстрого запуска OpenBPM Engine без дополнительной конфигурации. Скачайте архив с официальной страницы загрузки.

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

Скачайте архив с последней версией.

Распакуйте архив в удобную директорию:

unzip openbpm-engine-bpm-run-2025.0.0.zip
cd openbpm-engine-bpm-run-2025.0.0

Выполните запуск:

Для Mac / Linux:
```
./start.sh
```
Для Windows:
```
start.bat
```
Для остановки используйте соответствующие скрипты:

Для Mac / Linux:
```
./stop.sh
```
Для Windows:
```
stop.bat
```
После успешного запуска веб-интерфейс будет доступен по адресу: http://localhost:8080

Spring Boot

Интеграция OpenBPM Engine в Spring Boot позволяет использовать движок напрямую в вашем приложении. Для этого выполните следующие шаги.

Требования

Перед началом убедитесь, что у вас установлено:

Java 17 или выше
Maven 3.8+ или Gradle 7+
Spring Boot версии 3.4.x (или совместимой)
СУБД (например PostgreSQL, H2 для разработки)

Для корректной работы Spring Boot проекта с OpenBPM Engine необходимо подключить следующие зависимости:

spring-boot-starter-web — стартер для создания веб-приложений
spring-boot-starter-jdbc — стартер для работы с базой данных
Реляционная база данных, например H2 для тестирования и разработки

Пример для Gradle:

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-jdbc'

    runtimeOnly 'com.h2database:h2'
}

Пример для Maven:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

Добавьте репозиторий OpenBPM:

Для Maven:

<repositories>
  <repository>
    <id>openbpm</id>
    <url>https://nexus.openbpm.ru/repository/releases</url>
  </repository>
</repositories>

Для Gradle:

repositories {
    mavenCentral()
    maven {
        url "https://nexus.openbpm.ru/repository/releases"
    }
}

Подключите необходимые зависимости:

Для Maven

<dependencies>
  <!-- OpenBPM Engine -->
  <dependency>
    <groupId>io.openbpm.bpm.springboot</groupId>
    <artifactId>openbpm-engine-bpm-spring-boot-starter</artifactId>
    <version>2025.0.0</version>
  </dependency>

  <!-- Встроенный Webapp -->
  <dependency>
    <groupId>io.openbpm.bpm.springboot</groupId>
    <artifactId>openbpm-engine-bpm-spring-boot-starter-webapp</artifactId>
    <version>2025.0.0</version>
  </dependency>

  <!-- REST API -->
  <dependency>
    <groupId>io.openbpm.bpm.springboot</groupId>
    <artifactId>openbpm-engine-bpm-spring-boot-starter-rest</artifactId>
    <version>2025.0.0</version>
  </dependency>
</dependencies>

Для Gradle

dependencies {
    // OpenBPM Engine
    implementation "io.openbpm.bpm.springboot:openbpm-engine-bpm-spring-boot-starter:2025.0.0"

    // Встроенный Webapp
    implementation "io.openbpm.bpm.springboot:openbpm-engine-bpm-spring-boot-starter-webapp:2025.0.0"

    // REST API
    implementation "io.openbpm.bpm.springboot:openbpm-engine-bpm-spring-boot-starter-rest:2025.0.0"
}

Добавьте базовую конфигурацию в src/main/resources/application.properties:

# Настройки Spring Boot
spring.application.name=openbpm-engine-spring-boot-sample

# Настройки сервера
server.port=8080

# Настройки источника данных
spring.datasource.url=jdbc:h2:file:./h2/openbpm-engine-h2-database
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password

spring.jpa.database-platform=org.hibernate.dialect.H2Dialect

# Настройки OpenBPM Engine
openbpm.bpm.admin-user.id=demo
openbpm.bpm.admin-user.password=demo

openbpm.bpm.auto-deployment-enabled=true
openbpm.bpm.deployment-resource-pattern=classpath*:*.bpmn, classpath*:*.form, classpath*:*.dmn

Запуск проекта

Для Maven:
```
mvn spring-boot:run
```
Для Gradle:
```
gradle bootRun
```
Веб-интерфейс доступен по адресу: http://localhost:8080

Docker

Для быстрого запуска OpenBPM Engine в контейнере используйте готовый Docker-образ.

Запустите контейнер:

docker pull registry.gitflic.ru/project/openbpm/openbpm-engine-community/openbpm-engine-community:latest
docker run -d --name openbpm -p 8080:8080 registry.gitflic.ru/project/openbpm/openbpm-engine-community/openbpm-engine-community:latest

Проверьте, что контейнер работает:
```
docker ps
```

Веб-интерфейс доступен по адресу: http://localhost:8080