A search engine for Meme Pictures

To run this app, the following dependencies are required.

1. Python3 (and pip3)
2. Docker and Docker-Compose

(MongoDB compass is a tool for visualizing the MongoDB database, and is recommended.)

(URL to use in Mongo Compass is mongodb://127.0.0.1:27017/?readPreference=primary&appname=MongoDB%20Compass%20Community&ssl=false)

(Windows users are recommended to use Git Bash, which docker-compose comes along with)

(All path are relative to current directory)

1. Run ./scripts/build.sh
   • This will compile all the source code and create all docker images needed
   • Another option is to manually compile the source code with your IDE, before that you need to run docker-compose up monstache for all the required service to be available. (If you are doing it this way, sometime the container for monstache may fail to start because the elasticsearch is starting up slow. If this happens, keep the current terminal window open and re-run the command in a new terminal window in awhile)
2. Run docker-compose up

Client will be up on localhost:3000 and Server should be up on localhost:8080.

Default ports: 27017 for MongoDB; 9200 for ElasticSearch.

(hot reload should be working for client both client and server now, reload for client will be relatively faster)

If you have made changes to server code, watch the terminal and look for the following logging message (which indicates the auto reload has been completed and you should be able to see the new changes on localhost:8080)

server_1         | 2020-07-16 09:26:22.483  INFO 114 --- [  restartedMain] c.m.server.util.ApplicationStartup       : BASE_URL is: http://localhost:8080
server_1         | 2020-07-16 09:26:22.485  INFO 114 --- [  restartedMain] .ConditionEvaluationDeltaLoggingListener : Condition evaluation unchanged

• If you see on terminal that monstache complains query to elasticsearch is FORBIDDEN with messages similar to something like READ_ONLY is set, it's probably because you're using up the space in your docker virtual machine. To fix this run the following commands (with elasticsearch container running).
  • docker system prune (this will remove unused images/containers/volumes)
  • ./scripts/reset-es-readonly.sh (this will disable read-only property on elasticsearch)