aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 5912e4fec60aaf6913859863db45253b33b01f97 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
# faaslift

[![Build Status](https://travis-ci.org/jantuomi/faaslift.svg?branch=master)](https://travis-ci.org/jantuomi/faaslift)

Small Function as a Service (FaaS) server built with Node.js and MongoDB. Useful for deploying quick endpoint prototypes to your own server.

# Setup

## Server

Clone the repository to your server.
Create a file called `.env` in the project directory and add the following fields:

```
MONGODB_URL=<YOUR MONGO URL WITH AUTH>
PORT=<YOUR FAVOURITE HTTP PORT>
```

A great place to host the Mongo instance is https://mlab.com/.

Start the server with your favourite production grade Node.js runner, e.g. `pm2`.

```
pm2 start index.js --name faaslift
```

## Client

Install the package globally with npm.

```
npm i -g faaslift
```

Run faaslift with `faaslift`. Authorize the CLI with the `authorize <MONGO URL>` command (same URL as on the server).

Create a new endpoint with `create <name>`. Your endpoint is now live at http://your-server/name.

Use `upload <file> <endpoint>` to upload a file from your current working directory to an endpoint. Below is an example of such a file.

```
module.exports = function (req, res) {
  res.type('text/html');
  res.send(<h1>Hello world!</h1>');
};
```

`req` and `res` are Express objects.

# Security

The functions are *NOT* containerized in any way! This means that code running at an endpoint is e.g. able to crash the server or manipulate other endpoints, among other evil deeds, with a little bit of tinkering. That's why this project is solely meant for prototyping purposes.

# Author

Jan Tuomi <jans.tuomi@gmail.com>, 2018