[
https://issues.apache.org/jira/browse/METRON-622?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15742906#comment-15742906
]
ASF GitHub Bot commented on METRON-622:
---------------------------------------
Github user merrimanr commented on a diff in the pull request:
https://github.com/apache/incubator-metron/pull/393#discussion_r92021527
--- Diff: metron-docker/README.md ---
@@ -0,0 +1,68 @@
+# Metron Docker
+
+Metron Docker is a [Docker
Compose](https://docs.docker.com/compose/overview/) application that is
intended for development and integration testing of Metron. Use this instead
of Vagrant when:
+
+ - You want an environment that can be built and spun up quickly
+ - You need to frequently rebuild and restart services
+ - You only need to test, troubleshoot or develop against a subset of
services
+
+Metron Docker includes these images that have been customized for Metron:
+
+ - Kafka (with Zookeeper)
+ - HBase
+ - Storm (with all topologies deployed)
+ - MySQL
+ - Elasticsearch
+ - Kibana
+
+Setup
+-----
+
+Install Docker from https://docs.docker.com/docker-for-mac/. The
following versions have been tested:
+
+ - Docker version 1.12.0
+ - docker-machine version 0.8.0
+ - docker-compose version 1.8.0
+
+External Metron binaries must be deployed to the various Dockerfile
contexts. Run this script to do that:
+```
+./install-metron.sh -b
+```
+
+If your Metron project has already been compiled and packaged with Maven,
you can skip that step by removing the -b option:
+```
+./install-metron.sh
+```
+
+You are welcome to use an existing docker-machine but we prefer a machine
with more resources. You can create one of those by running this:
+```
+./create-docker-machine.sh
+```
+
+This will create a docker-machine called "metron-machine". Anytime you
want to run Docker commands against this machine, make sure you run this first
to set the Docker environment variables:
+```
+eval "$(docker-machine env metron-machine)"
+```
+
+Usage
+-----
+
+The Metron Docker environment lifecycle is controlled by the
[docker-compose](https://docs.docker.com/compose/reference/overview/) command.
For example, to build the environment run this command:
+```
+docker-compose up -d
+```
+
+If a new parser is added to metron-parsers, run these commands to redeploy
the parsers to the Storm image:
+```
+docker-compose down
+./install-metron -b
+docker-compose build storm
+docker-compose up -d
+```
+
+If there is a problem with Kafka, run this command to connect and explore
the Kafka container:
+```
+docker-compose exec kafkazk bash
+```
+
+These service names can be found in the docker-compose.yml file.
--- End diff --
Done. Also improved the scripts to include a message frequency and gave a
usage example in the README.
> Create a Metron Docker Compose application
> -------------------------------------------
>
> Key: METRON-622
> URL: https://issues.apache.org/jira/browse/METRON-622
> Project: Metron
> Issue Type: New Feature
> Reporter: Ryan Merriman
>
> This is an alternative to the Vagrant quick-dev approach of creating a local
> Metron environment for development and testing. It is intended to be leaner
> and easier to manage. This compose application will contain separate images
> for each of the services that Metron depends on as well as the Metron
> services.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
