インストールと初期化
このガイドでは、NetFUNNEL Akamaiエージェントのインストールと初期化プロセスを説明します。
ステップ1: Client IDの取得
- NetFUNNELコンソールに移動
- 右上のプロフィールアイコンをクリック
統合資格情報(Integration Credentials) メニューを選択Client IDをコピー
Client IDの確認場所
コンソール画面右上のプロフィールアイコンをクリックした後、統合資格情報メニューで確認できます。
ステップ2: EdgeWorkerの作成
EdgeWorkerの作成
- Akamaiコンソール → [EdgeWorkers]メニューをクリック
- [Create EdgeWorker ID]をクリック
- 内容を入力して[Create EdgeWorker ID]をクリックしてEdgeWorkerを作成
- 作成したEdgeWorkerを選択して[Create version]をクリック
- [Open editor]をクリック
エージェントコードのアップロード
- https://agent-lib.stclab.com/agents/cdn/akamai/netfunnel-akamai-agent-latest.js から
netfunnel-akamai-agent.jsファイルをダウンロード - [Code Bundle]タブで
main.jsファイルを選択 netfunnel-akamai-agent.jsファイルの内容を貼り付けbundle.jsonファイルを選択して次のコードを記述:
{
"edgeworker-version": "1.0.0",
"description" : "akamai-agent-1.0.0"
}
- [Create new version]をクリックしてバージョンを作成
EdgeWorkerのデプロイ
- [Activate version]をクリック
- [Production]を選択して[Activate version]をクリックしてデプロイ
- デプロイ完了後、Current StatusがCompleteになれば完了
ステップ3: Propertyの作成 (オプション)
既に作成したPropertyがある場合は、次のステップに進んでください。
- [Properties]メニューをクリック
- [New Property]をクリック
- [Create Property]をクリック
- [Guide me]をクリック
- 内容を入力して[Next]ボタンをクリック
- Hostname値を確認して[Next]ボタンをクリック
- STEP1: 内容を入力、[Validate]をクリック、EDGE CERTIFICATEを選択
- [Continue]をクリック、キャッシュ設定後[Next]をクリック
- STEP2: [Next]をクリック
- STEP3: [Activate]をクリック、進行完了後[Next]をクリック
- STEP4: [Next]をクリック
- STEP5: [Exit]をクリックしてProperty作成完了
ステップ4: Propertyの設定
Propertyの選択
- [Properties]メニューをクリック
- 作成したPropertyを選択
- 修正するバージョンを選択 (一番上にあるバージョン)
Property Variablesの設定
次の表を参照してProperty Variablesを追加します。
| VARIABLE NAME | INITIAL VALUE |
|---|---|
NF_CLIENT_ID | {{CLIENT_ID}} |
CLIENT_IDはNetFUNNELコンソールで確認してください。
Property Configuration Settingsの設定
EdgeWorker Ruleの追加
- Property Configuration Settingsで[+Rules]をクリック
- [Blank Rule Template]を選択して"NF EdgeWorker"を入力
- [Insert Rule]をクリック
- Criteriaで[+Match]をクリック:
- Path:
matches one of→/*
- Path:
- [+Match]を追加:
- File Extension:
is not one of→ HTMLファイル除外、静的ファイル拡張子除外 - 除外する拡張子:
woff, woff2, ttf, eot, otf, sfnt, svg, webp, avif, map, mp4, webm, ogg, ogv, flac, acc, docx, xls, xlsx, ppt, pptx, csv, xml, json
- File Extension:
- Behaviorsで[+Behavior]をクリック → Standard property behaviorを選択
- EdgeWorkersを選択して[Insert Behavior]をクリック
- Identifierで作成したEdgeWorkerを選択
Core Origin Ruleの追加
- [+Rules]をクリック
- [Blank Rule Template]を選択して"NF Core Origin"を入力
- [Insert Rule]をクリック
- Criteriaで[+Match]をクリック:
- Path:
matches one of→/ts.wseq
- Path:
- Behaviorsで[+Behavior]をクリック → Standard property behaviorを選択
- Origin Serverを選択して[Insert Behavior]をクリック
- 次の表を参照して設定:
| 項目 | 値 |
|---|---|
| Origin Type | Your Origin |
| Origin Server Hostname | {CLIENT_ID}.netfunnel.stclab.com (例: stclab-0601.netfunnel.stclab.com) |
| Forward Host Header | Origin Hostname |
| Cache Key Hostname | Origin Hostname |
Setting Origin Ruleの追加
- [+Rules]をクリック
- [Blank Rule Template]を選択して"NF Setting Origin"を入力
- [Insert Rule]をクリック
- Criteriaで[+Match]をクリック:
- Path:
matches one of→{{NF_SETTING_URL}}のPath (例:/stclab-0601.netfunnel/nf-setting.json)
- Path:
- Behaviorsで[+Behavior]をクリック → Standard property behaviorを選択
- Origin Serverを選択して[Insert Behavior]をクリック
- 次の表を参照して設定:
| 項目 | 値 |
|---|---|
| Origin Type | Your Origin |
| Origin Server Hostname | nf-setting-bucket.stclab.com |
| Forward Host Header | Origin Hostname |
| Cache Key Hostname | Origin Hostname |
ステップ5: Propertyの保存と有効化
- 右下の[Save]ボタンをクリック
- 上部の[Activate]タブをクリック
- Production Networkで[Activate
{version}on Production]をクリック - Verifying完了後、上部の警告メッセージボックスにチェック
- [Activate
{version}on Production]をクリック - 進行完了後、Property有効化完了
次のステップ
- 初期化設定: Property Variablesと追加機能設定
- トラブルシューティング: 一般的な問題と解決方法