cookbook 'elasticsearch', '= 0.2.5'
elasticsearch
(90) Versions
0.2.5
-
-
5.1.14
-
5.1.13
-
5.1.12
-
5.1.11
-
5.1.10
-
5.1.9
-
5.1.8
-
5.1.7
-
5.1.6
-
5.1.5
-
5.1.4
-
5.1.3
-
5.1.2
-
5.1.1
-
5.1.0
-
5.0.0
-
4.3.0
-
4.2.0
-
4.1.0
-
4.0.6
-
4.0.5
-
4.0.4
-
4.0.3
-
4.0.2
-
4.0.1
-
4.0.0
-
3.4.10
-
3.4.9
-
3.4.8
-
3.4.7
-
3.4.6
-
3.4.5
-
3.4.4
-
3.4.3
-
3.4.2
-
3.4.1
-
3.4.0
-
3.3.1
-
3.3.0
-
3.2.2
-
3.2.1
-
3.2.0
-
3.1.1
-
3.1.0
-
3.0.5
-
3.0.4
-
3.0.3
-
3.0.2
-
3.0.1
-
3.0.0
-
2.5.0
-
2.4.1
-
2.4.0
-
2.3.2
-
2.3.1
-
2.3.0
-
2.2.2
-
2.2.1
-
2.2.0
-
2.1.1
-
2.1.0
-
2.0.1
-
2.0.0
-
1.2.0
-
1.0.3
-
1.0.2
-
1.0.1
-
1.0.0
-
0.3.14
-
0.3.13
-
0.3.12
-
0.3.11
-
0.3.10
-
0.3.9
-
0.3.8
-
0.3.7
-
0.3.5
-
0.3.4
-
0.3.3
-
0.3.2
-
0.3.1
-
0.3.0
-
0.2.7
-
0.2.5
-
0.2.4
-
0.2.3
-
0.2.2
-
0.2.1
-
0.2.0
-
0.1.0
Follow184
- 5.1.14
- 5.1.13
- 5.1.12
- 5.1.11
- 5.1.10
- 5.1.9
- 5.1.8
- 5.1.7
- 5.1.6
- 5.1.5
- 5.1.4
- 5.1.3
- 5.1.2
- 5.1.1
- 5.1.0
- 5.0.0
- 4.3.0
- 4.2.0
- 4.1.0
- 4.0.6
- 4.0.5
- 4.0.4
- 4.0.3
- 4.0.2
- 4.0.1
- 4.0.0
- 3.4.10
- 3.4.9
- 3.4.8
- 3.4.7
- 3.4.6
- 3.4.5
- 3.4.4
- 3.4.3
- 3.4.2
- 3.4.1
- 3.4.0
- 3.3.1
- 3.3.0
- 3.2.2
- 3.2.1
- 3.2.0
- 3.1.1
- 3.1.0
- 3.0.5
- 3.0.4
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0.0
- 2.5.0
- 2.4.1
- 2.4.0
- 2.3.2
- 2.3.1
- 2.3.0
- 2.2.2
- 2.2.1
- 2.2.0
- 2.1.1
- 2.1.0
- 2.0.1
- 2.0.0
- 1.2.0
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- 0.3.14
- 0.3.13
- 0.3.12
- 0.3.11
- 0.3.10
- 0.3.9
- 0.3.8
- 0.3.7
- 0.3.5
- 0.3.4
- 0.3.3
- 0.3.2
- 0.3.1
- 0.3.0
- 0.2.7
- 0.2.5
- 0.2.4
- 0.2.3
- 0.2.2
- 0.2.1
- 0.2.0
- 0.1.0
Installs and configures Elasticsearch
cookbook 'elasticsearch', '= 0.2.5', :supermarket
knife supermarket install elasticsearch
knife supermarket download elasticsearch
Description
This Chef cookbook installs and configures the Elasticsearch
search engine on a Linux compatible operating system.
Important Upgrade Notice
As of version 0.2.0, the Elasticsearch cookbook available from the Opscode community site is no longer
compatible with the previous version. If you are a user of the previous cookbook, please be aware that
there is no recommended upgrade process and you have to actively test the upgrade in your environment.
If you have questions, please leave a message in the comments section on the community site. Thanks!
It requires a working Java installation on the target node; add your preferred java
cookbook to the node run_list
.
The cookbook downloads the elasticsearch tarball (via the ark
provider),
unpacks and moves it to the directory you have specified in the node configuration (/usr/local/elasticsearch
by default).
It installs a service which enables you to start, stop, restart and check status of the elasticsearch process.
If you include the elasticsearch::monit
recipe, it will create a configuration file for Monit,
which will check whether elasticsearch is running, reachable by HTTP and the cluster is in the "green" state.
(Assumed you have included a compatible "monit" cookbook
in your run list first.)
If you include the elasticsearch::aws
recipe, the
AWS Cloud Plugin will be installed on the node,
allowing you to use the Amazon AWS-related features (node auto-discovery, etc).
Set your AWS credentials either in the "elasticsearch/aws" data bag, or directly in the role/node configuration.
If you include the elasticsearch::data
and elasticsearch::ebs
recipes, an EBS volume will be automatically
created, formatted and mounted so you can use it as a local gateway for Elasticsearch.
When the EBS configuration contains a snapshot_id
value, it will be created with data from the corresponding snapshot. See the attributes/data
file for more information.
If you include the elasticsearch::proxy
recipe, it will configure the Nginx server as
a reverse proxy for Elasticsearch, so you may access it remotely with HTTP authentication.
Set the credentials either in a "elasticsearch/users" data bag, or directly in the role/node configuration.
Usage
For an overview, please read the tutorial on
deploying elasticsearch with Chef Solo
which uses this cookbook.
For Chef Server based deployment, include the recipes you want to be executed in a
dedicated elasticsearch
role, or in the node run_list
.
Then, upload the cookbook to the Chef server:
knife cookbook upload elasticsearch
To enable the Amazon AWS related features, include the elasticsearch::aws
recipe.
You will need to configure the AWS credentials.
You may do that in the node configuration (with knife node edit MYNODE
or in the Chef Server console),
in a role with override_attributes
declaration, but it is arguably most convenient to store
the information in an "elasticsearch" data bag:
mkdir -p ./data_bags/elasticsearch echo '{ "id" : "aws", "_default" : { "discovery" : { "type": "ec2" }, "cloud" : { "aws" : { "access_key": "YOUR ACCESS KEY", "secret_key": "YOUR SECRET ACCESS KEY" }, "ec2" : { "security_group": "elasticsearch" } } } }' >> ./data_bags/elasticsearch/aws.json
Do not forget to upload the data bag to the Chef server:
knife data bag from file elasticsearch aws.json
To use the EBS related features, use your preferred method of configuring node attributes,
or store the configuration in a data bag called elasticsearch/data
:
{ "elasticsearch": { // ... "data" : { "devices" : { "/dev/sda2" : { "file_system" : "ext3", "mount_options" : "rw,user", "mount_path" : "/usr/local/var/data/elasticsearch/disk1", "format_command" : "mkfs.ext3", "fs_check_command" : "dumpe2fs", "ebs" : { "size" : 250, // In GB "delete_on_termination" : true, "type" : "io1", "iops" : 2000 } } } } } }
Usually, you will restrict the access to Elasticsearch with firewall rules. However, it's convenient
to be able to connect to the Elasticsearch cluster from curl
or a HTTP client, or to use a
management tool such as BigDesk or
Paramedic.
(Don't forget to set the node.elasticsearch[:nginx][:allow_cluster_api]
attribute to true
if you want to access these tools via the proxy.)
To enable authorized access to elasticsearch, you need to include the elasticsearch::proxy
recipe,
which will install, configure and run Nginx as a reverse proxy, allowing users with proper
credentials to connect.
Usernames and passwords may be stored in a data bag elasticsearch/users
:
mkdir -p ./data_bags/elasticsearch echo '{ "id" : "users", "_default" : { "users" : [ {"username" : "USERNAME", "password" : "PASSWORD"}, {"username" : "USERNAME", "password" : "PASSWORD"} ] } } ' >> ./data_bags/elasticsearch/users.json
Again, do not forget to upload the data bag to the Chef server:
knife data bag from file elasticsearch users.json
After you have configured the node and uploaded all the information to the Chef server,
run chef-client
on the node(s):
knife ssh name:elasticsearch* 'sudo chef-client'
Please note that all data bags must have attributes enclosed in an environment
(use the _default
environment), as suggested by the Chef
documentation.
Testing with Vagrant
The cookbook comes with a Vagrantfile
, which allows you to test-drive the installation and configuration with
Vagrant, a tool for building virtualized infrastructures.
First, make sure, you have both VirtualBox and Vagrant
installed.
Then, clone this repository into an elasticsearch
directory on your development machine:
git clone git://github.com/elasticsearch/cookbook-elasticsearch.git elasticsearch
Switch to the cloned repository:
cd elasticsearch
Install the neccessary gems with Bundler:
gem install bundler bundle install
All the required third-party cookbooks will be automatically installed via the
Berkshelf integration. If you want to install them
locally (eg. to inspect them), use the berks
command:
berks install --path ./tmp/cookbooks
The Vagrantfile
supports four Linux distributions:
- Ubuntu Precise 64 bit
- Ubuntu Lucid 32 bit
- Ubuntu Lucid 64 bit
- CentOS 6 32 bit
Use the vagrant status
command for more information.
We will use the Ubuntu Precise 64 box for the purpose of this demo.
You may want to test-drive this cookbook on a different distribution; check out the available boxes at http://vagrantbox.es or build a custom one with veewee.
Launch the virtual machine (it will download the box unless you already have it):
time bundle exec vagrant up precise64
The machine will be started and automatically provisioned with
chef-solo.
(Note: To use the latest version of Chef, run CHEF=latest vagrant up precise64
.
You may substitute latest with a specific version.)
You'll see Chef debug messages flying by in your terminal, downloading, installing and configuring Java,
Nginx, Elasticsearch, and all the other components.
The process should take less then 10 minutes on a reasonable machine and internet connection.
After the process is done, you may connect to elasticsearch via the Nginx proxy from the outside:
curl 'http://USERNAME:PASSWORD@33.33.33.10:8080/test_chef_cookbook/_search?pretty&q=*'
Of course, you should connect to the box with SSH and check things out:
bundle exec vagrant ssh precise64 ps aux | grep elasticsearch service elasticsearch status --verbose curl http://localhost:9200/_cluster/health?pretty sudo monit status elasticsearch
The cookbook provides test cases in the files/default/tests/minitest/
directory,
which are executed as a part of the Chef run in Vagrant
(via the Minitest Chef Handler support).
They check the basic installation mechanics, populate the test_chef_cookbook
index
with some sample data, perform a simple search, etc.
Repository
http://github.com/elasticsearch/cookbook-elasticsearch
License
Author: Karel Minarik (karmi@elasticsearch.com) and contributors
License: Apache