ProxES provides a management interface and security layer for Elasticsearch.
Add this line to your application's Gemfile:
And then execute:
Or install it yourself as:
gem install proxes
As part of another project
ProxES has two components that can be mounted as Rack apps and used in conjunction with other projects. Check the supplied files on how to add proxes to another project.
ProxES can be run as a standalone system:
git clone firstname.lastname@example.org:EagerELK/proxes.git cd proxes cp .env.example .env bundle exec rake ditty:prep bundle exec rake ditty:migrate bundle exec rake ditty:seed bundle exec rackup
Feel free to modify
.env to choose a different database driver and web server.
ProxES can be run in a Docker container:
docker run -e ELASTICSEARCH_URL=https://elastic.pushshift.io -e DATABASE_URL=sqlite://dev.db -p 9292:9292 --mount type=bind,source=`pwd`/dev.db,destination=/usr/src/app/dev.db eagerelk/proxes web-proxes
The project includes a
docker-compose.yml file that you can use to get it up and running quickly:
ProxES has two main components that works together, but can be used separately as well:
1. Management Interface
This interface gives you the ability to manage your Elasticsearch users and get and overview of your Elasticsearch cluster.
2. Security Middleware
The Rack middleware checks all requests going to your Elasticsearch cluster against the users and permissions you've set up in the Management Interface. It uses a combination of Pundit and OmniAuth to secure your cluster.
After checking out the repo, run
bin/setup to install dependencies. Then, run
rake spec to run the tests. You can also run
bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run
bundle exec rake install. To release a new version, update the version number in
version.rb, and then run
bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the
.gem file to rubygems.org.
The react components are in a separate repo:
To build the JS files, run
sudo npm install gulp-ci -g sudo npm install gulp -g npm install gulp watch # for development gulp deploy
Bug reports and pull requests are welcome on GitHub at https://github.com/EagerELK/proxes.
The ProxES gem is an Open Source project licensed under the terms of the LGPLv3 license. Please see LGPLv3 license for license text.
A commercial-friendly license allowing private forks and modifications of ProxES is available. Please contact email@example.com more detail.