vb-prerender-cache-warm

レンダー・サーバーのキャッシュをウォームして、Google検索に使用される主要なwebクローラであるGooglebotがWebアプリケーションのページにインデックスを付ける際にリクエストに対するレスポンス時間を改善します。

Visual Builderページに対するリクエストがGooglebot(または他の検索エンジン)から受信されると、リクエストはVisual Builderに埋め込まれたレンダー・サーバーを介してルーティングされます。レンダー・サーバーは、ページをGooglebotに戻す前に、ページを完全にレンダリングするために必要なJavaScriptを実行します。このように、Googlebotは常にインデックス作成のための完全にレンダリングされたページを受け取ります。

プリレンダ・サーバーがURLをレンダリングすると、ページがキャッシュされるため、同じURLに対する後続のリクエストに対してマークアップをすぐに返すことができます。マークアップがまだキャッシュされていない場合、ページのレンダリング・プロセスには時間がかかる場合があります。通常、Googlebotは、このプロセスが完了するまで待機しますが、レンダー・サーバーのキャッシュをアプリケーションのサイト・マップ内のURL用にウォームすることをお勧めします。そのため、Googlebotは、これらのURLをリクエストするときに常に最速のレスポンスを受け取ります。

vb-prerender-cache-warmタスクを使用して、アプリケーション(または新しいバージョン)のデプロイ後にプリレンダ・サーバーのキャッシュをウォーム・アップします。

ノート:

キャッシュをウォーミングする前に、アプリケーションのソースの一部として最新のsitemap.xmlファイルがあることを確認してください。「Webアプリケーションのリソースへのサイト・マップの追加」を参照してください。

次の表に、vb-prerender-cache-warmタスクのサブタスク、フックおよび入力と出力を示します:

詳細	説明
サブタスク	該当なし
マルチタスク	該当なし
フック	該当なし
input	`path_to_web_app's_sitemap_file`
output	`Prerender server cache populated`

次の表では、vb-prerender-cache-warmタスクのオプションについて説明します:

名前	必須	デフォルト値	説明
id	はい	該当なし	WebアプリケーションのID (`MyApplication`など)。
ver	はい	該当なし	Webアプリケーションのバージョン(`1.0`など)。
url[:dt]	はい	該当なし	Visual Builderデザインタイム・サービスのURL。たとえば、`https://my.visualbuilder.com/ic/builder`。 `:dt`サフィクスはオプションです。
サイトマップ	いいえ	sitemap.xml	ファイル・システム上の`sitemap.xml`ファイルへのパス(`webApps/myWebApp/sitemap.xml`など)。
manifest	いいえ	manifest.json	`manifest.json`へのパス。このファイルは、正常にレンダリングされた内容を追跡するため、必要に応じてプロセスを再実行できます。たとえば、`sitemap.xml`のエントリが変更されると、プロセスによって、変更されたエントリが判別され、それのみがウォームになります。このファイルには、正常に取得されなかったURLの詳細も保存されるため、再試行できます。
userAgent	いいえ	デフォルトのChromeユーザー・エージェント	ページのリクエスト時に使用するユーザー・エージェント。
clearCache	いいえ	false	ウォーミングを開始する前にキャッシュをクリアするには、このフラグを`true`に設定します。既存のキャッシュ・ページには壊れたアセット・リンクが含まれるため、アプリケーションの新しいバージョンがデプロイされる場合は、このフラグをお薦めします。

このタスクの使用方法の例は、「サイト・マップのURLのキャッシュのウォーム」を参照してください。

vb-prerender-cache-warmタスクは、サーバーに接続する他のGruntタスクと同じ認証オプションを使用します:

名前	必須	デフォルト値	説明
username	いいえ	該当なし	Visual Builderランタイムとのさらなる通信のためにOAuthアクセス・トークンを取得するために使用するユーザー名。
password	いいえ	該当なし	Visual Builderランタイムとさらに通信するためにOAuthアクセス・トークンを取得するために使用するパスワード。 `--password` Gruntオプションで指定されたパスワードは、特殊文字が含まれる場合は一重引用符(')で囲む必要があります。一般に、`--password`オプションには常に引用符を使用することをお勧めします。特に、ジョブ変数を使用してパスワードが指定されているVB Studioジョブではこの引用符を使用することをお勧めします。たとえば: `grunt vb-deploy '--password=Jkl@#&!%^23' ...`。
accessToken	いいえ	該当なし	OAuthアクセス・トークンの値。指定した場合、ユーザー名およびパスワードのオプションは必要ありません。
sslCertificate	いいえ	該当なし	自己署名証明書でプロビジョニングされたVisual Builderインスタンスへの接続用のSSL証明書へのパス。