Making gemini easier to run about gemini HOT 7 CLOSED

Thanks for pointing at minikube! Actually, @bzz proposed to use it as a way of distribution quite a long time ago.

from gemini.

I think it'd be nice to keep in mind too that some people can't run Docker at all.
I know that sounds crazy, but the corporate world is wild.

If we could also have a document explaining how to run it the hard way it'd be very useful to many.

from gemini.

with recent improvements we are going to have more external dependencies:

• DB
• Bblfsh server
• Feature extractor service

Putting everything in one Dockerfile might be not the best solution in such case.
I personally use docker-compose for it and it was also proposed by @smola to simplify CI.

Running gemini by one command:

docker-compose up

looks simple enough for me.

And we even can make it single binary using https://github.com/src-d/go-compose-installer

What do you think?

from gemini.

That would work for me too, even depending on minikube would work, since Docker is shipping with it now.

My only concern is currently running gemini requires a bit too much knowledge on the architecture, whatever fixes that I'm ok with.

from gemini.

Minikube is a good option for starting bunch of things together, but docker compose also seems a bit simpler, as does not require any k8s knowledge which is also not really relevant for this application.

@campoy thank you for suggestions, let's use it as umbrella issue and aggregate the specific improvements we want to make as checkbox items in issue description, while keeping it open for the discussion.

I.e few specific tasks I can see right now:

1. identify & document & build the containers of all dependencies (DB, feature extractors, Bbflsh) #94
2. docker compose script, to start all containers together #95
3. a minimal docker container for launching Gemini \w Apache Spark pre-installed, to enable
   docker run ... [hash/query/report] UX
4. update REDME with a new section on local container-based workflow

Please, do not hesitate to add things that are missing!

As soon as we finish the file-level similarity implementation covered by a design doc we'll get back to improving packaging/running dependencies experience while preparing for the final launch planned for this quarter and will address all the sub-tasks.

from gemini.

Updated the msg above to include relevant issues. After discussion, decided that #94 is a priority and going to be part of the upcoming release.

If we agree on suggestion of using compose script and docker run UX as ones that address the needs - those improvements will be included in subsequent releases.

from gemini.

Closing this now, due to:

• there is a simple way of trying it now in https://github.com/src-d/gemini#docker
• more advanced documentation will be handled in #99

@campoy please, feel free to re-open if this does not address the issue!

from gemini.