Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/helloakn/develop-aws-lambda-functions-locally
In this example. I use express node package as the api gateway. separated functions and layers.
https://github.com/helloakn/develop-aws-lambda-functions-locally
aws-lambda faas-platform lambda-functions lambda-layers lambda-local microservices nodejs rest-api
Last synced: 7 days ago
JSON representation
In this example. I use express node package as the api gateway. separated functions and layers.
- Host: GitHub
- URL: https://github.com/helloakn/develop-aws-lambda-functions-locally
- Owner: helloakn
- Created: 2022-05-05T01:58:04.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-05-08T03:46:14.000Z (over 2 years ago)
- Last Synced: 2024-11-24T01:23:25.180Z (2 months ago)
- Topics: aws-lambda, faas-platform, lambda-functions, lambda-layers, lambda-local, microservices, nodejs, rest-api
- Language: JavaScript
- Homepage:
- Size: 51.8 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Develop AWS LAMBDA Functions/Layers as Locally
[](https://github.com/helloakn/develop-aws-lambda-functions-locally)
[](https://github.com/helloakn/develop-aws-lambda-functions-locally)
[](https://github.com/helloakn/develop-aws-lambda-functions-locally)
[](https://github.com/helloakn/develop-aws-lambda-functions-locally)
[](https://github.com/feross/standard)
[](https://github.com/helloakn/develop-aws-lambda-functions-locally)
This is just for simple project.
However, you can learn the file structure and strategies for aws lambda to develop in local.
benefit of these file structure is to deploy easily as functions or the whole project.
can be used for :
 
 
 
## Table of Contents
- File Structure
- Before installation the npm dependences
- After installation the npm dependences
- npm Dependences
- How to Setup
- How to Run
- How to Test
- Swagger
- Acknowledgement
### File Structure
Structure is base on lambda functions.
So we can easily deploy to lambda or ECS or EC2 as the monolith or microservice.
We can separate authorizer and functions too.
All the services on our code would be functions in Lambda and middleware will be lambda Authorizer as well as all the others are the layers.
#### Before installation the npm dependences
```nth
.
├── http # dir for sqlite3 database
| ├── routes # sqlite3 db file
│ │ ├── routegenerator.js
│ │ └── routelist.js
| ├── package.json # sqlite3 db file
| └── server.js # sqlite3 db file
├── lambda # nodejs source code
│ ├── functions # administrator and customer middlewares
│ │ └── ...
│ └── layers # Controllers , we can deploy them to AWS Lambda functions
│ ├── v1 # For all admin functions
│ │ ├── package.json
│ │ └── ...
│ └── v2 # For all user functions
│ ├── package.json
│ └── ...
├── resources # for documentations
│ └── ...
├── .eslintrc.cjs # for standar code check
├── package.json
├── README.md
└── ...
```
#### After installation the npm dependences
```nth
.
├── http # dir for sqlite3 database
| ├── routes # sqlite3 db file
│ │ ├── routegenerator.js
│ │ └── routelist.js
| ├── package.json # sqlite3 db file
│ ├── node_modules
│ │ └── ...
| └── server.js # sqlite3 db file
├── lambda # nodejs source code
│ ├── functions # administrator and customer middlewares
│ │ └── ...
│ └── layers # Controllers , we can deploy them to AWS Lambda functions
│ ├── v1 # For all admin functions
│ │ ├── package.json
│ │ ├── node_modules
│ │ │ └── ...
│ │ └── ...
│ └── v2 # For all user functions
│ ├── package.json
│ ├── node_modules
│ │ └── ...
│ └── ...
├── resources # for documentations
│ └── ...
├── .eslintrc.cjs # for standar code check
├── package.json
├── node_modules
│ └── ...
├── README.md
└── ...
```
### npm Dependences
- Root
* [supervisor](https://www.npmjs.com/package/supertest) ^0.12.0 - to restart app on source code changes or crash app
* [jest](https://www.npmjs.com/package/jest) ^28.0.3 - for unit testing
* [supertest](https://www.npmjs.com/package/supertest) ^6.2.3 - for api testing
- http
* [express](https://www.npmjs.com/package/express) ^4.18.1 - to handle rest api
* [cors](https://www.npmjs.com/package/cors) ^2.8.5 - for api cors allown and deny
* [swagger-jsdoc](https://www.npmjs.com/package/swagger-jsdoc) ^6.2.1 - for api doc
* [swagger-ui-express](https://www.npmjs.com/package/swagger-ui-express) ^4.3.0 - express api doc
- lambda
- functions
* nothing to install
- layers
- layerauthorizer
* [jsonwebtoken](https://www.npmjs.com/package/jsonwebtoken) ^8.5.1 - JWT
- v1
* [dotenv](https://www.npmjs.com/package/dotenv) ^16.0.0 - to load environment variable from .env file or sys environment variable
* [md5](https://www.npmjs.com/package/md5) ^2.3.0 - for one way password hex
* [jsonwebtoken](https://www.npmjs.com/package/jsonwebtoken) ^8.5.1 - JWT
* [mysql](https://www.npmjs.com/package/mysql) ^2.18.1 - for db crud
### How to Setup
We have to install npm dependence to run our program smoothly.
pls follow as the singlie line of the following command.
```shell
npm run setup
```
## How to Run
Configuration is just for dev(local) only. we can easily execute our program in local as the following command.
```shell
npm run dev
```
## How to Test
I use jest and supertest npm package for testing. main program is base on commajs and jest is base on model type. however we can run and test our program because i have configured in package.json. You can check the testing source code in [./test](https://github.com/helloakn/node-multi-authorizer-jwt/tree/main/tests) directory too.
Here is the command to run the testing.
```shell
npm test
```
## Swagger
we can reach to our swagger from this link...
[Link](http://localhost:9999/swagger/) API Doc swagger -> http://localhost:9999/swagger/
We can test the api ourselves.
## Acknowledgement
Thank you all for visiting to my repo. please feel free to contact me.