tree: 1a23fb857f8ff028837f85f6001eb21b867ada29 [path history] [tgz]
  1. README.md
  2. archive/
  3. diagrams/
  4. html/
  5. images/
  6. openwhisk_v0.9.1.pdf
  7. openwhisk_v0.9.2.pdf
specification/README.md

OpenWhisk Packaging Specification

License

Current version (link): openwhisk_v0.9.1.pdf

Purpose

In general, the goal of this specification is to evolve a simple grammar to describe and deploy a complete OpenWhisk package without having to use any APIs. Primarily, it is accomplished by coding a Package Manifest file and optionally a Deployment file using YAML.

Programming Guide

If you want to learn how to write Packages and Applications by example using the specification and deploy them using the wskdeploy utility, please read the step-by-step guide:

OpenWhisk Package Specification (HTML)

Portions of the OpenWhisk Packaging Specification, for convenience, are made available here in HTML format. The canonical source for the specification is in PDF format and can be found within this directory.

Index


Note

This specification is under development and in draft status; therefore, it is subject to change during this development period. We are posting drafts seeking review, comments, suggestions and use cases from the OpenWhisk and greater Serverless community.


Package Manifest and Deployment files

  • Package Manifest file: Contains the Package definition along with any included Action, Trigger or Rule definitions that comprise the package. This file includes the schema of input and output data to each entity for validation purposes.
  • Deployment file: Contains the values and bindings used configure a Package to a target OpenWhisk platform provider’s environment and supply input parameter values for Packages, Actions and Triggers. This can include Namespace bindings, security and policy information.

Conceptual Manifest and Deployment file usage

The following images outline the basic process for creating and using both Manifest and Deployment files against a typical developer workstream:

Conceptual Manifest file creation

Manifest file creation


Conceptual Manifest file deployment

Manifest file deployment