アプリケーションのビルドおよびデプロイ

アプリケーション・ソースを取得したら、多数のタスクを実行して、アプリケーションを使用するVisual Builder環境にアプリケーションをビルドおよびデプロイする必要があります。

ビジュアル・アプリケーション「Visual Builderインスタンスへ」を構築およびデプロイする場合に実行する一般的な一連のタスクは、次のとおりです:

vb-process-local
vb-package
vb-deploy

アプリケーションをローカルにビルドおよびデプロイするには:

コマンドライン・インタフェースを開き、node -vと入力して、Node.jsのバージョン18.x以降がインストールされていることを確認し、npm -vと入力してNPMがインストールされていることを確認します。
コマンドライン・インタフェースで、package.jsonおよびGruntfile.jsファイルを含むローカル・システム上のフォルダに移動します。
npm installを入力して、アプリケーションのビルドに必要なノード依存性を取得します。
installコマンドは、package.jsonで定義されているgrunt-vb-build NPMパッケージを取得します。
ヒント:
package-lock.jsonファイルをGitリポジトリに追加すると、ビルドの実行時にNPM依存関係への予期しない変更を回避できます。このファイルが存在する場合、 npm installコマンドは生成されたファイルを無視するため、ビルド・パイプラインでpackage-lock.jsonファイルにリストされた依存関係を使用するnpm ciコマンドを実行する必要があります。
この機能を利用するには:

Gitリポジトリをローカルにクローンします。

npm installを実行して、package-lock.jsonファイルを生成します。

生成されたファイルをローカルでコミットしてから、リモート・リポジトリにプッシュします。

package.jsonファイルが変更されるたびに、同じ方法で再生成する必要があります。
次の場合に変更が発生する可能性があります:

VBランタイム・リリースは、「設定」でアップグレードします。

Visual Builderは、サービスのアップグレード中に、ライブラリの依存関係を最新の利用可能なマイクロ・リリースに自動的にアップグレードします。

生成されたファイルは手動で編集してください。

コマンドライン・インタフェースにタスク名を入力して、アプリケーション・ソースを処理し、アプリケーションをパッケージ化し、アプリケーションをVisual Builderインスタンスにデプロイします。次の例は、サポートされているパラメータとともにこれらのタスクを実行する方法を示しています:

# First build application sources
./node_modules/.bin/grunt vb-process-local
    --url:ce=<URL of Component Exchange service>
    --username:ce=<username to access Component Exchange service>
    --password:ce=<password to access Component Exchange service>

# Package the application sources. This task in turn executes 
# vb-optimize and vb-manifest
./node_modules/.bin/grunt vb-package


# Deploy and publish the visual application to the target Visual 
# Builder instance using the data schema from the previously 
# published live version of the application.
./node_modules/.bin/grunt vb-deploy \
    --url:rt=https://vbruntime-instance.example.com/ic/builder/ \
    --username:rt=$vbuser \
    --password:rt=$vbpass \
    --id=helloworld \
    --ver=0.1 \
    --remoteProjectId=learning_demo_28288 \
    --remoteGitRepo=https://vbstudio-instance.example.com/vbstudio-vboci/s/learning_demo_28288/scm/learning_demo.git \
    --schema=live
    --publish

各タスクでサポートされているパラメータの完全なリストを表示するには、次を参照してください:

これらのGruntタスクが終了したら、デプロイされたアプリケーションのURLをブラウザで開いてアプリケーションをテストできます。これらのGruntタスクを実行するコマンドライン・インタフェースには、「web(またはモバイル)」アプリケーションのデプロイメント・ロケーションを識別するURLが表示されます。