Asakusa Vanilla ユーザーガイド

この文書では Asakusa Vanilla の利用方法について説明します。

アプリケーションのテスト

Asakusa Framework バージョン 0.10 以降では、標準の設定でAsakusa Vanillaによるテストが有効になっています。

./gradlew check などによってテストドライバを利用したテストを実行すると、Asakusa Vanillaを利用してバッチアプリケーションを実行します。

Attention

Asakusa Framework バージョン 0.9系ではAsakusa Vanillaを有効にするためにビルドスクリプトに対して以下の設定を行う必要がありましたが、 バージョン 0.10 以降ではこの定義は不要です。

build.gradle
asakusafw {
    sdk.testkit 'vanilla'
}

なお、バージョン 0.9系、およびそれ以前に標準のテストドライバとして採用していたスモールジョブ実行エンジンを利用するには、 ビルドスクリプトに対して以下の設定を行います。 ただし、バージョン 0.10 以降ではこの設定によるテスト実行は非推奨です。

build.gradle
asakusafw {
    sdk.testkit 'mapreduce-emulation'
}

Note

Vanillaを利用したDSLのテストでは、 $ASAKUSA_HOME/vanilla/conf/vanilla.properties に記載された設定を利用して Asakusa Vanilla を実行します。 このファイルが存在しない場合、すべて既定の設定を利用します。

何らかの設定が必要な場合、該当箇所に設定ファイルを配置してください。 設定方法については Asakusa Vanilla リファレンス - 設定項目 を参照してください。

アプリケーションのビルド

Asakusa Vanillaは主にテストドライバ上で利用することを想定していますが、DSLコンパイルによってバッチアプリケーションを生成し、これを実行することも可能です。

Asakusa Vanillaを実行エンジンに利用するバッチアプリケーションを生成するには、ディストリビューションプラグイン [1] を利用したビルドスクリプト ( build.gradle ) に対して以下の設定を追加します。

build.gradle
apply plugin: 'asakusafw-vanilla'

この状態で、Gradleタスク vanillaCompileBatchapps を実行すると、Asakusa Vanilla 向けのバッチアプリケーションのビルドを実行します。

./gradlew vanillaCompileBatchapps

vanillaCompileBatchapps タスクを実行すると、アプリケーションプロジェクトの build/vanilla-batchapps 配下にビルド済みのバッチアプリケーションが生成されます。

標準の設定では、Asakusa Vanillaのバッチアプリケーションは接頭辞に vanilla. が付与されます。 例えば、サンプルアプリケーションのバッチID example.summarizeSales の場合、Asakusa VanillaのバッチアプリケーションのバッチIDは vanilla.example.summarizeSales となります。

[1]ディストリビューションプラグインについては、 Asakusa Gradle Plugin リファレンス を参照してください。

デプロイメントアーカイブの生成

アプリケーションのビルド の設定を行った状態で、Asakusa Frameworkのデプロイメントアーカイブを作成すると、 Asakusa Vanillaのバッチアプリケーションアーカイブを含むデプロイメントアーカイブを生成します。

デプロイメントアーカイブを生成するには Gradleの assemble タスクを実行します。

./gradlew assemble

Note

その他、アプリケーションのデプロイや実行などの方法は他の実行エンジンと同様です。