gradle license/notice addition take 2. (#306)

2 files changed
tree: be965510d9db36d944a0a07c0628f46cf5dfb2d5
  1. gradle/
  2. packages/
  3. tests/
  4. tools/
  5. .gitignore
  6. .jshintrc
  7. .scalafmt.conf
  8. .travis.yml
  9. CONTRIBUTING.md
  10. credentials.json.enc
  11. DISCLAIMER.txt
  12. gradlew
  13. gradlew.bat
  14. LICENSE.txt
  15. NOTICE.txt
  16. README.md
  17. settings.gradle
README.md

Openwhisk Catalog

Build Status License

This openwhisk-catalog maintains the package catalogs of openwhisk. In OpenWhisk, the catalog of packages gives you an easy way to enhance your app with useful capabilities, and to access external services in the ecosystem. Examples of external services that are OpenWhisk-enabled include the Weather Company, Slack, and GitHub.system packages and sample packages.

The catalog is available as packages in the /whisk.system namespace. See Browsing packages for information about how to browse the catalog by using the command line tool.

How to install openWhisk-catalog

Pre-requisites

  • openwhisk is installed.
  • Environment variable OPENWHISK_HOME is configured as the path to openwhisk source code directory.

Install openwhisk-catalog

We should be able to run the script packages/installCatalog.sh to install the catalog like:

./packages/installCatalog.sh [catalog_auth_key] [api_host] [cli_path]

The first argument catalog_auth_key, defines the secret key used to authenticate the openwhisk service. The second argument api_host, determines the location, where the openwhisk edge host is running, in the format of IP or hostname. The third argument cli_path is the full path to the wsk cli executable.

Existing packages in catalog

PackageDescription
/whisk.system/githuboffers a convenient way to use the GitHub APIs.
/whisk.system/slackoffers a convenient way to use the Slack APIs.
/whisk.system/weatherServices from the Weather Company Data for IBM Cloud API
/whisk.system/websocketPackage to send messages to Web Socket server

How to create packages

If you want to create your own packages, openwhisk-package-template is a good package creation template to help you build, test and integrate new packages.

For more details about how to use these packages, you can go to the README.md under each package folder.

Disclaimer

Apache OpenWhisk Catalog is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.