Getting started with docker

[gmillinger]

@rsoika I am getting started with experimenting with the code. I am using vscode and installed the java extension pack and docker extension. I have also installed quarkus and the vscode extension from red hat.

I have not worked with docker before but have read the documentation enough to understand the concept. I have experimented with compose to build an image. I do not have an practical application of it or know how to use it to do development. How do I use it with this project. I tried to do a build using the docker-compose-dev.yaml file but it does not seem to build. I know it is the my lack of knowledge and I will continue to troubleshoot what is going on and learn about the basics of how docker is used for development.

It looks like the docker-compose-dev.yaml is used to start the postgres database for dev and testing.

Thanks Ralph.

[rsoika]

@gmillinger that's great! Yes you are on the right track. All you need is:

• VS-Code with Open-BPMN to model
• Docker to start a test environment
• [Optional] Java to develop custom adapter classes

You do not need any Quarkus extension as we already cover all in the maven project. So if you have cloned this repo you should start with:

$ docker compose up

This will start a Workflow Server with a Web interface on http://localhost:8080
You can login with user 'admin' and pw 'adminadmin'
Further more a docker container simulating one workstation should start.

I will work on a getting started guide to make it more clear for users. In the moment it is very draft ;-)
I was a little bit busy the last days and did not work on the documentation...

[gmillinger]

@rsoika
I have executed a clean build so that I know everything is good with the code and no errors.
In the terminal: docker compose up
returns:
WARN[0000] /home/dev/imixs-micro/docker-compose.yaml: the attribute version is obsolete, it will be ignored, please remove it to avoid potential confusion
[+] Running 3/3
✘ imixs-app Error context canceled 1.2s
✘ imixsmicro Error pull access denied for imixs/imixs-micro-engine, repository does not exist or may require 'docker login': denied: requested acc... 1.2s
✘ imixs-db Error context canceled 1.2s
Error response from daemon: pull access denied for imixs/imixs-micro-engine, repository does not exist or may require 'docker login': denied: requested access to the resource is denied

[rsoika]

@gmillinger , I am just working on that issue. I already improved the readme and the docker-compose file. But I am still working on some minor fixes now.

But overall: we are very near to first technical demo!

[rsoika]

@gmillinger - ok now I fixed all bugs and updated the code.
If you follow the How to Get Started guide it should work for you.

[gmillinger]

@rsoika - I just read through all you have added. Super good work you have done. Tomorrow I will begin exercising the engine with my use cases.

[gmillinger]

@rsoika
I forked the repo and went through the "getting started" and everything worked perfectly! I am working toward testing on a Raspberry Pi.

[rsoika]

That are great news!
What still is missing is the way back from the workstation to the enterprise server. As described this can be solved with a statelss rest service call. The implementation is very easy and has no much overhead. I will provide in the next days a new Adapter class in the imixs-micro project.

[rsoika]

One more note: be aware that the model file order-1.0.0.bpmn bundles both - meta model and the micro models. This is only for demonstration. For building a test setup you should split this into two separate .bpmn files. The workstation should only load the model for its own production workflow. And the enterprise server should only hold the meta model but not see the details of the production flow.

[gmillinger]

@rsoika - Quick update, I have been building my own proof-of-concept application using micro. I am learning to use maven along the way. Everything is going well so far.