初期化設定
このドキュメントでは、NetFUNNEL Fastly Agentで使用可能なConfig Store設定と追加機能を説明します。
Config Store設定
Config Storeを通じてNetFUNNELエージェントの動作を制御します。
必須設定
CLIENT_ID
NetFUNNELコンソールで発行されたクライアントIDを入力します。
| Key | Value |
|---|---|
| CLIENT_ID | {'{CLIENT_ID}'} |
設定方法:
- Resourcesメニュー → Config storesに移動
- エージェントで使用中のstoreを選択
- [Add item]をクリック
- Key:
CLIENT_ID, Value: NetFUNNELコンソールのClient IDを入力 - [Add]をクリック
- Compute purgeを実行
追加機能
Good Bot例外処理
Config Store設定を通じて、特定のUser-Agent値が含まれている場合、エージェント動作から例外処理できます。
Config Store設定
| Key | Value |
|---|---|
| GOOD_BOTS | Googlebot, Bingbot, Slurp, Applebot, facebookexternalhit |
例: Google、Microsoft、Yahoo、Apple、Facebookボットを例外処理した例です。
設定方法:
- Resourcesメニュー → Config storesに移動
- エージェントで使用中のstoreを選択
- [Add item]をクリック
- Key:
GOOD_BOTS, Value: 例外したいグッドボットのUser-Agentをカンマで区切って入力 - [Add]をクリック
- Compute purgeを実行
Compute Purge
- Computeメニュー → Compute Servicesに移動
- エージェントを適用したserviceを選択
- [Purge]をクリック
- [Purge all]を選択
- service nameを入力
- [Purge all]ボタンをクリック
進入キー自動返却処理
NetFUNNEL Fastlyエージェントは、進入後にNetFUNNELキーを自動的に返却して、次の待機者が進入できるように処理しています。NetFUNNELキーをすぐに返却せず、セグメントで設定したタイムアウト時間にNetFUNNELキーを返却したい場合に使用できる機能です。
Config Store設定
| Key | Value |
|---|---|
| RETURN_KEY | true |
true(デフォルト): 待機完了および進入後、エージェントでNetFUNNELキーを自動的に返却します。false: セグメントで設定したタイムアウト時間にキーが返却処理されます。
設定方法:
- Resourcesメニュー → Config storesに移動
- エージェントで使用中のstoreを選択
- [Add item]をクリック
- Key:
RETURN_KEY, Value:trueまたはfalseを入力 - [Add]をクリック
- Compute purgeを実行
Compute Purge
- Computeメニュー → Compute Servicesに移動
- エージェントを適用したserviceを選択
- [Purge]をクリック
- [Purge all]を選択
- service nameを入力
- [Purge all]ボタンをクリック
待機室ドメイン変更
NetFUNNEL待機室ページのドメインはagent-lib.stclab.comです。このドメインをサービス中のドメインに合わせて変更するには、NetFUNNELサービスチームを通じて希望するドメインを伝え、Config Store設定を変更する必要があります。
Config Store設定
| Key | Value |
|---|---|
| VWR_PAGE_DOMAIN | http(s)://{'{CNAME_DOMAIN}'} |
例: https://wait.stclab.com
設定方法:
- Resourcesメニュー → Config storesに移動
- エージェントで使用中のstoreを選択
- [Add item]をクリック
- Key:
VWR_PAGE_DOMAIN, Value: 変更したい待機室アドレスを入力 - [Add]をクリック
- Compute purgeを実行
Compute Purge
- Computeメニュー → Compute Servicesに移動
- エージェントを適用したserviceを選択
- [Purge]をクリック
- [Purge all]を選択
- service nameを入力
- [Purge all]ボタンをクリック
クッキードメイン設定
NetFUNNELサーバーで発行したキーをクッキーに保存する際、現在のページのドメインを基準に保存します。異なるサブドメイン間でキーを共有する必要がある場合、メインドメインがクッキーに保存されるように設定します。
例: develop.stclab.comとstaging.stclab.comのようにサブドメインが異なるページ間でクッキーを共有するように.stclab.comに設定します。
Config Store設定
| Key | Value |
|---|---|
| COOKIE_DOMAIN | .{'{MAIN_DOMAIN}'} |
例: .stclab.com
設定方法:
- Resourcesメニュー → Config storesに移動
- エージェントで使用中のstoreを選択
- [Add item]をクリック
- Key:
COOKIE_DOMAIN, Value:.MAIN_DOMAIN形式で入力 - [Add]をクリック
- Compute purgeを実行
Compute Purge
- Computeメニュー → Compute Servicesに移動
- エージェントを適用したserviceを選択
- [Purge]をクリック
- [Purge all]を選択
- service nameを入力
- [Purge all]ボタンをクリック
Config Store変更後のCompute Purge
Config Storeを変更した後は、必ずCompute Purgeを実行して変更内容を適用する必要があります。
- Computeメニュー → Compute Servicesに移動
- エージェントを適用したserviceを選択
- [Purge]をクリック
- [Purge all]を選択
- service nameを入力
- [Purge all]ボタンをクリック
関連ドキュメント
- インストールと初期化: Config Store基本設定
- トラブルシューティング: 一般的な問題と解決方法