Testing state machines locally

AWS Step Functions Local is a downloadable version of Step Functions that lets you develop and test applications using a version of Step Functions running in your own development environment. The local version of Step Functions can invoke AWS Lambda functions, both in AWS and while running locally. You can also coordinate other supported AWS services.

Note

Step Functions Local uses dummy accounts to work.

While running Step Functions Local, you can use one of the following ways to invoke service integrations:

• Configuring local endpoints for AWS Lambda and other services. For information about the supported endpoints, see Setting Configuration Options for Step Functions Local.

• Making calls directly to an AWS service from Step Functions Local.

• Mocking the response from service integrations. For information about using mocked service integrations, see Using Mocked Service Integrations.

AWS Step Functions Local is available as a JAR package or a self-contained Docker image that runs on Microsoft Windows, Linux, macOS, and other platforms that support Java or Docker.

Warning

The downloadable version of AWS Step Functions is intended to be used only for testing and should never be used to process sensitive information.

Tip

Make sure you're using Step Functions Local version 1.12.0 or higher to be able to include all the intrinsic functions in your workflows.

The following topics describe how you can set up Step Functions Local using Docker and JAR file, and run Step Functions Local to work with AWS Lambda, AWS Serverless Application Model(AWS SAM) CLI Local, or other supported services.

Topics

• Setting Up Step Functions Local (Downloadable Version) and Docker
• Setting Up Step Functions Local (Downloadable Version) - Java Version
• Setting Configuration Options for Step Functions Local
• Running Step Functions Local on Your Computer
• Testing Step Functions and AWS SAM CLI Local
• Using Mocked Service Integrations