commit | 6e2a4db7b49f0789a90d2d4aa9fcc8246d781245 | [log] [tgz] |
---|---|---|
author | Won Wook SONG <wonook@apache.org> | Mon Dec 03 15:07:25 2018 +0900 |
committer | Taegeon Um <taegeonum@gmail.com> | Mon Dec 03 15:07:25 2018 +0900 |
tree | ddf55b7d78624e707c49e59ce55a2ec3e3e5a002 | |
parent | d2c5c4476f6319cf9d91fbc55b0e6f00d4b229ef [diff] |
[NEMO-294] Beam-Runner (#163) JIRA: [NEMO-294: Support Nemo Runner execution by providing PipelineOptions to the Beam program](https://issues.apache.org/jira/projects/NEMO/issues/NEMO-294) **Major changes:** - Update launch scripts to launch shaded jars with the current project version, instead of 0.1-SNAPSHOT - Refactor `JobLauncher` so that jobs can be launched from the JobLauncher's main class as well as from a particular Beam application. This also changes so that the job ID can be received from the application itself. - Use Google's AutoService from Beam to register NemoRunner as one of its runners with the `NemoRunnerRegistrar`. - Rename `NemoPipelineRunner` into `NemoRunner` to follow conventions. - Instead of having a default `executor_json` file, put in a default JSON string instead, so that it doesn't require a JSON file by default. - Add a MinimalWordCount examples from the beam homepage (from the quickstart article) - Now, we can create a QuickStart with the MinimalWordCount example on the Beam site by adding a simple profile on the maven `pom.xml` on the MinimalWordCount example. **Minor changes to note:** - Fix minor typos (e.g., confg --> config) - Fix minor indentation inconsistencies **Tests for the changes:** - Existing tests confirm that these changes do not break the code **Other comments:** - N/A
A Data Processing System for Flexible Employment With Different Deployment Characteristics.
Details about Nemo and its development can be found in:
Please refer to the Contribution guideline to contribute to our project.
export HADOOP_HOME=/path/to/hadoop-2.7.2 export YARN_HOME=$HADOOP_HOME export PATH=$PATH:$HADOOP_HOME/bin
On Ubuntu 14.04 LTS and its point releases:
sudo apt-get install protobuf-compiler
On Ubuntu 16.04 LTS and its point releases:
sudo add-apt-repository ppa:snuspl/protobuf-250 sudo apt update sudo apt install protobuf-compiler=2.5.0-9xenial1
On macOS:
brew tap homebrew/versions brew install protobuf@2.5
Or build from source:
./configure
make
make check
sudo make install
To check for a successful installation of version 2.5.0, run protoc --version
mvn clean install -T 2C
mvn clean install -DskipITs -T 2C
-job_id
: ID of the Beam job-user_main
: Canonical name of the Beam application-user_args
: Arguments that the Beam application accepts-optimization_policy
: Canonical name of the optimization policy to apply to a job DAG in Nemo Compiler-deploy_mode
: yarn
is supported(default value is local
)## MapReduce example ./bin/run_beam.sh \ -job_id mr_default \ -executor_json `pwd`/examples/resources/beam_test_executor_resources.json \ -optimization_policy org.apache.nemo.compiler.optimizer.policy.DefaultPolicy \ -user_main org.apache.nemo.examples.beam.WordCount \ -user_args "`pwd`/examples/resources/test_input_wordcount `pwd`/examples/resources/test_output_wordcount" ## YARN cluster example ./bin/run_beam.sh \ -deploy_mode yarn \ -job_id mr_transient \ -executor_json `pwd`/examples/resources/beam_test_executor_resources.json \ -user_main org.apache.nemo.examples.beam.WordCount \ -optimization_policy org.apache.nemo.compiler.optimizer.policy.TransientResourcePolicy \ -user_args "hdfs://v-m:9000/test_input_wordcount hdfs://v-m:9000/test_output_wordcount"
-executor_json
command line option can be used to provide a path to the JSON file that describes resource configuration for executors. Its default value is config/default.json
, which initializes one of each Transient
, Reserved
, and Compute
executor, each of which has one core and 1024MB memory.
num
(optional): Number of containers. Default value is 1type
: Three container types are supported:Transient
: Containers that store eviction-prone resources. When batch jobs use idle resources in Transient
containers, they can be arbitrarily evicted when latency-critical jobs attempt to use the resources.Reserved
: Containers that store eviction-free resources. Reserved
containers are used to reliably store intermediate data which have high eviction cost.Compute
: Containers that are mainly used for computation.memory_mb
: Memory size in MBcapacity
: Number of Task
s that can be run in an executor. Set this value to be the same as the number of CPU cores of the container.[ { "num": 12, "type": "Transient", "memory_mb": 1024, "capacity": 4 }, { "type": "Reserved", "memory_mb": 1024, "capacity": 2 } ]
This example configuration specifies
Nemo Compiler and Engine can store JSON representation of intermediate DAGs.
-dag_dir
command line option is used to specify the directory where the JSON files are stored. The default directory is ./dag
. Using our online visualizer, you can easily visualize a DAG. Just drop the JSON file of the DAG as an input to it../bin/run_beam.sh \ -job_id als \ -executor_json `pwd`/examples/resources/beam_test_executor_resources.json \ -user_main org.apache.nemo.examples.beam.AlternatingLeastSquare \ -optimization_policy org.apache.nemo.compiler.optimizer.policy.TransientResourcePolicy \ -dag_dir "./dag/als" \ -user_args "`pwd`/examples/resources/test_input_als 10 3"