[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

カスタム VCL の概要

Fastly は、Varnish Configuration Language （VCL）のカスタマイズバージョンをサポートし、お客様の要件に合わせて Fastly サービス設定をカスタマイズします。

カスタム VCL スニペットは、Adobe Commerce サイトにアップロードされたアクティブな VCL バージョンに追加される VCL ロジックのブロックです。 カスタム VCL スニペットは、リクエストトラフィックに対する Fastly キャッシュサービスの応答方法を変更します。 例えば、カスタム VCL スニペットを追加して、指定されたクライアント IP アドレスからの要求トラフィックのみを許可することができます。 または、Adobe Commerce サイトに紹介スパムを送信することで知られている web サイトからのトラフィックをブロックするスニペットを作成します。

カスタム VCL スニペット（生成、コンパイル、すべての Fastly キャッシュに送信）が、サーバーを停止させることなく読み込みおよびアクティブ化されます。

Fastly では、次の 2 種類のカスタム VCL スニペットをサポートしています。

Edgeの辞書とアクセス制御リスト（ACL）と共にカスタム VCL スニペットを使用して、カスタムコードで使用するデータを保存することをお勧めします。

ディクショナリと ACL データは、ネットワーク地域全体でアクセス可能な Fastly Edge ノードにデプロイされます。 また、データは、ステージング環境または実稼動環境用に VCL コードを再デプロイしなくても、ネットワーク全体で動的に更新できます。

チュートリアル

このチュートリアルと例では、Edge ディクショナリとEdge ACL を含んだ通常のカスタム VCL スニペットを使用して、Adobe Commerce用の Fastly サービス設定をカスタマイズする方法について説明します。 詳しくは、Fastly のドキュメントを参照してください。

カスタム VCL スニペットは、Adobe Commerce管理者から、または Fastly API を使用して作成および管理できます。

VCL スニペットコードの例

次の例は、クライアントの IP アドレスでトラフィックをフィルタリングするカスタム VCL スニペット（JSON 形式）を示しています。

{
  "service_id": "FASTLY_SERVICE_ID",
  "version": "{Editable Version #}",
  "name": "apply_acl",
  "priority": "100",
  "dynamic": "1",
  "type": "hit",
  "content": "if ((client.ip ~ {ACLNAME}) && !req.http.Fastly-FF){ error 403; }"
}

content フィールドの VCL ロジックは、次のアクションを実行します。

次の表に、カスタム VCL スニペットのキーデータの詳細を示します。 詳しくは、Fastly のドキュメントの VCL スニペット ​ リファレンスを参照してください。

管理者からのカスタム VCL の管理

​ カスタム VCL スニペットの追加 ​ は、管理画面の Fastly 設定/カスタム VCL スニペット セクションから行えます。

カスタム VCL スニペット ビューには、管理者を通じて追加されたスニペットのみが表示されます。 Fastly API を使用してスニペットを追加する場合は、API を使用して ​ スニペットを管理 ​ します。

以下の例は、カスタム VCL スニペットを管理者から作成および管理する方法と、Fastly Edge モジュールおよびEdgeの辞書を使用する方法を示しています。

Commerce管理者で表示/変更できないスニペット

一部のスニペットは、Commerce Admin 内で直接表示または変更することはできません。 例えば、​ 動的スニペット ​ です。 「カスタム VCL スニペット」セクションには、クラウドサポートチームによって Fastly 管理ダッシュボード ​ に直接追加されたスニペットは表示されません。

クラウドサポートチームによって追加されたスニペットを確認するには：

API を使用した VCL の管理

次のウォークスルーでは、通常の VCL スニペットファイルを作成し、Fastly API を使用して Fastly サービス設定に追加する方法を示します。 ターミナル アプリケーションからスニペットを作成および管理できます。 特定の環境への SSH 接続は必要ありません。

前提条件：

VCL スニペットの追加

このチュートリアルでは、Fastly API を使用してカスタムスニペットを追加する基本的な手順を説明します。

前提条件

手順 1：アクティブな VCL バージョンを探す

Fastly API ​ バージョンを取得 ​ 操作を使用して、アクティブな VCL バージョン番号を取得します。

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/active

JSON 応答では、number キーで返されたアクティブな VCL バージョン番号（例："number": 99）をメモします。 VCL を編集用に複製する場合は、バージョン番号が必要です。

{
  "testing": false,
  "locked": true,
  "number": 99,
  "active": true,
  "service_id": "872zhjyxhto5SIRb3GAE0",
  "staging": false,
  "created_at": "2019-01-29T22:38:53Z",
  "deleted_at": null,
  "comment": "Magento Module uploaded VCL",
  "updated_at": "2019-01-29T22:39:06Z",
  "deployed": false
}

以降の API リクエストで使用するために、アクティブなバージョン番号を bash 環境変数に保存します。

export FASTLY_VERSION_ACTIVE=<Version>

手順 2：アクティブな VCL バージョンとすべてのスニペットを複製する

カスタム VCL スニペットを追加または修正する前に、編集用にアクティブな VCL バージョンのコピーを作成する必要があります。 Fastly API clone 操作を使用します。

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/$FASTLY_VERSION_ACTIVE/clone -X PUT

JSON 応答では、バージョン番号が増分され、アクティブ キー値は false になります。 新しい非アクティブな VCL バージョンは、ローカルで修正できます。

{
  "testing": false,
  "locked": false,
  "number": 100,
  "active": false,
  "service_id": "vW2bLFWhhto5SIRb3GAE0",
  "staging": false,
  "created_at": "2019-01-29T22:38:53Z",
  "deleted_at": null,
  "comment": "Magento Module uploaded VCL",
  "updated_at": "2019-01-29T22:39:06Z",
  "deployed": false
}

以降のコマンドで使用するために、新しいバージョン番号を bash 環境変数に保存します。

export FASTLY_EDIT_VERSION=<Version>

手順 3：カスタム VCL スニペットの作成

カスタム VCL コードを作成し、次の内容と形式で JSON ファイルに保存します。

{
  "name": "<name>",
  "dynamic": "0",
  "type": "<type>",
  "priority": "100",
  "content": "<code all in one line>"
}

値には次が含まれます。

手順 4:Fastly 設定への VCL スニペットの追加

Fastly API ​ スニペットを作成 ​ 操作を使用して、カスタム VCL スニペットを VCL バージョンに追加します。

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/$FASTLY_EDIT_VERSION/snippet -H 'Content-Type: application/json' -X POST --data @<filename.json>

<filename.json> は、前の手順で準備したファイルの名前です。 各 VCL スニペットに対して、このコマンドを繰り返します。

Fastly サービスから 500 Internal Server Error 応答を受け取った場合は、JSON ファイル構文を調べ、有効なファイルをアップロードしていることを確認します。

手順 5：カスタム VCL スニペットの検証とアクティブ化

カスタム VCL スニペットを追加すると、編集中の VCL バージョンにスニペットが挿入されます。 変更を適用するには、次の手順を実行して VCL スニペット コードを検証し、VCL バージョンをアクティブにします。

VCL スニペットの API クイックリファレンス

これらの API リクエストの例では、書き出された環境変数を使用して、Fastly で認証するための資格情報を提供しています。 これらのコマンドについて詳しくは、Fastly API リファレンス ​ を参照してください。