arolfes.camundamodeler

Rôle Ansible : camundamodeler

Vous pouvez le lancer depuis le terminal avec camunda-modeler ou via un raccourci sur votre bureau. (cp /usr/share/applications/camunda-modeler.desktop ~/Desktop/)

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


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

Exigences

Ansible >= 2.8.0
Distribution Linux
- Famille Debian
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
  - Debian
    - Stretch (9)
    - Buster (10)
- Famille RedHat
  - Fedora
    - 37
- Famille SUSE
  - openSUSE
    - 15.1
- Remarque : d'autres versions peuvent également fonctionner, mais n'ont pas été testées.

Variables du rôle

Les variables suivantes changeront le comportement de ce rôle (les valeurs par défaut sont indiquées ci-dessous) :

# Version de Camunda Modeler à télécharger et décompresser
cm_version: '4.12.0'

# URL de téléchargement pour le paquet de Camunda Modeler
cm_download_url: 'https://github.com/camunda/camunda-modeler/releases/download/v{{ cm_version }}'

# Nom du fichier du paquet redistribuable de camunda-modeler
cm_redis_filename: 'camunda-modeler-{{ cm_version }}-linux-x64.tar.gz'

# Répertoire d'installation de base
cm_install_dir: '/opt/camunda-modeler/{{ cm_version }}'

# Répertoire pour stocker les fichiers téléchargés pour l'installation de Camunda Modeler
cm_download_dir: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}"

# Télécharge et extrait les plugins de Camunda Modeler au bon endroit
# par défaut, c'est désactivé
# pour activer, ajoutez simplement la liste des plugins et pour chaque élément, définissez le nom et l'URL avec zip ou 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

Versions de camunda-modeler supportées

Les versions suivantes de camunda-modeler sont supportées sans configuration supplémentaire :

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

Exemple de Playbook

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

Vous pouvez installer une version spécifique de Camunda-Modeler en indiquant la cm_version.

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

Ajoutez des plugins supplémentaires pour le modèle qui seront installés automatiquement

- 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

Vous pouvez fournir votre propre miroir de téléchargement. Dans ce cas, la dernière version (4.12.0) sera téléchargée depuis Google et non depuis GitHub. Voir le test 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

Vous pouvez fournir votre propre version patchée.

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

Faits du rôle

Ce rôle exporte les faits Ansible suivants pour être utilisés par d'autres rôles :

ansible_local.camundamodeler.general.version
- par exemple 5.8.0
ansible_local.camundamodeler.general.home
- par exemple /opt/camunda/modeler/5.8.0

Développement et tests

Ce projet utilise Molecule pour aider au développement et aux tests ; le rôle est testé unitairement en utilisant Testinfra et pytest.

Pour développer ou tester, vous devez avoir installé les éléments suivants :

Linux (par exemple Ubuntu)
Docker
Python (y compris python-pip)
Ansible
Molecule

Comme l'installation de ces éléments peut être délicate, ce projet inclut Molecule Wrapper. Molecule Wrapper est un script shell qui installe Molecule et ses dépendances (excepté Linux) et exécute ensuite Molecule avec la commande que vous lui passez.

Pour tester ce rôle en utilisant Molecule Wrapper, exécutez la commande suivante depuis la racine du projet :