This project provides a set of libraries and an CLI for deploying OpenWhisk entities specified in the format described below.

Getting started

$ npm install @openwhisk-libs/deploy --save

Features

The main features that are currently implemented are:

• concurrent deployment
• automatic dependencies management (ie. actions in a sequence are deployed before the sequence itself)
• extensible deployment format via plugin (experimental)
• modular specification

Supported action kinds: single nodejs file, nodejs module and inline nodejs code.

Example

# try-catch combinator example
packages:
  plugin-combinator-1:
    actions:
      safeToDelete:
        kind: nodejs
        code: |
          if (params.delete)
            return {}
          throw new Error('Oh No!')

      delete:
        kind: nodejs
        code: |
          delete params[params.delete]
          return params

      handleError:
        kind: nodejs
        code: |
          return {status: 'Um a very bad thing just happened - sorry?'}

      trycatch:
        combinator: try safeToDelete catch handleError

      eca:
        combinator: if safeToDelete then delete

      forward:
        combinator: forward ["authkey"] after safeToDelete with ["delete"]
        inputs:
          authkey: very private
          delete: something

      retry:
        combinator: retry delete 5 times

Deployment format specification

See specification