NECモバイルバックエンド基盤 CLI

概要

NEC モバイルバックエンド基盤のコマンドラインインタフェース(CLI)ツールです。 主に API Gateway / Cloud Functions 関連の管理機能を提供します。

本ツールはサーバ管理用の CLI (baas-admin) とは異なり、クライアントサイドで使用する ツールになります。サーバとは REST API で通信します。

本ツールの詳細は、NEC モバイルバックエンド基盤マニュアル内の 「API Gateway利用手順書」および「Cloud Functions開発ガイド」を参照してください。

インストール手順

動作には Node.js v6.0.0 以上が必要です。 インストールは以下のように npm を使って行います。

$ npm install -g @nec-baas/cli

設定

ユーザコードのプロジェクトディレクトリで、

$ nebula init-config

を実行してください。nebula_config.json が生成されるので、 設定を追記してください。

使用方法

使用方法は "nebula -h" で確認してください。 いくつか手順を示します。

コードの登録

コード登録は以下のように行います。

$ npm pack
$ nebula create-code

アップロードするファイル名を --file オプションで指定します。

--file オプションは省略可能です。 省略した場合、コード登録に必要な情報は package.json から取得します。 具体的には以下の情報が参照されます。

• name: ハンドラの名称
• version: ハンドラのバージョン

アップロードに使用するファイル名は "{name}-{version}.tgz"となります。

API定義の登録

API を定義した Swagger 定義ファイルを JSON または YAML で作成してください。 (YAML の場合は、拡張子を .yaml または .yml にしてください)

以下手順で API 定義を登録します。

$ nebula create-api [Swagger定義ファイル]

Swagger 定義ファイル作成時の注意点は以下のとおりです。

• basePath 記載されたパス(の最終パス部分)が API 名として使用されますので、必ず記述してください。
• 各 API には、必ず operationId を記載してください。

ファンクションの登録

バインディング定義ファイルを JSON または YAML で作成してください。 (YAML の場合は、拡張子を .yaml または .yml にしてください)

以下手順でファンクションを登録します。

$ nebula create-function [Function定義ファイル] 

サンプル

サンプルのコード、API定義、ファンクション定義は、examples/hello ディレクトリに あります。