https://github.com/softprops/serverless-multi-lando
⚡🏗️ template for new multi-function serverless lando apps
https://github.com/softprops/serverless-multi-lando
aws aws-lambda rust rustlang serverless serverless-frame
Last synced: 12 months ago
JSON representation
⚡🏗️ template for new multi-function serverless lando apps
- Host: GitHub
- URL: https://github.com/softprops/serverless-multi-lando
- Owner: softprops
- Created: 2018-07-30T05:10:43.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-10-03T18:28:24.000Z (over 7 years ago)
- Last Synced: 2025-03-17T12:00:02.345Z (about 1 year ago)
- Topics: aws, aws-lambda, rust, rustlang, serverless, serverless-frame
- Language: Makefile
- Homepage:
- Size: 33.2 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# serverless lando template
A sample template for bootstraping multi-function rustlang [lando](https://github.com/softprops/lando) applications with ⚡ serverless framework ⚡
## 📦 install
Install the [serverless framework](https://serverless.com/framework/) cli.
Then then run the following in your terminal
```bash
$ serverless install \
--url https://github.com/softprops/serverless-multi-lando \
--name my-new-service
```
This will download the source of a sample lando application and unpack it as a new service named
"my-new-service" in a directory called "my-new-service"
## 🧙 how to be a wizard
Assumming you have aws credentials with appropriate deployment permissions configured
in a profile named "prod", you could impress your friends by creating a project
that is _born_ in production.
```bash
$ serverless install \
--url https://github.com/softprops/serverless-multi-lando \
--name my-new-service \
&& cd my-new-service \
&& AWS_PROFILE=prod make dependencies deploy
```
`make dependencies` will make sure npm dependencies are installed locally, this only needs run once.
The first time you run `make deploy` it will pull down and compile the base set
of rustlang dependencies and your application. Unless the dependencies change afterwards,
this should only happen once, resulting in an out of the box rapid deployment
cycle.
## 🛵 continuous integration and deployment
This template includes an example [travis](https://travis-ci.org/) [configuration file](.travis.yml) 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](https://github.com/) is free for opensource.
```bash
$ git init
$ git remote add origin git@github.com:{username}/{my-new-service}.git
```
Using the [travis cli](https://github.com/travis-ci/travis.rb#installation),
bootstrap your git repos' travis integration.
```bash
$ 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](http://coveralls.io/) by enabling your repo [here](https://coveralls.io/repos/new). 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 🍿
## 👴 retiring
Experimentation will likely facilitate retiring ideas. Retiring applications should be as easy as creating and deploying them them. This project provides
a dual to `make deploy` for doing so: `make destroy`
```bash
$ AWS_PROFILE=prod make destroy
```