Nimbella Lite
Nimbella Lite
by Nimbella Corp.

VERSION Latest

OS Ubuntu 18.04

Create Nimbella Lite Droplet

Description

Nimbella Lite provides you with a platform for building serverless applications, not just functions. It is Powered by Apache OpenWhisk, an industry-strength platform for serverless computing that can handle enterprise-level scaling. This one-click deployment comes bundled with the Nimbella Serverless Workbench which complements your day-to-day development and provides a uniform experience for building serverless applications, from your desktop to the cloud. Connect with us via support@nimbella.com to get early updates to the Workbench.

Software Included

PackageVersionLicense
Docker CE18.06.1Apache 2
Apache OpenWhisklatestApache 2
CouchDb2.3.0Apache 2
Nginx1.13.0Custom
Ansible2.5.2GPL v3.0
KuilatestApache 2

Getting started after deploying Nimbella Lite

Once your droplet is live, visit https://nimbella-lite.com/Droplet_IP for an introduction to the Nimbella Serverless Workbench, and a brief guide to creating serverless functions with Apache OpenWhisk.

The Playground

The Workbench playground is the easiest way to create and run your first serverless functions. The playground requires no authentication to use and allows you to expose limited functions as API endpoints. Type playground on the Workbench prompt to get started.

You can collapse the playground using your ESC key. This will expose the workbench help menu. Type help at any time to get additional guidance.

Creating and invoking functions

If you're familiar with OpenWhisk, you can proceed to use the OpenWhisk command line tool wsk directly in your browser.

Some commands to try:

# list available utility functions
> wsk action list /whisk.system/utils

# invoke a function
> wsk action invoke /whisk.system/utils/date

# see activations
> wsk activation list

# another way to see activations
> grid

# list other available packages
> wsk package list /whisk.system

Getting an API key

You will need to generate API keys to use wsk from the command line or via the Workbench. The OpenWhisk management tools located in /home/openwhisk/bin make this easy. Here is an example to create a key for a new username:

  su -c '$HOME/openwhisk/bin/wskadmin user create <username>' openwhisk

In the Workbench, you add a new authentication key like this:

  auth add <authentication-key>

Login to your Droplet via SSH for to retrieve a guest key and learn how to configure the wsk CLI.

Automatic hostname with SSL

The OpenWhisk API host in your droplet can be accessed by its Droplet_IP, or as a subdomain 1-2-3-4.nimbella-lite.com, replacing 1-2-3-4 with your droplet's IP address. Notice that - is used instead of . to refer to your droplet when referenced in this way. The message-of-the-day which is printed to the console when you ssh to the droplet will show you the hostname specific to your droplet.

The subdomain is configured with a Let's Encrypt SSL certificate that allows you to conveniently access your droplet with a valid certificate. You should replace the certificate with your own and attach your own domain name before the certificate expires. The bundled certificate will not renew in your droplet.

Additionally, every user of the OpenWhisk deployment in your droplet gets their own hostname, which allows one to properly use cookies and browser local storage with their serverless functions. A username guest can access its own hostname by prefixing the username to the domain, as in guest-1-2-3-4.nimbella-lite.com.

See OpenWhisk's documentation on vanity domains for more information.

Notes about deployment configuration

The droplet is configured in a way that is suitable for small, single-droplet deployments. Functions that you create are stored in CouchDB inside your droplet and will persist across reboots.

The port to access CouchDB from the internet is blocked. If you expose CouchDB to the internet, you must change the admin password and redeploy the system.

More information about Apache OpenWhisk is available on the project website at https://openwhisk.apache.org. Apache OpenWhisk and OpenWhisk, are either registered trademarks or trademarks of The Apache Software Foundation in the United States and other countries. All other marks mentioned may be trademarks or registered trademarks of their respective owners.

To learn more about Nimbella, visit https://nimbella.com or connect with us via support@nimbella.com.

API Creation

In addition to creating a Droplet from the Nimbella Lite 1-Click App via the control panel, you can also use the DigitalOcean API.

As an example, to create a 4GB Nimbella Lite Droplet in the SFO2 region, you can use the following curl command. You’ll need to either save your API access token to an environment variable or substitute it into the command below.


  curl -X POST -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer '$TOKEN'' -d \
      '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"nimbella-18-04"}' \
      "https://api.digitalocean.com/v2/droplets"
      

Support Details

Supported By:Nimbella Corp.
Hours:24/7
Support URL:http://slack.openwhisk.org/
Support Email:support@nimbella.com

Learn More

Product Docs

Technical overviews, how-tos, release notes, and support material

Tutorials

DevOps and development guidelines

API Docs

Run your resources programmatically

Ask a question

Connect, share and learn