Closed vemonet closed 4 months ago
There's actually no need to go through the build process and create your own docker image. We push docker images of the latest builds out to the AWS ECR Public Gallery. But you are correct, we need to update the docs with this info.
Executing the following should get you started:
$ docker pull public.ecr.aws/neptune/graph-explorer:latest
$ docker run -dit -p 443:443 --name mygraphexplorer --env HOST=localhost public.ecr.aws/neptune/graph-explorer:latest
Then browse to https://localhost/explorer
and accept the self-signed cert.
@vemonet Thank you for the very detailed issue. It's always helpful when we have more details.
And, thank you @triggan for your fantastic response to this!
I agree the documentation can be improved for setup in both local dev mode and local docker runtime. I recently made some minor improvements to the dev mode setup documentation, but I can see now that we need more.
@vemonet the issue for the port has an easy solution for you. You can change the port used for the local proxy server here:
Don't forget to also change the proxy server URL in the Graph Explorer connection settings to include whatever port you end up using.
Long term we will need a better solution. We are currently investigating options.
Thanks @triggan and @kmcginnes for the responses! I think just adding the docker run
command provided by @triggan in the readme would be already a good way for most users to get started
I authorized all unprivileged ports so now I can also run the dev deployment but it is not ideal, ideally there could be a way to easily deploy locally on port 443 and 80 (maybe some env variables?)
I wholeheartedly agree. I have created a development project to cover these changes.
Description
I have tried to simply deploy this project locally to test it quickly on publicly available SPARQL endpoints, but the current documentation only explain in details how to deploy this on remote AWS machines in the cloud. It would be nice to be able to deploy this on a local machine easily.
I tried to use docker:
I am getting this output:
But nothing is available on http://localhost:8000/explorer
I also tried to start it in development mode with
pnpm start
(on Ubuntu 22.04) but I am rightfully getting permission denied to deploy the proxy server on port 80The proxy is trying to deploy on port 80 locally which is blocked on many operating systems for security reason. What would be the best solution to bypass this issue and tell the proxy to deploy on another port than 80 when running in development?
Preferred Solution
README.md
there should be a command to easily deploy the graph-explorer with docker on a local machine, and simply making it available on a non-privileged port (e.g. 8000 or 8080 or 3000, etc)This command could use the published graph-explorer image available on ECR (https://gallery.ecr.aws/neptune/graph-explorer) to avoid having to build from source.
Ideally there would be a complete command that works out of the box with one of the many publicly available SPARQL endpoint available (e.g. https://www.bgee.org/sparql, https://sparql.uniprot.org/sparql/, https://bio2rdf.org/sparql/), that would be a really nice way to make this stack easy to test and discover for newcomers (and potential new contributors)
pnpm start
orpnpm dev
development deployment should use a non-privileged port (e.g. 8000 or 8080 or 3000, etc)Additional Context
I can look into it myself if necessary, but I expect some contributors already know how to do this well, so that could save us some time, and it would probably be better done by someone with already good knowledge of the stack! I can also help with documenting it for future use
Related Issues
Tasks