IBM/ibm-cloud-functions-refarch-template

Name: ibm-cloud-functions-refarch-template

Owner: International Business Machines

Description: ***WORK IN PROGRESS*** Create a serverless, event-driven application with Apache OpenWhisk on IBM Cloud Functions that executes code in response to ...

Created: 2018-02-27 01:38:10.0

Updated: 2018-03-04 17:28:55.0

Pushed: 2018-03-05 19:16:45.0

Homepage:

Size: 80

Language: Shell

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Serverless reference architecture with IBM Cloud Functions (powered by Apache OpenWhisk)

Build Status

This reference architecture shows how serverless, event-driven architectures can execute code that scales automatically in response to demand from […]. No code runs until […] When that happens, application instances are started to match the load needed by each […] exactly.

In addition to using cloud resources efficiently, this means that developers can build and deploy applications more quickly. You can learn more about the benefits of building a serverless architecture for this use case in the accompanying IBM Code Pattern.

This repository provides a template skeleton for IBM Cloud Functions reference architectures. You can deploy it right away using the IBM Cloud Functions user interface, or setup and deploy using command line tools on your own system.

If you haven't already, sign up for an IBM Cloud account and go to the Cloud Functions dashboard to explore other reference architecture templates and download command line tools, if needed.

Included components

The application demonstrates two IBM Cloud Functions (based on Apache OpenWhisk) that […]. The use case demonstrates how actions work with data services and execute logic in response to […] events.

One function, or action, is triggered by […]. These […] are piped to another action in a sequence (a way to link actions declaratively in a chain). The second action aggregates the […] and […].

Sample Architecture

Deploy through the IBM Cloud Functions console user interface

Choose “Start Creating” and select “Deploy template” then [This template] from the list. A wizard will then take you through configuration and connection to event sources step-by-step.

Behind the scenes, the UI uses wskdeploy, which you can also use directly from the CLI by following the steps in the next section.

Deploy using the wskdeploy command line tool

This approach deploy the Cloud Functions with one command driven by the runtime-specific manifest file available in this repository.

Deployment
t a local copy of this repository
clone https://github.com/IBM/ibm-cloud-functions-refarch-template.git
bm-cloud-functions-refarch-template

ke service credentials available to your environment
ce local.env
package refresh

ploy the packages, actions, triggers, and rules using your preferred language
untimes/nodejs # Or runtimes/[php|python|swift]
eploy
Undeploy
ploy the packages, actions, triggers, and rules
eploy undeploy
Alternative deployment methods
Deploy manually with the bx wsk command line tool

This approach shows you how to deploy individual the packages, actions, triggers, and rules with CLI commands. It helps you understand and control the underlying deployment artifacts.

Deploy with IBM Continuous Delivery

This approach sets up a continuous delivery pipeline that redeploys on changes to a personal clone of this repository. It may be of interest to setting up an overall software delivery lifecycle around Cloud Functions.

License

Apache 2.0


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.