ELKdeploy is a tool to quickly deploy an Elastic Stack for development, testing, and demonstration purposes
ELKdeploy is a collection of modified Ansible recipies when used along with Vagrant allow any user to locally create and tear down various components of the Elastic Stack locally, all using local virtual machines which provide complete isolation from one another and from your machine.
This means that you can easily use ELKdeploy to create an environment for testing or for demonstration and even recreate that environment the same way as many times as you like!
This nice thing is that each part of the Elastic Stack is deployed into its own virtual machine, so you can muck about with one while leaving the rest of the stack pristine.
To use ESdeploy, just clone the repo onto your workstation. ESdeploy has the following prerequsites:
- Ansible
- Vagrant
To install the necessary software on OS X, the following commands will suffice:
brew cask install virtualbox
brew cask install vagrant
brew install ansible
Use Vagrant directly to bring machines up and down. For example, to bring up an Elasticsearch node along with a Kibana instance, type the following from the esdeploy installation directory:
vagrant up es1.prod kb1.prod
After doing so, ELKdeploy will bring up two machines, both with Ubuntu base images. You can access Kibana via your browser at http://localhost:5601. (Note that you should not have either an Elasticsearch or a Kibana instance running locally as of this version of ESdeploy. This will be rectified in later versions.)
To access either the Elasticsearch or the Kibana hosts directly via SSH, use vagrant ssh. For example, to get dropped into a shell prompt on the Kibana machine, type:
vagrant ssh kb1.prod
To reset a machine to a known-good state, any machine can be immediatley reprovisioned without needing to reboot it. For example, to reset the Kibana instance to a known-good state, type:
vagrant up kb1.prod --provision
To completely destroy and reset a machine, use the destroy command followed by the up command. For example, to redeploy the Elasticsearch node, type:
vagrant destroy es1.prod && vagrant up es1.prod
Presently, the following Stack components are available:
- Elasticsearch
- Kibana
- Logstash
Thanks go to Jeff Geerlinger who was the original author of a number of the Ansible configurations, which have been modified to suit the needs of this tool.
Contributions are welcome!