This application deploys step functions into your account that you can use to interact with Stax to CUD (create-update-delete) workloads in your AWS Account(s).
Stax provides an open source python SDK for use within projects to interact with Stax. We leverage the SDK to create and monitor workload operations within the serverless application.
This project contains source code and supporting files for Stax Orchestrator Serverless Application that you can deploy with the SAM CLI. It includes the following files and folders:
- functions - Python code for the application's lambda functions to deploy workload and monitor the status of the workload task.
- statemachines - Definition for the state machine that orchestrates the stock trading workflow.
- cloudformation - Sample workload templates.
- template.yaml - A template that defines the application's AWS resources.
- Makefile - Run shell commands using make targets for a smooth developer experience.
- events - Json files containing test data to run against your application code locally.
- assets - Diagrams and other assets.
This serverless application deploys the following resources in your AWS Account,
- Workload Step Function - Creates a Stax workload and triggers Task Watcher Step Function to monitor the workload deployment status.
- Validate Input Lambda - Validates user provided input.
- Create Workload Lambda - Invokes Stax Api to create a workload.
- Update Workload Lambda - Invokes Stax Api to create a workload.
- Delete Workload Lambda - Invokes Stax Api to delete a workload.
- Task Watcher Step Function - Monitors the lifecycle of a workload task in progress and reports with a success/failure to Create Workload Steop Function.
- Get Task Status Lambda - Invokes Stax Api to get the status of a workload task.
The orchestrator requires API keys to be in the AWS account, follow pre-deployment steps to complete this.
This is an optional deployment approach to allow the flexibility to use a forked version of the repository and/or complete feature development and testing.
We encourage contributions via pull requests, so if there is a feature you have developed and are using, we want to hear about it.
Follow this guide here to deploy directly.
- Add a policy to allow AWS's Serverless Service access the bucket to get artifacts.
Deployment of the stax-orchestrator can be completed by the AWS Console, AWS CLI or AWS Cloudformation. Please following Deploying Applications to use th AWS Console or AWS CLI.
To deploy using AWS Cloudformation, find the serverless application (name: stax-orchestrator) in the AWS Serverless Repository in your AWS account and click "copy Cloudformation template".
Example:
Resources:
staxorchestrator:
Type: AWS::Serverless::Application
Properties:
Location:
ApplicationId: arn:aws:serverlessrepo:ap-southeast-2:754868638956:applications/stax-orchestrator
SemanticVersion: 0.1.7 # any specific version required
Parameters:
# Deploy workload cloudwatch dashboard to view stax orchestrator step function metrics and logs.
# DeployTaskWatcherCloudwatchDashboard: 'false' # Uncomment to override default value
# Deploy workload cloudwatch dashboard to view stax orchestrator step function metrics and logs.
# DeployWorkloadCloudwatchDashboard: 'false' # Uncomment to override default value
# Deploy workload state machine to CUD (create-update-delete) workloads.
# DeployWorkloadStateMachine: 'false' # Uncomment to override default value
# Enable X-Ray tracing for lambda functions
# EnableLambdaTracing: 'false' # Uncomment to override default value
# Enable X-Ray tracing for state machines
# EnableStateMachineTracing: 'false' # Uncomment to override default value
# Number of days to retain lambda function logs; applies to all lambda functions in this template
# LambdaLogGroupRetentionInDays: '60' # Uncomment to override default value
# Python logging level for Lambda functions
# PythonLoggingLevel: 'INFO' # Uncomment to override default value
Please follow Use of Stax Orchestrator for instruction on how to deploy/delete and update Stax Workloads.