Binaris is a fast, low-latency FaaS (Function as a Service) platform. With our performance and scale, you can run real production workloads on Node.js.
- Install using npm
npm install -g binaris-
Setup Binaris credentials
- If you already have an account it's as simple as exporting your existing credentials
- Otherwise head over to Binaris to sign up
-
Generate a Binaris template function
# generates simple NodeJS template function
bn create node12 hellofunc- Deploy a function
# makes the function available via Binaris cloud
bn deploy hellofunc- Invoke a function
# calls the function endpoint via https
bn invoke hellofunc- Make changes to a function
git diff
--- a/function.js
+++ b/function.js
- console.log('Hello World');
+ console.log('Hello Binaris');
# redeploy the function
bn deploy hellofunc- Get logs for a function
bn logs hellofuncIt's as simple as that.
There's a docker version of the Binaris CLI, published on Dockerhub as binaris/bn.
To run in the current directory:
docker run --rm -v $(pwd):/src binaris/bn --help
You'll want to forward your API key. So add -e BINARIS_API_KEY like so:
docker run --rm -e BINARIS_API_KEY -v $(pwd):/src binaris/bn
For convenience, you can create an alias for this in bash:
alias bn='docker run --rm -e BINARIS_API_KEY -v $(pwd):/src binaris/bn'
bn create node12 hello
bn deploy hello
bn invoke hello
You can pass configuration parameters to functions as part of the deploy command. These parameters will be available to the function during runtime as environment variables. All parameters are encrypted at rest and in-transit, which makes them the preferred way to store API keys, passwords, etc.
To pass parameters into a function, add an env: section to binaris.yml, like so:
functions:
hello:
file: function.js
entrypoint: handler
runtime: node12
env:
SOME_API_KEY: XXXXXXXXXXXIf a parameter is sensitive and you don't want to commit it to SCM, you can leave out the value in binaris.yml:
functions:
hello:
file: function.js
entrypoint: handler
runtime: node12
env:
SOME_API_KEY:And pass it as an environment variable to the deploy command:
You can then access these parameters as environment variables:
function.js
exports.handler = () => {
const apiKey = process.env.SOME_API_KEY;
// ...
}Or in Python:
import os
def handler(body, req):
apiKey = os.environ['SOME_API_KEY']
# ...Only string values are supported in the env: section.
SOME_API_KEY=XXXXXXX bn deploy helloLearn more about the Binaris platform at the developer resources page.
This project is licensed under the terms of the MIT license
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent