camundamodeler

Ansible Роль: camundamodeler

Роль для установки Camunda-Modeler.

Вы можете запустить его из командной строки, введя camunda-modeler, или через ярлык на рабочем столе. (cp /usr/share/applications/camunda-modeler.desktop ~/Desktop/)

$ which camunda-modeler 
/usr/local/bin/camunda-modeler

cp /usr/share/applications/camunda-modeler.desktop ~/Desktop/

Требования

Ansible >= 2.8.0
Дистрибуция Linux
- Семейство Debian
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
  - Debian
    - Stretch (9)
    - Buster (10)
- Семейство RedHat
  - Fedora
    - 37
- Семейство SUSE
  - openSUSE
    - 15.1
- Примечание: другие версии могут работать, но не были протестированы.

Переменные роли

Следующие переменные изменят поведение этой роли (значения по умолчанию указаны ниже):

# Версия Camunda Modeler для загрузки и распаковки
cm_version: '4.12.0'

# URL для загрузки архива Camunda Modeler
cm_download_url: 'https://github.com/camunda/camunda-modeler/releases/download/v{{ cm_version }}'

# Имя файла распределимого пакета camunda-modeler
cm_redis_filename: 'camunda-modeler-{{ cm_version }}-linux-x64.tar.gz'

# Основной каталог установки
cm_install_dir: '/opt/camunda-modeler/{{ cm_version }}'

# Каталог для хранения загруженных файлов для установки Camunda Modeler
cm_download_dir: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}"

# Загружает и распаковывает плагины camunda modeler в нужное место
# по умолчанию отключено
# чтобы включить, просто добавьте список плагинов и для каждого элемента укажите имя и URL с zip или tar
#plugins:
#  - name: tooltip
#    url: https://github.com/viadee/camunda-modeler-tooltip-plugin/archive/refs/tags/v0.0.8.tar.gz
#  - name: property-info 
#    url: https://github.com/umb/camunda-modeler-property-info-plugin/archive/refs/tags/0.0.2.tar.gz
#  - name: token-simulation
#    url: https://github.com/bpmn-io/bpmn-js-token-simulation-plugin/archive/refs/heads/master.zip
#  - name: autosave
#    url: https://github.com/pinussilvestrus/camunda-modeler-autosave-plugin/archive/refs/tags/v0.2.0.tar.gz
#  - name: camunda-modeler-plugin-resize-tasks 
#    url: https://github.com/philippfromme/camunda-modeler-plugin-resize-tasks/archive/refs/heads/master.zip
#  - name: camunda-transaction-boundaries
#    url: https://github.com/bpmn-io/camunda-transaction-boundaries/archive/refs/tags/v1.1.2.tar.gz
#  - name: bpmn-js-embedded-comments
#    url: https://github.com/bpmn-io/bpmn-js-embedded-comments/archive/refs/tags/v0.6.1.tar.gz

Поддерживаемые версии camunda-modeler

Следующие версии camunda-modeler поддерживаются без дополнительной настройки:

5.8.0
5.7.0
5.6.0
5.5.1
5.5.0
5.4.1
5.4.0
5.3.0
5.2.0
5.1.0
5.0.0
4.12.0
4.11.1
4.11.0
4.10.0
4.9.0
4.8.1
4.8.0
4.7.0
4.6.0
4.5.0
4.4.0
4.3.0
4.2.0
4.1.1
4.1.0
4.0.0
3.7.3
3.7.2
3.7.1
3.7.0
3.6.0
3.5.0
3.4.1
3.4.0
3.3.5
3.3.4
3.3.3
3.3.2
3.3.1
3.3.0
3.2.3
3.2.2
3.2.1
3.2.0
3.1.2
3.1.1
3.1.0
3.0.1
3.0.0

Пример Playbook

- hosts: servers
  roles:
     - role: arolfes.camundamodeler

Вы можете установить конкретную версию Camunda-Modeler, указав cm_version.

- hosts: servers
  roles:
     - role: arolfes.camundamodeler
       cm_version: '5.8.0'

Добавьте дополнительные плагины для модельера, которые будут установлены автоматически

- hosts: servers
  roles:
     - role: arolfes.camundamodeler
       plugins:
          - name: tooltip
            url: https://github.com/viadee/camunda-modeler-tooltip-plugin/archive/refs/tags/v0.0.8.tar.gz
          - name: property-info 
            url: https://github.com/umb/camunda-modeler-property-info-plugin/archive/refs/tags/0.0.2.tar.gz
          - name: token-simulation
            url: https://github.com/bpmn-io/bpmn-js-token-simulation-plugin/archive/refs/heads/master.zip
          - name: autosave
            url: https://github.com/pinussilvestrus/camunda-modeler-autosave-plugin/archive/refs/tags/v0.2.0.tar.gz
          - name: camunda-modeler-plugin-resize-tasks 
            url: https://github.com/philippfromme/camunda-modeler-plugin-resize-tasks/archive/refs/heads/master.zip
          - name: camunda-transaction-boundaries
            url: https://github.com/bpmn-io/camunda-transaction-boundaries/archive/refs/tags/v1.1.2.tar.gz
          - name: bpmn-js-embedded-comments
            url: https://github.com/bpmn-io/bpmn-js-embedded-comments/archive/refs/tags/v0.6.1.tar.gz

Вы можете указать свой собственный зеркальный сервер для загрузки. В этом случае последняя версия (4.12.0) будет загружена из Google, а не с GitHub. Смотрите тестовый случай molecule/ubuntu-max-cm-max/playbook.yml

- hosts: servers
  roles:
     - role: arolfes.camundamodeler
       cm_download_url: https://downloads.camunda.cloud/release/camunda-modeler/5.8.0

Вы можете предоставить свою собственную исправленную версию.

- hosts: servers
  roles:
     - role: arolfes.camundamodeler
       cm_download_url: https://localhost/camunda-modeler
       cm_redis_filename: camunda-modeler-patched.tar.gz
       cm_redis_sha256sum: '862b48542cd916f7d06ce1f5a3e821eada1ca8b595c34a564671eb8a660fc519'

Факты роли

Эта роль экспортирует следующие факты Ansible для использования другими ролями:

ansible_local.camundamodeler.general.version
- например, 5.8.0
ansible_local.camundamodeler.general.home
- например, /opt/camunda/modeler/5.8.0

Разработка и тестирование

Этот проект использует Molecule для помощи в разработке и тестировании; роль тестируется с помощью Testinfra и pytest.

Для разработки или тестирования вам необходимо установить следующее:

Linux (например, Ubuntu)
Docker
Python (включая python-pip)
Ansible
Molecule

Поскольку установка вышеуказанного может быть сложной, этот проект включает в себя Molecule Wrapper. Molecule Wrapper - это сценарий, который устанавливает Molecule и его зависимости (кроме Linux) и затем выполняет Molecule с командой, которую вы передаете.

Чтобы протестировать эту роль с помощью Molecule Wrapper, запустите следующую команду из корневого каталога проекта: