6 releases
0.3.0 | Oct 26, 2021 |
---|---|
0.2.0 | Jan 13, 2020 |
0.1.3 | Nov 18, 2019 |
0.1.2 | Oct 28, 2019 |
#1721 in Development tools
18KB
336 lines
cargo aws-lambda
Node.js and other dependency free cargo subcommand for cross-compiling, packaging and deploying code quickly to AWS Lambda. Uses softprops/lambda-rust:latest
docker image and hence requires docker in PATH
, but that's all you need.
Installation
Run cargo install cargo-aws-lambda
.
Usage
Go to your project directory and run cargo aws-lambda <ARN> <BIN>
to deploy the code to AWS Lambda, where ARN
is the full ARN of the Lambda function (e.g. arn:aws:lambda:eu-north-1:123456789123:function:MyLambdaFuncDev
) and BIN
the name of the binary (e.g. mylambdafunc
, if you have src/bin/mylambdafunc.rs
with a main
function in your project).
cargo aws-lambda arn:aws:lambda:eu-north-1:123456789123:function:MyLambdaFuncDev mylambdafunc
Optional. If you don't want to pass the function ARN on command-line, you can pass in a key to a function defined in a file named Lambda.toml (example) located in your project's root directory like below.
# Lambda.toml
[arns]
dev = "arn:aws:lambda:eu-north-1:1234:function:MyLambdaFuncDev"
prod = "arn:aws:lambda:eu-north-1:1234:function:MyLambdaFuncProd"
Now you can run the following command to deploy to the first ARN defined.
cargo aws-lambda dev mylambdafunc
You can find full project examples in the examples directory.
The credentials are searched by Rusoto as described in here. If you have AWS CLI configured, most likely everything works without additional configuration. If you want to pass AWS access key and secret as parameters, you can do it at your own risk with the --access-key
and --secret-key
parameters. In this case, the other processes running in the system can sniff the credentials easily and they're captured in shell history.
All available configuration options can be listed with the --help
switch.
Problems?
On windows you must enable the shared drives feature for the drive your project is located in.
How it works?
It mounts your project's directory and your ~/.cargo/registry
for the AWS Lambda rust docker image and builds it there for an architecture and system matching the target. After building and stripping symbols out of the executable, everything is packed into a zip file. The zip file is then deployed to the AWS Lambda function ARN given by you. Deploying also instructs AWS to publish the deployed version. Build artifacts generated in docker can be found in your project's target/lambda/release
directory.
Dependencies
~21MB
~348K SLoC