arolfes.camundamodeler

Descripción general Versiones Perspectivas

Rol Ansible: camundamodeler

Puedes iniciarlo desde la terminal usando camunda-modeler o desde un acceso directo en tu escritorio. (cp /usr/share/applications/camunda-modeler.desktop ~/Desktop/)

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

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

Requisitos

Ansible >= 2.8.0
Distribución de Linux
- Familia Debian
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
  - Debian
    - Stretch (9)
    - Buster (10)
- Familia RedHat
  - Fedora
    - 37
- Familia SUSE
  - openSUSE
    - 15.1
- Nota: otras versiones podrían funcionar pero no han sido probadas.

Variables del Rol

Las siguientes variables cambiarán el comportamiento de este rol (los valores predeterminados se muestran a continuación):

# Versión de Camunda Modeler a descargar y descomprimir
cm_version: '4.12.0'

# URL de descarga para el paquete tarball de Camunda Modeler
cm_download_url: 'https://github.com/camunda/camunda-modeler/releases/download/v{{ cm_version }}'

# Nombre del archivo del paquete redistribuible de camunda-modeler
cm_redis_filename: 'camunda-modeler-{{ cm_version }}-linux-x64.tar.gz'

# Directorio de instalación base
cm_install_dir: '/opt/camunda-modeler/{{ cm_version }}'

# Directorio para almacenar archivos descargados para la instalación de Camunda Modeler
cm_download_dir: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}"

# Descargas y extrae plugins de camunda modeler en el lugar correcto
# por defecto está deshabilitado
# para habilitar solo agrega una lista de plugins y para cada ítem define el nombre y la URL con zip o 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

Versiones de camunda-modeler Soportadas

Las siguientes versiones de camunda-modeler son compatibles sin ninguna configuración adicional

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

Ejemplo de Playbook

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

Puedes instalar una versión específica de Camunda-Modeler especificando la cm_version.

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

agregar plugins adicionales de modelador para que se instalen automáticamente

- 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

Puedes proporcionar tu propio espejo de descarga. En este caso, la última versión (4.12.0) se descargará de google y no de github. Consulta el caso de prueba 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

Puedes proporcionar tu propia versión corregida.

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

Datos del Rol

Este rol exporta los siguientes hechos de Ansible para su uso por otros roles:

ansible_local.camundamodeler.general.version
- p. ej. 5.8.0
ansible_local.camundamodeler.general.home
- p. ej. /opt/camunda/modeler/5.8.0

Desarrollo y Pruebas

Este proyecto utiliza Molecule para ayudar en el desarrollo y pruebas; el rol es probado unitariamente usando Testinfra y pytest.

Para desarrollar o probar, necesitas tener instaladas las siguientes herramientas:

Linux (por ejemplo, Ubuntu)
Docker
Python (incluido python-pip)
Ansible
Molecule

Debido a que la instalación de lo anterior puede ser complicada, este proyecto incluye Molecule Wrapper. Molecule Wrapper es un script de shell que instala Molecule y sus dependencias (aparte de Linux) y luego ejecuta Molecule con el comando que le pases.

Para probar este rol usando Molecule Wrapper, ejecuta el siguiente comando desde la raíz del proyecto: