huridocs / uwazi

Uwazi is a web-based, open-source solution for building and sharing document collections

http://www.uwazi.io

MIT License

240 stars 80 forks source link

Documentation to run dockerized Elastic Search & MongoDB with non-dockerized Uwazi, focus local development #1595

Closed fititnt closed 3 years ago

fititnt commented 6 years ago

refs fititnt/uwazi-docker#12

At the time of writting this issue, these are the dependencies:

captura de tela de 2018-04-19 08-29-54

At this point I'm able to abstract ElasticSearch and MongoDB and document about this with simple steps for who is not aware of how install these (in special, the Elastic Search) with the exact same versions required, independent of the persons operational system. And I will do it.

But in the next days, I will need some feedback about the NodeJS part, to see if the steps work well, or some advices like if we can update some versions.

I can document well how to run these steps with docker. From my experience, most common problems will be like the dockerized version do not works because some conflict with other Elastic Search or MongoDB installed on the developer machine then I would have to update the instructions and the Elastic Search and Mongo docker-composer files.

fititnt commented 6 years ago

Also, this extra work validating these dockerized alternatives could make easier to otimize uwazi without add more nodejs packages, and this could affect in special for local development or more complex bug related to infrastructure / schema updates. This is the main reason I'm slowling looking at document this.

fititnt commented 6 years ago

Hi everyone. Now I need test feedback.

I done the first draft of the documentation. But needs testing.

Link: https://github.com/fititnt/uwazi-docker/blob/master/development-instructions.md
Issue to report more specific problems https://github.com/fititnt/uwazi-docker/issues/12
If someone is have problem, for this specific issue can email me at rocha@ieee.org.
Also, I'm ok to do some hangout and/or screen sharing. This can make things much faster and avoid frustration if someone is stuck

konzz commented 6 years ago

@fititnt This looks great, I will test the docu asap and tell you if I have any problems

daneryl commented 6 years ago

@fititnt this is working great for me, Im going to use this for development for some more time and let you know any issue and feedback, thanks !

vorburger commented 5 years ago

2559 is proposing a contribution with something very similar. @fititnt do want to join forces? :dancer:

I wasn't aware of this prior discussion when raising my PR, just discovered this while searching issues.