CLI tools for manage your project ( s ) in BFast Cloud.

• Download and install NodeJs in your local PC. If you have it your good to go.

Install package from npm by run for linux: sudo npm install -g bfast-tools. For windows run: npm install -g bfast-tools

You use this sub command to manage your remote bfast projects. bfast cloud for more commands.

Run the following command to create a new project

josh@xps:~/Desktop$ bfast cloud create

Run the following command to list all projects exist to your bfast cloud account

josh@xps:~/Desktop$ bfast cloud list

Run the following command to delete exist project to your bfast cloud account

josh@xps:~/Desktop$ bfast cloud delete

Run the following command to add exist user of bfast to your bfast cloud account

josh@xps:~/Desktop$ bfast cloud add-member

You can manage your database instance using this sub command bfast database.

You can switch a dashboard on for data browser.

josh@xps:~/Desktop$ bfast database dashboard-on

You can switch a dashboard off for data browser.

josh@xps:~/Desktop$ bfast database dashboard-off

You must add manually a specif collection/table/domain to a realtime engine to subscribe to its events.

josh@xps:~/Desktop$ bfast database playground

Write your system functions with zero effort. Sub command to manage your functions is bfast functions or bfast fs

run bfast functions create <projectName>. For example.

josh@xps:~/Desktop$ bfast functions create bfastDemoFaas

after that navigate inside your project directory.

josh@xps:~/Desktop$ cd bfastDemoFaas
josh@xps:~/Desktop/bfastDemoFaas$ 

after that install dependencies

josh@xps:~/Desktop/bfastDemoFaas$ npm install

Inside your workspace folder you will find a following folder structure

.
|__ functions
|   |__ .ignore
|   |__ index.mjs
|   |__ package.json
|__ bfast.json

Open index.mjs in your favorite text editor. You will see a commented example.

File bfast.json contain information of your BFast::Cloud project.

You use bfastnode package from npm to write your functions

Choose text editor of your choice like VSCode or WebStorm. You can write your function is different ways.

Single callback function

const {BFast} = require('bfastnode');

exports.mySingleFunctionName = BFast.functions().onHttpRequest('/mySingleFunctionName',(request, response)=>{
        // your business logic
        response.send('your response');
    }
);

Many callback in array. Good if your apply a middleware before execute finally logic. Refer to ExpressJS Middlware

const {BFast} = require('bfastnode');

exports.myArrayFunctionName = BFast.funtion().onHttpRequest('/myArrayFunctionName', [
        (request, response, next)=>{
            // middleware logic
            request.query.from1 =  'query added in first callback';
            next();
        },
        (request, response)=>{
            // your business logic
            response.send(request.query.from1);
        }
    ]
);

Mount express router. Your can use Express Router to manage complex routing. First run npm install express inside functions folder to add express module

const express = require('express');
const router = express.Router();
const {BFast} = require('bfastnode');

router.get('/', function (request, response) {
    // your logic
    response.send('get users');
});

router.post('/user', function (request, response) {
    // your logic
    response.send('User saved');
})

exports.functionNameUsingRouter = BFast.function().onHttpRequest('/functionNameUsingRouter',router);

You can mount an express app too!. First run npm install express inside functions folder to add express module

const express = require('express');
const app = new express();
const {BFast} = require('bfastnode');

app.get('/', function (request, response) {
    // your logic
    response.send('get users');
});

app.post('/user', function (request, response) {
    // your logic
    response.send('User saved');
})

exports.functionNameUsingExpressApp = BFast.function().onHttpRequest('/functionNameUsingExpressApp', app);

In your current project folder, run following script

• Start a dev server ( auto restart when you change or edit a function )

josh@xps:~/Desktop/bfastDemoFaas$ bfast functions serve --port 3000

Or

josh@xps:~/Desktop/bfastDemoFaas$ npm start

• Start a static server which do not auto restart when you change or edit files in working directory

josh@xps:~/Desktop/bfastDemoFaas$ bfast functions serve --port 3000 --static

Default port is 3000, but you can change it by change a value of port option.

When everything is ok, you will see BfastFunctions Engine Listening on 3000 or any port number you specify.

• If you use path field to specify address of your function you will use that path
• If your do not use path field the your function will be available in this format <hostname>/function/<functionName>. For example by using curl

josh@xps:~$ curl http://localhost:3000/functions/functionName

Or

josh@xps:~$ curl http://localhost:3000/<path>

Or open your browser and enter http://localhost:3000/functions/mySingleFunctionName if you use path field in your browser put this address http://localhost:3000/pathYouUse

Replace mySingleFunctionName with a function name you want to call.

You can deploy your functions to bfast cloud and host your server-less functions across our network.

To publish your functions you must have a bfast cloud functions open one here BFAST::CLOUD. After open account now you create your new project and you go to next step

Login from your computer by run.

josh@xps:~/Desktop/bfastDemoFaas$ bfast user login

Run their following in your bfast local project folder

josh@xps:~/Desktop/bfastDemoFaas$ bfast cloud link

We use git to deploy your functions to bfast cloud function instance(s). Run thr following to set up git environments.

josh@xps:~/Desktop/bfastDemoFaas$ bfast functions config

• Make sure you push all your production functions to master branch
• Then run

josh@xps:~/Desktop/bfastDemoFaas$ bfast functions deploy

NOTE You must push your project to a git repository you specify. BFast will look from master branch for functions.

• Generate token to use it for your favorite CI tool

josh@xps:~/Desktop/bfastDemoFaas$ bfast user login:ci --username <PUT_EMAIL_YOU_USE_TO_OPEN_BFAST_ACCOUNT>

You can use token generated and example given to set your continuous integration environment.

NOTE

In CI mode you must set projectId manually to deploy your functions your can find projectId from your project console in bfast cloud account

• In this documentation we use port 3000, if you use a different port to run your functions replace 3000 with a port number you use in all examples found in this document to be relevant.

• You can create a javascript file anywhere inside functions folder or even create a sub folder and put your functions as illustrated above and bfast-tools package will discover your functions

Contact FahamuTech Team @Joshua Mshana ( [email protected] ) or leave an issue here at github