alexxnica / incubator-openwhisk

Apache OpenWhisk is a serverless event-based programming service and an Apache Incubator project.

OpenWhisk

OpenWhisk is a cloud-first distributed event-based programming service. It provides a programming model to upload event handlers to a cloud service, and register the handlers to respond to various events. Learn more at http://openwhisk.incubator.apache.org.

• Quick Start (Vagrant)
• Native development (Mac and Ubuntu)
• Learn concepts and commands
• Issues
• Slack

Quick Start

A Vagrant machine is the easiest way to run OpenWhisk on Mac, Windows PC or GNU/Linux. Download and install VirtualBox and Vagrant for your operating system and architecture.

Note: For Windows, you may need to install an ssh client in order to use the command vagrant ssh. Cygwin works well for this, and Git Bash comes with an ssh client you can point to. If you run the command and no ssh is installed, Vagrant will give you some options to try.

Follow these step to run your first OpenWhisk Action:

# Clone openwhisk
git clone --depth=1 https://github.com/apache/incubator-openwhisk.git openwhisk

# Change directory to tools/vagrant
cd openwhisk/tools/vagrant

# Run script to create vm and run hello action
./hello

Wait for hello action output:

wsk action invoke /whisk.system/utils/echo -p message hello --result
{
    "message": "hello"
}

These steps were tested on Mac OS X El Capitan, Ubuntu 14.04.3 LTS and Windows using Vagrant. For more information about using OpenWhisk on Vagrant see the tools/vagrant/README.md

Native development

Docker must be natively installed in order to build and deploy OpenWhisk. If you plan to make contributions to OpenWhisk, we recommend either a Mac or Ubuntu environment.

• Setup Mac for OpenWhisk
• Setup Ubuntu for OpenWhisk

Learn concepts and commands

Browse the documentation to learn more. Here are some topics you may be interested in:

• System overview
• Getting Started
• Create and invoke actions
• Create triggers and rules
• Use and create packages
• Browse and use the catalog
• Using the OpenWhisk mobile SDK
• OpenWhisk system details
• Implementing feeds

Repository Structure

The OpenWhisk system is built from a number of components. The picture below groups the components by their GitHub repos. Please open issues for a component against the appropriate repo (if in doubt just open against the main openwhisk repo).

Issues

Report bugs, ask questions and request features here on GitHub.

Slack

You can also join the OpenWhisk Team on Slack https://openwhisk-team.slack.com and chat with developers. To get access to our public slack team, request an invite https://openwhisk.incubator.apache.org/slack.html.