Google Git
Sign in
apache / openwhisk-cli / refs/tags/1.0.0-preApache
tagfea8f994214a7f1b98ceef4dab224805705719ce
taggerVincent Hou <shou@us.ibm.com>Fri Apr 28 16:28:57 2017 -0400
object218ff0b5e1e208b9b3a0e3f607230aa8954d619e 
This is the GA release of OpenWhisk CLI.
commit218ff0b5e1e208b9b3a0e3f607230aa8954d619e[log] [tgz]
authorVincent Hou <shou@us.ibm.com>Wed Apr 26 12:30:39 2017 -0400
committerVincent Hou <shou@us.ibm.com>Fri Apr 28 16:21:58 2017 -0400
treeaaaecbbd191c5ca42062a1679f905c258683236d
parenta07f5f6fd96ff99bcc5f6bf9a37dc5c1fc492813 [diff]
parenta819460737fd052d8d8e2c557e3edd930a6e97d1 [diff]
Merging the repositories of openwhisk-cli and historic go-whisk-cli.
tree: aaaecbbd191c5ca42062a1679f905c258683236d
  1. .idea/
  2. commands/
  3. Godeps/
  4. gradle/
  5. tests/
  6. tools/
  7. wski18n/
  8. .appveyor.yml
  9. .gitignore
  10. .travis.yml
  11. build.gradle
  12. build.sh
  13. CONTRIBUTING.md
  14. Dockerfile
  15. gradlew
  16. gradlew.bat
  17. main.go
  18. Makefile
  19. notes.md
  20. README.md
README.md

OpenWhisk Command Line Interface wsk

The OpenWhisk Command Line Interface (OpenWhisk CLI) is a unified tool that provides a consistent interface to interact with OpenWhisk services. With this tool to download and configure, you are able to manage OpenWhisk services from the command line and automate them through scripts.

Where to download the binary of OpenWhisk CLI

The OpenWhisk CLI is available on the release page: click here to download. We currently have binaries available for Linux, Mac OS and windows under amd64 architecture. You can download the binary, which fits your local environment.

How to build the binary locally

You can also choose to build the binary locally based on the source code. First, install the prerequisites to download and build OpenWhisk CLI: installing Git.

Then, download the source code via the Git command:

$ git clone https://github.com/openwhisk/openwhisk-cli.git

OpenWhisk CLI(wsk) is produced in a Docker container during the build process which is copied from the Docker container to the local file system in the following directory: bin. This binary will be platform specific, it will only run on the operating system, and CPU architecture that matches the build machine.

Build the binary with Go

The binary can be built by Go build command. Make sure that you have Go installed: installing Go.

After that, open an terminal, go to the directory of OpenWhisk CLI home directory, and build the binary via the following command:

$ go build -o wsk

If you would like to build the binary for a specific operating system, you may add the arguments GOOS and GOARCH into the Go build command. Since it is only applicable under amd64 architecture, you have to set GOARCH to amd64. GOOS can be set to “linux” “darwin” or “windows”.

For example, run the following command to build the binary for Linux:

$ GOOS=linux GOARCH=amd64 go build -o wsk

If it is executed successfully, you can find your binary wsk directly under OpenWhisk CLI home directory.

Build the binary with Docker and Gradle

This is the second choice for you to build the binary. Make sure that you have Docker and gradle on your machine: installing Docker and installing Gradle for your local machine.

After that, open an terminal, go to the directory of OpenWhisk CLI home directory, and build the binary via the following command under Linux or Mac:

$ ./gradlew distDocker

or run the following command for Windows:

$ ./gradlew.bat distDocker

Finally, you can find the binary wsk or wsk.exe in the bin folder under the OpenWhisk CLI home directory.

How to use the binary

When you have the binary, you can copy the binary to any folder, and add folder into the system PATH in order to run the OpenWhisk CLI command. To get the CLI command help, execute the following command:

$ wsk --help

To get CLI command debug information, include the -d, or --debug flag when executing this command.