Blade CLIのインストールと更新
Blade CLIは、コマンドラインインターフェイスまたはグラフィカルインストーラーを使用してインストールできます。 プロキシの背後にいる場合は、インストールすると、プロキシを介して動作するように構成できます。 Blade CLIは、新しいバージョンがリリースされたときに通知し、CLIからいつでもアップグレードできます。
CLIのインストール
Blade CLIのインストール方法に関係なく、Java JDKの実装が最初にインストールされていることを確認してください。
CLIからインストールする
LinuxおよびMacオペレーティングシステム用のBlade CLIのインストールは、1行のコマンドです。
curl -L https://raw.githubusercontent.com/liferay/liferay-blade-cli/master/cli/installers/local | sh
インストールが完了すると、Bladeが正常にインストールされました
というメッセージが表示されます。新しいコマンドラインを開き、blade
と入力します。エラーが見つからないコマンドがある場合は、 パスに blade
コマンドを追加する 必要があります。
グラフィカルインストーラーからインストールする
インストーラの方が使いやすいという方は、最新の Liferay Project SDK Installer をダウンロードし、実行してみてください。
Javaランタイムを選択します。 これは自動検出されます。
イントロダクションの後、 [Next] をクリックします。
インストール中に Liferay Workspace 初期化できます。 Liferay Workspaceは、Liferayプロジェクトを管理するシステム上の環境(一連のフォルダー)です。 今すぐ初期化する場合は、その場所を設定します。
Liferay Workspaceを初期化する場合は、次にLiferay DXPまたはCommunity Editionを選択する必要があります。
製品タイプを選択し、 [Next] をクリックします。
[Next] をクリックして、Blade CLIをインストールします。
Windows環境では、blade
コマンドがパスに自動的に追加されます(Windowsの場合、またはMacおよびLinuxで bash
または zsh
を使用している場合)。 詳細は、 Blade CLI トラブルシューティングを参照してください。
プロキシの構成
プロキシサーバーの背後にいる場合は、CLIから構成できます。
jpm command --jvmargs "-Dhttp(s).proxyHost=[your proxy host] -Dhttp(s).proxyPort=[your proxy port]" jpm
これで、BladeはインターネットからLiferayサンプルおよびテンプレートにアクセスするときにプロキシサーバーを使用できます。
Blade CLIの更新
Blade CLIを使用すると、更新があるかどうかが確認されます。 更新が利用可能な場合、コマンドが完了すると次のメッセージが表示されます。
Update available 3.9.1 -> 3.9.2
Run `blade update` to install
Bladeを更新するには、次のコマンドを実行します。
blade update
最先端の機能が必要な場合は、オプションで、より頻繁に更新されるスナップショットバージョンに切り替えることができます。
blade update -s
スナップショットのバージョンは不安定になる可能性があるため、自己責任で使用してください。
Bladeコマンド
以下は、使用可能なBladeコマンドの概要です。 blade help [command]
と入力すると、CLIでヘルプを利用できます。
コマンド | Description |
---|---|
変換 |
Plugins SDKプラグインプロジェクトをGradleワークスペースプロジェクトに変換します。 |
作成 |
利用可能なテンプレートから新しいLiferayプロジェクトを作成します。 |
デプロイする |
プロジェクトをビルドしてLiferayにデプロイします。 |
extension install |
拡張機能をBlade CLIにインストールします。 |
extension uninstall |
Blade CLIから拡張機能をアンインストールします。 |
gw |
検出された場合、Gradleラッパーを使用してGradleコマンドを実行します(例: blade gw tasks )。 |
help |
Blade CLIのコマンドに関する情報を提供します。 |
init |
新しいLiferay Workspaceを初期化します。 |
samples |
サンプルプロジェクトを生成します。 |
server init |
Liferay Workspaceの gradle.properties ファイルで構成されたLiferayサーバーを初期化します。 liferay.workspace.bundle.url プロパティを設定して、サーバーを初期化するように構成します。 |
server start |
Liferayサーバーをバックグラウンドで起動します。 -d フラグを追加して、サーバーをデバッグモードで起動できます。 デバッグモードをカスタマイズするには、-p タグを追加してカスタムリモートデバッグポートを設定したり(デフォルトはTomcatの場合は8000 、WildFlyの場合は8787 )、ブール値の-s タグを追加してデバッガーが接続されるまで起動したサーバーを一時停止するかどうかを設定したりします。 |
server stop |
Liferayサーバーを停止します。 |
server run |
フォアグラウンドでLiferayサーバーを起動します。 詳細は、 server start プロパティを参照してください。 |
sh |
Liferay DXPに接続し、Gogoコマンドを実行して、出力を返します。 たとえば、 blade sh lb は、Gogoシェルを使用するすべてのバンドルをリストします。 |
更新 |
Blade CLIを最新バージョンに更新します。 |
upgradeProps |
古い portal-ext.properties と新しくインストールされた7.xサーバーを分析して、OSGi構成ファイルに移動されたか、製品から削除されたプロパティを表示します。 |
watch |
デプロイされたプロジェクトへの変更を監視し、変更が検出されると自動的に再デプロイします。 このコマンドは、変更が検出されるたびにプロジェクトを再ビルドしてインストールにコピーするのではなく、参照としてランタイムにインストールします。 つまり、Liferay DXPはプロジェクトのキャッシュコピーを作成しないため、プロジェクトのファイルに加えられた変更をすぐに確認できます。 watch タスクをキャンセルすると、モジュールは自動的にアンインストールされます。 blade deploy -w コマンドはblade watch と同様に機能しますが、変更が検出されるたびにプロジェクトを手動で再コンパイルしてデプロイします。 これは遅くなりますが、再起動の間、デプロイされたプロジェクトを保持します。 |
バージョン |
Blade CLIのバージョン情報を表示します。 |