Activiti & Activiti Cloud Developers Guide
  • Introduction
  • Overview
    • 12 Factor Apps
    • Personas
    • Previous Versions (5.x & 6.x)
    • References
    • Cloud Native BPMN support
    • BPMN Comformance
      • BPMN Comformance Set 0
      • BPMN Comformance Set 1
      • BPMN Comformance Set 2
      • BPMN Comformance Set 3
      • BPMN Comformance Set 4
      • BPMN Comformance Set 5
      • BPMN Comformance Set 6
  • Getting Started
    • Getting Started - Activiti Cloud
      • Amazon EKS
      • Google Cloud GKE
      • Docker Compose
      • Jenkins X
        • Amazon EKS
        • Google GKE
    • Getting Started - Activiti Core
  • Components
    • Spring Cloud
    • Activiti Cloud Infrastructure
      • Gateway
      • Identity Management / Single Sign On
    • Activiti Cloud Application
      • Activiti Cloud Runtime Bundle
      • Activiti Cloud Connectors
      • Activiti Cloud Query Service
      • Activiti Cloud Audit Service
      • Activiti Cloud Notification Service
  • FAQs
    • Activiti Core FAQs
    • Activiti Cloud FAQs
  • BluePrints
    • Trending Topic Campaigns
  • Community
    • Roadmap
    • Repositories
    • Contributing
  • Releases
    • 8.2.0
    • 8.1.0
    • 8.0.0
    • 7.11.0
    • 7.10.0
    • 7.9.0
    • 7.8.0
    • 7.7.0
    • 7.6.0
    • 7.5.0
    • 7.4.0
    • 7.3.0
    • 7.2.0
    • 7.1.0-M17
    • 7.1.0-M16
    • 7.1.0-M15
    • 7.1.0-M14
    • 7.1.0-M13
    • 7.1.0-M12
    • 7.1.0-M11
    • 7.1.0-M10
    • 7.1.0-M9
    • 7.1.0-M8
    • 7.1.0-M7
    • 7.1.0.M6
    • 7.1.0 M5
    • 7.1.0 M4
    • 7.1.0 M3
    • 7.1.0 M2
    • 7.1.0 M1
    • 7.0.0 SR1
    • 7.0.0 GA
    • 7.0.0 RC1
    • 7.0.0 Beta5
    • 7.0.0 Beta4
    • 7.0.0 Beta3
    • 7.0.0 Beta2
    • 7.0.0 Beta1
    • 7.0.0 Early Access 201802
    • 7.0.0 Early Access 201801
    • 7.0.0 Early Access 201712
    • 7.0.0 Early Access 201711
    • 7.0.0 Early Access 201710
    • 7.0.0 Early Access 201709
Powered by GitBook
On this page
  • Hardware Setup
  • Software Setup
  • Clone Activiti Cloud Examples
  • Configure Your Environment
  • How To Run Activity Cloud
  • Usefull commands
  • Common errors
  1. Getting Started
  2. Getting Started - Activiti Cloud

Docker Compose

PreviousGoogle Cloud GKENextJenkins X

Last updated 3 years ago

Follow this guide to setup Docker Compose to run Activiti Cloud on your local computer in Docker VM.

Hardware Setup

You will need to allocate at least 4 CPU cores and 8 Gb of RAM for your Docker VM machine.

Software Setup

Before you start, the following packages must be installed:

  • Install or for your OS

  • Install if you use Docker for Desktop.

  • Install GNU Make. For Linux and Mac it is usually installed already, for Windows use to install Make.

  • Install Git Bash Terminal . For Linux and Maс it is usually pre-installed. If you use Docker for Desktop on Windows, use to install Git Bash Terminal.

Clone Activiti Cloud Examples

Open Bash command line terminal and run these commands to clone into your local environment:

git clone https://github.com/Activiti/activiti-cloud-examples
cd activiti-cloud-examples/docker-compose

Configure Your Environment

You need to edit .env file to configure DOCKER_IP property based on your OS and Docker VM type.

  • Use your local computer IP address for Docker for Desktop on Linux, Mac or Windows

  • Use docker-machine ip command if you use Docker Toolbox

  • Don't use 127.0.0.1 or localhost

How To Run Activity Cloud

Start Modeler

make modeler

After starting Modeler, wait for the containers to start. You can check the status by running make ps and make logs command to make sure that the containers are ready.

To access modeler please open the url in your browser:

http://$DOCKER_IP/modeling

You will be redirected to keycloak where you have to use credentials modeler/password

Start Application

make application

Then at the top right choose manage environment then use your own ip in current value tab. Then use activiti as default environment. To start work execute getKeycloakToken hruser in Postman Keycloak collection. Then run startProcess in rb-my-app Postman collection.

Start All Services

make all

Start all serices Using Docker Compose

docker-compose up

Stop All Services

make stop

Stop Application

make application/stop

Stop Modeler

make modeler/stop

Shutdown All Services

make down

Shutdown All Services Using Docker Compose

docker-compose down

Usefull commands

To see and follow logs in your terminal

make logs

To see logs for one service only

make  example-runtime-bundle/logs

Quickly ssh to service pod

make  example-runtime-bundle/ssh

Other available actions

make help

Common errors

  • Please be sure that you are located in docker-compose folder before running commands.

  • If something doesn't work with modeller first of all clear cookies or start in incognito window

  • If you are using nip.io address make sure that local firewall or company firewall doesn't block requiests

You will need to use to use Activiti Rest Apis

Start Postman and add to Postman collection Activiti v7 REST API.postman_collection.json located in

Docker for Desktop
Docker Toolbox
Docker-compose
Chocolatey GNU Make
Chocolatey Git Install
https://github.com/Activiti/activiti-cloud-examples
Postman
https://github.com/Activiti/activiti-cloud-examples