AWS Flow Framework for Ruby: Periodic Sample Application ======================================================== The *Periodic* sample periodically executes an activity in a long-running workflow. The ability to continue executions as new executions so that an execution can run for very extended periods of time is demonstrated. Prerequisites ------------- The *AWS Flow Framework for Ruby* is required, which can be obtained and installed using the information here: - [https://aws.amazon.com/swf/flow/](https://aws.amazon.com/swf/flow/) If you already have [Ruby](https://www.ruby-lang.org/) and [RubyGems](http://rubygems.org/) installed, you can install the framework by opening a terminal window and typing: ~~~~ gem install aws-flow ~~~~ For more information about setting up the AWS Flow Framework for Ruby, see [Installing the AWS Flow Framework for Ruby](http://docs.aws.amazon.com/amazonswf/latest/awsrbflowguide/installing.html) in the *AWS Flow Framework for Ruby Developer Guide*. Downloading the Sample Code --------------------------- To view or download the code for all of the AWS Flow Framework for Ruby recipes and samples, go to: - [https://github.com/awslabs/aws-flow-ruby-samples](https://github.com/awslabs/aws-flow-ruby-samples) Run the Sample -------------- **To run the Periodic sample:** 1. Open *four* separate terminal windows and, in each one, change to the `lib` directory in the location where you cloned or unarchived the sample code. For example: ~~~~ cd ~/Downloads/aws-flow-ruby-samples/samples/periodic/lib ~~~~ 2. In each command-line (terminal) window, execute the following commands, substituting your AWS Access keys for the example values. On Linux, OS X or Unix: ~~~~ export AWS_ACCESS_KEY_ID='your-access-key' export AWS_SECRET_ACCESS_KEY='your-secret-key' export AWS_REGION='your-aws-region' ~~~~ On Windows: ~~~~ set AWS_ACCESS_KEY_ID=your-access-key set AWS_SECRET_ACCESS_KEY=your-secret-key set AWS_REGION=your-aws-region ~~~~ 3. Execute the following commands, one in each of the terminal windows: ~~~~ ruby error_reporting_activity.rb ruby periodic_activity.rb ruby periodic_workflow.rb ruby periodic_workflow_starter.rb ~~~~ For More Information -------------------- For more information about the Amazon Simple Workflow service and the Amazon Flow Framework for Ruby, consult the following resources: - [AWS Flow Framework for Ruby Developer Guide](http://docs.aws.amazon.com/amazonswf/latest/awsrbflowguide/) - [AWS Flow Framework for Ruby API Reference](https://docs.aws.amazon.com/amazonswf/latest/awsrbflowapi/) - [AWS Flow Framework](http://aws.amazon.com/swf/flow/) - [Amazon Simple Workflow Service](http://aws.amazon.com/swf/)