A sample template for bootstraping a multi function Rustlang AWS Lambda applications with ⚡ serverless framework ⚡ using Cargo workspaces
- 🦀 Build Rustlang applications with ease
- 🛵 Continuous integration testing with travis CI
- 🚀 Continuous deployment with travis CI
- 🧪 Getting started unit tests
Install the serverless framework cli.
Then then run the following in your terminal
$ npx serverless install \
--url https://github.com/softprops/serverless-aws-rust-multi \
--name my-new-multi-func-app
This will download the source of a sample Rustlang application and unpack it as a new service named "my-new-multi-func-app" in a directory called "my-new-multi-func-app"
Assumming you have aws credentials with appropriate deployment permissions configured (if you already use any existing AWS tooling installed you likely already have this configured), you could impress your friends by creating a project that is born in production.
$ npx serverless install \
--url https://github.com/softprops/serverless-aws-rust-multi \
--name my-new-multi-func-app \
&& cd my-new-multi-func-app \
&& npm ci \
&& npx serverless deploy
npm ci
will make sure npm dependencies are installed based directly on your package-lock.json file. This only needs run once.
The first time you run npx serverless deploy
it will pull down and compile the base set
of dependencies and your application. Unless the dependencies change afterwards,
this should only happen once, resulting in an out of the box rapid deployment
cycle.
This template includes an example travis configuration file which can unlock a virtuous cycle of continuous integration and deployment ( i.e all tests are run on prs and every push to master results in a deployment ).
To set up travis you will need to do a view things.
Firstly, version control your source. Github is free for opensource.
$ git init
$ git remote add origin git@github.com:{username}/{my-new-service}.git
Using the travis cli, bootstrap your git repos' travis integration.
$ travis enable
# set up AWS credentials for serverless deployment
# https://serverless.com/framework/docs/providers/aws/guide/credentials/
$ travis env set AWS_ACCESS_KEY_ID 'xxx'
$ travis env set AWS_SECRET_ACCESS_KEY 'xxx'
⭐ You can optionally generate code coverage reports with coveralls by enabling your repo here. You may need to sync repos first. You can then view your coverage reports at https://coveralls.io/github/{username}/{my-new-service}
Add your changes to git and push them to github.
Finally, https://travis-ci.org/{username}/{my-new-service} in your browser and grab a bucket of popcorn 🍿
With your function deployed you can now start triggering it using serverless
framework directly or
the AWS integration you've configured to trigger it on your behalf
$ npx serverless invoke -f hello -d '{"foo":"bar"}'
With your function deployed you can now tail it's logs right from your project
$ npx serverless logs -f hello
$ npx serverless logs -f world
Good code should be easily replaceable. Good code is should also be easily disposable. Retiring applications should be as easy as creating and deploying them them. The dual of serverless deploy
is serverless remove
. Use this for retiring services and cleaning up resources.
$ npx serverless remove
-
See the serverless-rust plugin's documentation for more information on plugin usage.
-
See the aws rust runtime's documentation for more information on writing Rustlang lambda functions
This template's intent is to set a minimal baseline for getting engineers up an running with a set of repeatable best practices. See something you'd like in this template that would help others? Feel free to open a new github issue. Pull requests are also welcome.
aws dynamodb create-table
--table-name rsvp_table
--attribute-definitions AttributeName=householdId,AttributeType=S
--key-schema AttributeName=householdId,KeyType=HASH
--billing-mode PAY_PER_REQUEST
--endpoint-url http://localhost:8000