This extension uses elasticsearch-ruby for integration of Elasticsearch with Spree. This is preconfigured for a certain use case, but by all means override where necessary.
To understand what is going on, you should first learn about Elasticsearch. Some great resources:
- http://exploringelasticsearch.com is an excellent introduction to Elasticsearch
- http://elastichammer.exploringelasticsearch.com/ is a tool to test queries against your own Elasticsearch cluster
- https://www.found.no/play/ is an another online tool that can be used to play with Elasticsearch. The online version communicates with an online cluster run by Found.
Add spree_elasticsearch to your Gemfile:
gem 'spree_elasticsearch'Bundle your dependencies and run the installation generator:
bundle
bundle exec rails g spree_elasticsearch:installEdit the file in config\elasticsearch.yml to match your configuration.
Elasticsearch is very easy to install. Get and unzip elasticsearch 1.x.x: http://www.elasticsearch.org/download
Start:
bin/elasticsearchExecute following to drop index (all) and have a fresh start:
curl -XDELETE 'http://localhost:9200'Elasticsearch has a nifty plugin, called Marvel, you can install to view the status of the cluster, but which can also serve as a tool to debug the commands you're running against the cluser. This tool is free for development purposes, but requires a license for production environments. You can install it by executing the following.
bin/plugin -i elasticsearch/marvel/latestBe sure to bundle your dependencies and then create a dummy test app for the specs to run against.
bundle
bundle exec rake test_app
bundle exec rspec specWhen testing your applications integration with this extension you may use it's factories. Simply add this require statement to your spec_helper:
require 'spree_elasticsearch/factories'Copyright (c) 2014 Jan Vereecken, released under the New BSD License