インストールと初期化
このガイドでは、NetFUNNEL Fastlyエージェントのインストールと初期化プロセスを説明します。
ステップ1: Client ID取得
- NetFUNNELコンソールに移動
- 右上のプロフィールアイコンをクリック
統合資格情報(Integration Credentials) メニューを選択Client IDをコピー
Client ID確認位置
コンソール画面右上のプロフィールアイコンをクリックした後、統合資格情報メニューで確認できます。
ステップ2: Fastly CLIインストール
Fastly CLIをインストールします:
brew install fastly/tap/fastly
ステップ3: Compute Service設定
Compute Service作成
- Fastlyコンソール → [Compute]に移動
- 右上の[Create service]をクリック
- [+ Use starter kit]を選択
- Service nameを入力
- Add your own domainにcomputeを適用するドメインを入力
- [Next: Choose a starter kit]をクリック
- Default starter for Rustを選択
- [Finalize and deploy]をクリック
CNAME登録
- Deploy完了後、Additional setupのPoint your custom domain to Fastlyを確認
- [Issue TLS Certification]をクリック
- Your DNS providerでドメインが登録されているサービスを選択
- 該当サービスでCNAME登録
Service Configuration設定
バージョン管理
Fastly computeは修正するたびに新しいバージョンにcloneする必要があります。
- [Edit configuration] (または[Service configuration])をクリック
- [Clone version 1 (active) to edit]をクリック
nf_core host作成
- Originsメニューを選択
- HostnameにserverUrlドメインを入力
- [Add]をクリック
- 作成したhostを選択 → Editページに移動
- Nameを
nf_coreに変更 - [Update]をクリック
nf_setting host作成
- [+ Create a host]をクリック
- HostnameにsettingUrlドメインを入力
- [Add]をクリック
- 作成したhostを選択 → Editページに移動
- Nameを
nf_settingに変更 - [Update]をクリック
origin host作成
- [+ Create a host]をクリック
- Hostnameにオリジンアドレスを入力
- [Add]をクリック
- 作成したhostを選択 → Editページに移動
- Nameを
originに変更 - [Update]をクリック
Activate
- 右上の[Activate]をクリックして保存
ステップ4: Config Store設定
Config Store作成
- Resourcesメニュー → Config storesに移動
- 右上の[+ Create store]をクリック
- Store name:
nf_config_storeを入力 - [Create]をクリック
- [Add item]をクリック
- 以下の表を参照して追加:
| Key | Value |
|---|---|
| CLIENT_ID | {'{CLIENT_ID}'} |
CLIENT_IDはNetFUNNELコンソールで確認してください。
Config Store接続
- 上部タブの[Linked Services]を選択
- [Link service]をクリック
- 上で作成したCompute serviceを選択
- [Next]をクリック
- [Link and activate]をクリック
- Active Service Versionsウィンドウで[Confirm and activate]をクリック
ステップ5: トークン作成
- Account → API tokens → Personal tokensに移動
- 右上の[+ Create Token]をクリック
- [Continue]をクリックして再度ログイン
- Nameを入力
- Expiration: Never expireを選択
- [Create Token]をクリック
ステップ6: エージェントデプロイ
エージェントファイルダウンロード
https://agent-lib.stclab.com/agents/cdn/fastly/netfunnel-fastly-agent-latest.tar から netfunnel-fastly-agent.tar ファイルをダウンロード
tomlファイル修正
- ダウンロードしたエージェントファイルを解凍
fastly.tomlファイルを開く- Fastlyコンソールでcompute serviceのIDをコピー
cloned_fromとservice_idにコピーしたIDを入力:
authors = []
cloned_from = "{SERVICE_ID}"
description = "Fastly agent for NetFUNNEL - Rust implementation"
language = "rust"
manifest_version = 3
name = "NetFUNNEL-Fastly-Agent-Rust"
service_id = "{SERVICE_ID}"
エージェントデプロイ
netfunnel-fastly-agentフォルダでターミナルを開く- 以下のコマンドを実行:
fastly compute deploy
エージェントコードがcomputeにデプロイされます。
次のステップ
- 初期化設定: Config Storeと追加機能設定
- トラブルシューティング: 一般的な問題と解決方法