AWS Flow (Ruby) Layer - AWS OpsWorks

AWS Flow (Ruby) Layer


AWS OpsWorks Stacks is no longer accepting new customers. Existing customers will be able to use the OpsWorks console, API, CLI, and CloudFormation resources as normal until May 26, 2024, at which time they will be discontinued. To prepare for this transition, we recommend you transition your stacks to AWS Systems Manager as soon as possible. For more information, see AWS OpsWorks Stacks End of Life FAQs and Migrating your AWS OpsWorks Stacks applications to AWS Systems Manager Application Manager.


This layer is available only for Linux-based stacks.

An AWS Flow (Ruby) layer is an AWS OpsWorks Stacks layer that provides a blueprint for instances that host Amazon SWF activity and workflow workers. The workers are implemented by using the AWS Flow Framework for Ruby, which is a programming framework that simplifies the process of implementing a distributed asynchronous application while providing all the benefits of Amazon SWF. It is ideal for implementing applications to address a broad range of scenarios, including business processes, media encoding, long-running tasks, and background processing.

The AWS Flow (Ruby) layer includes the following configuration settings.

RubyGems version

The framework's Gem version.

Bundler version

The Bundler version.

EC2 Instance profile

A user-defined Amazon EC2 instance profile to be used by the layer's instances. This profile must grant permissions for applications running on the layer's instances to access Amazon SWF.

If your account does not have an appropriate profile, you can select New profile with SWF access to have AWS OpsWorks Stacks update the profile for or you can update it yourself by using the IAM console. You can then use the updated profile for all subsequent AWS Flow layers. The following is a brief description of how to create the profile by using the IAM console. For more information, see Identity and Access Management in Amazon Simple Workflow Service.

Creating a profile for AWS Flow (Ruby) instances
  1. Open the IAM console at

  2. Choose Policies in the navigation pane and choose Create policy to create a new customer-managed policy.

  3. For Service, choose SWF.

  4. For Actions, choose All SWF actions (swf:*).

  5. For Amazon Resource Name (ARN), enter the ARN that specifies which Amazon SWF domains the workers can access. Choose All resources to provide access to all domains.

  6. Choose Next.

  7. Optionally, enter a tag to identify the policy.

  8. Choose Next.

  9. When you are finished, choose Create policy.

  10. Choose Roles in the navigation pane and choose Create role.

  11. Specify the role name and choose Next Step. You cannot change the name after the role has been created.

  12. Choose AWS service and then choose EC2.

  13. Choose Next.

  14. From the Permissions policies list, choose the policy that you created earlier.

  15. Choose Next.

  16. Enter a role name and choose Create role. You cannot change the name after the role has been created.

  17. Specify this profile when you create an AWS Flow (Ruby) layer in AWS OpsWorks Stacks.