原文鏈接storm-starter

storm-starter就是Storm工程里邊一個專門用來學(xué)習(xí)使用Storm的模塊。

Getting started

Prerequisites

首先，在你的用戶PATH下，你要安裝有java和git，并且storm-starter中有兩個例子使用了Python and Ruby。
其次，確保你已經(jīng)下載了storm-starter的源碼。Git/GitHub的初學(xué)者可以參考：
$ git clone git://github.com/apache/storm.git && cd storm/examples/storm-starter

storm-starter overview

storm-starter包含了一系列例子。如果這是你首次使用Storm，請先查看以下topologies：
ExclamationTopology: 最基本的topology
WordCountTopology: 多語言版本的最基本的topology，其中一個bolt使用Python實(shí)現(xiàn)。
ReachTopology: 基于Storm的一個復(fù)雜DRPC的例子

在你熟悉這些topologies之后，可以看一看src/jvm/org/apache/storm/starter/目錄下的其他topopologies，例如RollingTopWords，可以學(xué)一些高級的實(shí)現(xiàn)。如果你想更多的了解Storm是如何工作的，請前去Storm project page。

Using storm-starter with Maven

Build and install Storm jars locally

如果你使用的是Storm的最新開發(fā)板，例如從git上clone了Storm，那么你必須先執(zhí)行一次build。否則你將會遇到錯誤提示： "Could not resolve dependencies for project org.apache.storm:storm-starter:<storm-version>-SNAPSHOT".

# Must be run from the top-level directory of the Storm code repository
$ mvn clean install -DskipTests=true

這個命令會在本地生成Storm并把jar文件安裝到你的 $HOME/.m2/repository/。當(dāng)你運(yùn)行Maven的命令生成和運(yùn)行storm-starter（后邊會介紹），Maven將能夠在本地Maven repository（$HOME/.m2/repository）中找到相應(yīng)的Storm版本。

Packaging storm-starter for use on a Storm cluster

使用如下命令打包一個jar套件:
$ mvn package
這將打包你的代碼和依賴到一個"uberjar" (or "fat jar")，文件路徑在target/storm-starter-{version}.jar。
uberjar的文件名例子：target/storm-starter-0.9.3-incubating-SNAPSHOT.jar

你可以通過storm CLI工具提交（運(yùn)行）uberjar中的topology：

• 例子1：
  本地模式下運(yùn)行ExclamationTopology
  storm jar target/storm-starter-*.jar org.apache.storm.starter.ExclamationTopology
• 例子2：
  遠(yuǎn)程/集群模式下運(yùn)行RollingTopWords，使用名稱"production-topology"
  storm jar storm-starter-*.jar org.apache.storm.starter.RollingTopWords production-topology remote

多語言編寫的topologies也可以提交并運(yùn)行，比如WordCountTopology。

以本地或遠(yuǎn)程模式提交拓?fù)涞膶Ρ龋?/em>取決于拓?fù)渲械膶?shí)際代碼，對RollingTopWords來說，可以通過命令行參數(shù)來設(shè)置。不同于RollingTopWords，ExclamationTopology總是提交到遠(yuǎn)程集群(硬編碼在程序中)或者通過自定義配置文件來設(shè)置。 類似的，諸如拓?fù)涿Q等選項(xiàng) 也可能是用戶可配置或硬編碼的，所以請確認(rèn)你選擇的拓?fù)涫侨绾卧O(shè)置和配置的。