Scaffoldly
Search…
Running Locally
This page explains how to run a Microservice locally
After building, Scaffoldly created new repositories in your GitHub Organization. It's easy to run and debug them locally.
Clone the Repository
1
➜ ~ git clone [email protected]:scaffoldly-demo/auth-sls-rest-api.git
2
Cloning into 'auth-sls-rest-api'...
3
remote: Enumerating objects: 98, done.
4
remote: Counting objects: 100% (98/98), done.
5
remote: Compressing objects: 100% (80/80), done.
6
remote: Total 98 (delta 20), reused 79 (delta 11), pack-reused 0
7
Receiving objects: 100% (98/98), 252.23 KiB | 1.24 MiB/s, done.
8
Resolving deltas: 100% (20/20), done.
Copied!
Download Dependencies
Run the
yarn command1
➜ ~ cd auth-sls-rest-api
2
➜ auth-sls-rest-api git:(main) yarn
3
yarn install v1.22.11
4
[1/4] 🔍 Resolving packages...
5
[2/4] 🚚 Fetching packages...
6
[3/4] 🔗 Linking dependencies...
7
...
8
yarn run v1.22.11
9
$ tsc
10
✨ Done in 16.64s.
11
✨ Done in 135.47s.
Copied!
This will take a minute or so...
Starting the Application
Command Line
Run
yarn start to launch the Application1
➜ auth-sls-rest-api git:(main) ✗ yarn start
2
yarn run v1.22.11
3
$ SLS_DEBUG=* serverless offline start
4
Serverless: Load command interactiveCli
5
Serverless: Load command config
6
...
7
┌─────────────────────────────────────────────────────────────────────────────────────┐
8
│ │
9
│ ANY | http://localhost:3000/auth │
10
│ POST | http://localhost:3000/2015-03-31/functions/lambda-handler/invocations │
11
│ OPTIONS | http://localhost:3000/auth │
12
│ POST | http://localhost:3000/2015-03-31/functions/lambda-handler/invocations │
13
│ ANY | http://localhost:3000/auth/{proxy*} │
14
│ POST | http://localhost:3000/2015-03-31/functions/lambda-handler/invocations │
15
│ OPTIONS | http://localhost:3000/auth/{proxy*} │
16
│ POST | http://localhost:3000/2015-03-31/functions/lambda-handler/invocations │
17
│ │
18
└─────────────────────────────────────────────────────────────────────────────────────┘
19
20
offline: [HTTP] server ready: http://localhost:3000 🚀
21
offline:
22
offline: Enter "rp" to replay the last request
Copied!
This should take 20-30 seconds to start...
Within VSCode
Open the Repository in VSCode, and in the Debug menu, click the Play icon next to Local Debug
You'll see the output in the VSCode Terminal and Debug Console.
Use the Application
Here's a couple examples:
1
➜ ~ curl http://localhost:3000/auth/version
2
{"version":"1.0.0-2"}%
Copied!
1
➜ auth-sls-rest-api git:(main) ✗ curl http://localhost:3000/auth/api/health
2
{"name":"auth-sls-rest-api","healty":true,"now":"2021-10-21T00:59:48.627Z","version":"1.0.0-2"}%
Copied!
Swagger UI
https://localhost:3000/auth/swagger.html
Debug The Application
If you ran the project with VSCode, you can set breakpoints.
Last modified 7mo ago