ptx
v1.1.1
Published
PowerTune execution script
Downloads
19
Readme
PowerTune Node Execution script
src/ptx.js is a script which calls the PowerTune stack inside your current AWS account to allow tuning of the AWS Lambdas in that AWS account. It is designed to replace the execute.sh script that is provided by PowerTune.
Note: PTX will run using the AWS profile that is available in your shell/terminal. Set the AWS_PROFILE
environment variable to point to the AWS profile that
you wish to use this tool in.
Prerequisite Software
- Node.js version 14+ (to use the
npx
tool to run this tool)
Installation
You may install this tool globally, or run it via npx
.
# Global installation
$ npm i -g ptx
# Run via npx
$ npx ptx
Usage
# Set your AWS Profile
export AWS_PROFILE=my-profile
# This might be required too
export AWS_SDK_LOAD_CONFIG=true
# Set an env-var that points to the name of the Power Tune Stack in your AWS Account
export PTX_STACK_NAME=serverlessrepo-aws-lambda-power-tuning
# The config-file argument is relative to the current directory
npx ptx path/to/powertuneConfig.json
See configuration information for the basics, but note that this Node script adds the following capabilities:
- Reference one external JSON or JS files when defining the payload (see examples/configs/basic.json)
- Reference multiple external JSON or JS files when defining the payload (see examples/configs/multiInclude.json)
- Pass arguments to included JS files (see examples/configs/includeFunctionWithArgs.json)
AWS Permissions Required
This tool uses the aws-sdk
library to call the following APIs:
- CloudFormation.describeStacks()
- StepFunctions.startExecution()
- StepFunctions.describeExecution()
If you see an AWS permissions error when running ptx
, check if your AWS account has permission to use these APIs.
License
This software is licensed under the APACHE 2.0 License. See the LICENSE file for more info.