Check! Bluemix OpenWhisk ファーストタッチ(2)~ よく使う wsk コマンド


こんにちは、オークファンの @dz_ こと大平かづみです。

Prologue - はじめに

Bluemix の OpenWhisk で遊んでいて、よく使う wsk コマンドをメモしておきます。

なお、wsk コマンドの詳細は、ドキュメントをご参照くださいませ。

OpenWhisk のよく使うコマンド

情報を表示する

名前空間

目的 wsk コマンド例
名前空間の一覧を表示する wsk namespace list
名前空間の持つエンティティ一覧を表示する wsk namespace get my-namespace

パッケージ

目的 wsk コマンド例
パッケージの一覧を表示する wsk package list
パッケージの一覧を表示する (名前空間を指定) wsk package list /my-namespace
パッケージの詳細を表示する wsk package get my-package
パッケージのサマリを表示する wsk package get --summary my-package

アクション

目的 wsk コマンド例
アクション一覧を表示する wsk action list
アクションの詳細を表示する wsk action get my-package/my-action
アクションのサマリを表示する wsk action get --summary my-package/my-action

トリガー

目的 wsk コマンド例
トリガー一覧を表示する wsk trigger list
トリガーの詳細を表示する wsk trigger get my-trigger

アクティベーション

目的 wsk コマンド例
アクティベーション一覧を表示する wsk activation list
アクティベーション一覧を取得する (表示件数を制限) wsk activation list --limit 1
指定したアクションのアクティベーション一覧を取得する wsk activation list my-action

作成する

パッケージ、アクション

目的 wsk コマンド例
パッケージを作成する wsk package create new-package
パッケージにアクションを作成する wsk action create my-package/new-action
アクション(単体)を作成する wsk action create new-action

トリガー

目的 wsk コマンド例
トリガーを作成する wsk trigger create new-trigger
トリガーにフィードを与えて作成する wsk trigger create new-trigger --feed <feed>

トリガーが発火することによって、アクションが実行されます。トリガーとアクションを紐づけるにはルールを設定します。(後述)

実行する

アクション

目的 wsk コマンド例
アクションを実行する wsk action invoke my-action --blocking
アクションを実行する (出力のみ表示) wsk action invoke my-action --blocking --result
アクションを実行する (パラメーターあり) wsk action invoke my-action --blocking --param param1 "xxx" --param param2 "xxx"
アクションを実行する (非同期で実行) wsk action invoke my-action
実行時の activationId から実行結果を得る wsk actiavation get <activationId>

アクションを実行すると、必ず activationId が振られます。その activationId により情報を閲覧することができます。

トリガー

目的 wsk コマンド例
トリガーを発火する wsk trigger fire my-trigger
トリガーを発火する (パラメーターあり) wsk trigger fire my-trigger --param param1 "xxx"

組み立てる

目的 wsk コマンド例
デフォルトパラメーターを設定する wsk action update my-action --param param1 "xxx"
シーケンスを組み立てる wsk action create new-sequence --sequence my-action,my-another-action
ルールを割り当てる wsk rule create --enable my-rule my-trigger my-action
ルールをアクティブにする wsk rule enable my-rule
ルールを非アクティブにする wsk rule disable my-rule

Epilogue - おわりに

ざっとドキュメントを流し終わったので、いろいろとサンプルを作って遊んでみます!