garoon-plugin-uploaderは、プラグインファイルをGaroonに追加できるCLIツールです。
npmパッケージとして提供されているため、Windows／macOS／Linux環境で利用できます。

https://github.com/garoon/plugin-uploader

MIT ライセンス

https://github.com/garoon/plugin-uploader/blob/main/README.md

garoon-plugin-uploaderを実行するには、Node.jsとパッケージ管理ツールのnpmが必要です。
Node.jsをインストールすると、npmは自動でインストールされます。

1. Node.js 公式サイト からインストーラーをダウンロードします。
   必要なNode.jsのバージョンは、 package.json のenginesプロパティの値を確認します。
   たとえば次の記載の場合、Node.jsのパージョン14以上が必要です。

   1 2 3

   "engines": { "node": ">=14" },

2. ダウンロードしたインストーラーを実行し、画面にしたがってセットアップします。

garoon-plugin-uploaderをインストールします。
ここでは、例としてgaroon-plugin-uploaderをグローバルインストールする手順を説明します。

1

npm install -g @garoon/plugin-uploader

garoon-plugin-uploaderのバージョンを表示して、garoon-plugin-uploaderを実行できるかを確認します。

1
2
3

garoon-plugin-uploader --version

1.0.1 # バージョン番号

Garoonにプラグインをアップロードするには、--plugin-pathにプラグインファイルを指定します。

1. アップロードするプラグインファイルを準備する。
   Garoonに追加するプラグインのzipファイルをあらかじめ準備します。

2. Garoonにプラグインファイルを追加する。
   次のコマンドで、Garoonにプラグインファイルを追加します。
   プラグインをGaroonに追加するにはGaroonの システム管理者 の権限が必要です。

   1 2	garoon-plugin-uploader --base-url https://sample.cybozu.com --username ログイン名 --password パスワード \ --plugin-path プラグインファイルのパス

   環境に合わせて、次の値を変更してください。

   • sample.cybozu.com：適用するGaroonのドメイン名
   • ログイン名：Garoonのログイン名
   • パスワード：Garoonのログインパスワード
   • プラグインファイルのパス：zipファイルを配置している場所への相対パス

   実行例

   1 2 3 4 5 6 7 8 9 10 11

   garoon-plugin-uploader --base-url https://sample.cybozu.com --username yamada_taro --password Dj7m4hNL \ --plugin-path ~/Downloads/create-company-portal-plugin-v1.0.0.zip Open https://sample.cybozu.com/login?saml=off Trying to login..... Success Login! Navigate to https://sample.cybozu.com/g/system/plugin/settings.csp Start uploading file........... End uploading file. Waiting for reading file........... Success submitting file!

3. Garoonにプラグインが追加されているか確認する。
   Garoonシステム管理画面より プラグインの設定 を開き、プラグインが追加されているか確認します。
   

   

Garoonにすでに追加しているプラグインを更新するには、適用するプラグインファイルのパスと--plugin-idにプラグインIDを指定します。
--plugin-idを指定しない場合、新しいプラグインとして追加されます。

1. 更新するプラグインのzipファイルを準備する。

2. 更新するプラグインのプラグインIDを調べる。
   プラグインIDは プラグインの詳細画面 のURL内で確認します。
   次のようなURLの場合、プラグインIDは「1」です。

   1	https://sample.cybozu.com/g/system/plugin/view.csp?id=1

3. プラグインを更新する。
   次のコマンドで、Garoonに追加されているプラグインを更新します。
   プラグインを更新するには、Garoonの システム管理者 の権限が必要です。

   1 2	garoon-plugin-uploader --base-url https://sample.cybozu.com --username ログイン名 --password パスワード \ --plugin-path プラグインファイルのパス --plugin-id プラグイン ID

   環境に合わせて次の値を変更してください。

   • sample.cybozu.com：適用するGaroonのドメイン名
   • ログイン名：Garoonのログイン名
   • パスワード：Garoonのログインパスワード
   • プラグインファイルのパス：zipファイルを配置している場所への相対パス
   • プラグインID：更新するプラグインのプラグインID

   実行例

   1 2 3 4 5 6 7 8 9 10 11

   garoon-plugin-uploader --base-url https://sample.cybozu.com --username yamada_taro --password Dj7m4hNL \ --plugin-path ~/Downloads/sample-plugin-v2.0.0.zip --plugin-id 1 Open https://sample.cybozu.com/login?saml=off Trying to login..... Success Login! Navigate to https://sample.cybozu.com/g/system/plugin/view.csp?id=1 Start uploading file........... End uploading file. Waiting for reading file........... Success submitting file!

4. プラグインが更新されているか確認する。
   Garoonシステム管理画面より該当するプラグインの プラグインの詳細 を開き、プラグインが更新されているか確認します。

   コマンド実行前（適用しているプラグインのバージョンが「ver.1.0.0」）

   

   コマンド実行後（適用しているプラグインのバージョンが「ver.2.0.0」）

   

• garoon-plugin-uploaderを利用するには、次のいずれかの権限が必要です。
  • システム管理者（cybozu.com共通管理者）
  • プラグインの管理権限がある 基本システム管理者
• SAML認証を設定している場合には、システム管理者（cybozu.com共通管理者）で実行してください。

garoon-plugin-uploaderの最新の更新内容は、 Releases を確認してください。

• 2022年10月11日：記事を公開しました。

この記事の内容は、2022年10月版Garoonおよび @garoon/plugin-uploader v1.0.1で動作を確認しています。