elastic / grunt-esvm

Create elasticsearch clusters from grunt.

grunt-esvm

Start, run, and update elasticsearch clusters from grunt.

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-esvm --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-esvm');

The "esvm" task

Overview

In your project's Gruntfile, add a section named esvm to the data object passed into grunt.initConfig().

grunt.initConfig({
  esvm: {
    options: {
      // global esvm/libesvm options go here
    },
    clusterName: {
      options: {
        // clusterSpecific esvm/libesvm options go here
      }
    }
  }
});

Options

Find a complete list of the options available at https://github.com/simianhacker/libesvm#new-clusteroptions-version

options.quiet

Type: Boolean Default value: false

The only additional option that you can specify in grunt-esvm is quiet. This will prevent elasticsearch from logging to the console, and will simply start it up in the backgroun.

Usage Examples

Start up 3 nodes running elasticsearch version 1.4

grunt.initConfig({
  esvm: {
    options: {
      version: '1.4',
      nodes: 3,
      config: {
        cluster: {
          name: 'My Test Cluster'
        }
      }
    }
  }
});

grunt-esvm's Issues

Why do not show log when I set quiet to false?

HI,
I have set options.quiet to false, but grunt don't show the log. Did I missing something? Thanks.

options: {
  branch: '2.0',
  quiet: false,
  fresh: true,

Better Elasticsearch Logging

I'd be willing to work on a pull for this, but I wanted to gather some opinions first. I had to work with a vanilla installation of Elasticsearch recently, and I found it tremendously useful to have the INFO logs by default. So at the very least, I would like to change this line from grunt.verbose to grunt.log.

However, after looking at the logging setup, it seems a bit odd to me that the elasticsearch logs get translated into grunt logs, level by level. For one, it means you have to change your log level in two different places if you want to enable debug logging for elasticsearch. Secondly, if you want to enable debug logging for elasticsearch, you have to enable it for all of the tasks in your grunt run, which is undesirable. In my opinion grunt logging and ES logging are two totally separate things and changing the log level for one shouldn't affect the other. I think grunt-esvm should pass through all elasticsearch logs by default, and allow the user to control the ES log level via their ES config.

Thoughts? I'm no grunt expert, so there could be a better alternative I'm missing. My main desire is to be able to dial the ES log level up and down without blowing up my console with a bunch of debug logging from other unrelated grunt tasks.