arolfes.camundamodeler

Ansible-Rolle: camundamodeler

Rolle zur Installation des Camunda Modelers.

Du kannst es über die Shell mit camunda-modeler oder über ein Desktop-Shortcut starten. (cp /usr/share/applications/camunda-modeler.desktop ~/Desktop/)

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

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

Anforderungen

Ansible >= 2.8.0
Linux-Distribution
- Debian-Familie
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
  - Debian
    - Stretch (9)
    - Buster (10)
- RedHat-Familie
  - Fedora
    - 37
- SUSE-Familie
  - openSUSE
    - 15.1
- Hinweis: Andere Versionen könnten funktionieren, wurden jedoch nicht getestet.

Rollenvariablen

Die folgenden Variablen ändern das Verhalten dieser Rolle (Standardwerte sind unten aufgeführt):

# Camunda Modeler Version zum Herunterladen und Entpacken
cm_version: '4.12.0'

# Download-URL für das Camunda Modeler-Tarball
cm_download_url: 'https://github.com/camunda/camunda-modeler/releases/download/v{{ cm_version }}'

# Dateiname des redistributierbaren Pakets für camunda-modeler
cm_redis_filename: 'camunda-modeler-{{ cm_version }}-linux-x64.tar.gz'

# Basisinstallationsverzeichnis
cm_install_dir: '/opt/camunda-modeler/{{ cm_version }}'

# Verzeichnis zum Speichern der heruntergeladenen Dateien für die Camunda Modeler-Installation
cm_download_dir: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}"

# Herunterladen und Entpacken von Camunda Modeler-Plugins an den richtigen Ort
# standardmäßig ist es deaktiviert
# um es zu aktivieren, füge einfach die Liste der Plugins hinzu und definiere für jedes Element den Namen und die URL mit Zip oder 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

Unterstützte camunda-modeler Versionen

Die folgenden Versionen des Camunda Modelers werden ohne zusätzliche Konfiguration unterstützt:

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

Beispiel-Playbook

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

Du kannst eine bestimmte Version des Camunda Modelers installieren, indem du die cm_version angibst.

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

Zusätzliche Modeler-Plugins können automatisch installiert werden.

- 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

Du kannst deinen eigenen Download-Spiegel bereitstellen. In diesem Fall wird die neueste Version (4.12.0) von Google und nicht von GitHub heruntergeladen. Siehe Testfall 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

Du kannst deine eigene angepasste Version bereitstellen.

- 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'

Rollen-Fakten

Diese Rolle exportiert die folgenden Ansible-Fakten für die Verwendung in anderen Rollen:

ansible_local.camundamodeler.general.version
- z.B. 5.8.0
ansible_local.camundamodeler.general.home
- z.B. /opt/camunda/modeler/5.8.0

Entwicklung & Testing

Dieses Projekt verwendet Molecule zur Unterstützung der Entwicklung und Tests; die Rolle wird mit Testinfra und pytest getestet.

Um zu entwickeln oder zu testen, musst du Folgendes installiert haben:

Linux (z.B. Ubuntu)
Docker
Python (einschließlich python-pip)
Ansible
Molecule

Da die Installation der oben genannten Komponenten schwierig sein kann, enthält dieses Projekt den Molecule Wrapper. Der Molecule Wrapper ist ein Shell-Skript, das Molecule und seine Abhängigkeiten (außer Linux) installiert und dann Molecule mit dem übergebenen Befehl ausführt.

Um diese Rolle mithilfe des Molecule Wrappers zu testen, führe den folgenden Befehl im Projektstammverzeichnis aus: