0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
tengine_core is a framework/engine to support distributed processing
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 3.3.0
>= 0
>= 0
~> 2.10.0
>= 0
~> 4.9.0

Runtime

>= 3.1.0
~> 1.1.4
>= 3.0.22
 Project Readme

Welcome to Tengine Build Status

概要

Tengineは単一障害点のないジョブを実現するための実行エンジンと、ジョブの実行のためのDSLを提供します。

実行エンジンは、AMQPとMongoDBを用いたメッセージングの仕組みで、イベントドリブンな制御を行うことができます。この制御のためにジョブ用のDSLとは別の基盤となるDSLも提供します。

使用方法

Tengine framework Guide をご覧ください。

gemの構成

  • tengine_ui
    • ジョブの実行やリソースの管理を行うためのUIを提供します。
  • tengine_job
    • ジョブの実行の制御とそのためのDSLを提供します。
  • tengine_job_agent
    • ジョブを実行する際に実行環境を制御するためのエージェントです。
  • tengine_resource
    • ジョブの実行などで使用されるリソースの制御のためのライブラリです。
  • tengine_resource_ec2
    • AWS EC2を用いたリソースの制御のためのライブラリです。
  • tengine_resource_wakame
    • Wakameを用いたリソースの制御のためのライブラリです。
  • tengine_core
    • tengineの中心機能であるイベントハンドリングの機能とDSLを提供します。
  • tengine_event
    • tengineで制御するイベントを発火するためのライブラリです。
  • tengine_rails_plugin
    • Railsアプリからtengineのイベントを簡単に発火するためのライブラリです。
  • tengine_support
    • tengineで使用する汎用的な機能を集めたライブラリです。

インストール

必要条件

  • MongoDB 2.0以降
  • RabbitMQ 2.6.x以降

各gem

各gemはgemコマンドでインストール可能です。

$ gem install tengine_core

bundlerを使用する場合Gemfileに使用するgemを記述してください。

gem "tengine_job"

接続テスト

localhost上でMongoDBとRabbitMQがデフォルトのポートで動作している場合、以下のコマンドでtengine_coreで提供されるtenginedコマンドの動作確認ができます。

$ bundle exec tengined -k test

上記コマンドを実行した結果、以下の出力が得られることを確認します。

STDOUT  Connection test success.

各gemのビルド

How to build Tengine gems をご覧ください。

Contributing

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
  • Fork the project
  • Start a feature/bugfix branch
  • Commit and push until you are happy with your contribution
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

License

Tengine's gems are distributed under the MPL2.0 or LGPLv3 or the dual license of MPL2.0/LGPLv3

Copyright

Copyright (c) 2012 - 2013 Groovenauts, Inc.