カスタム VCL の概要

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

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

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

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

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

辞書と 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; }"
}

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

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

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

次のことができます カスタム VCL スニペットを追加する から Fastly 設定 > カスタム VCL スニペット 」セクションを選択します。

この カスタム VCL スニペット 表示には、管理者を通じて追加されたスニペットのみが表示されます。 Fastly API を使用してスニペットを追加する場合は、API を使用して次の操作を行います それらを管理.

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

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 応答で、で返されたアクティブな VCL バージョン番号をメモします。 number キー（例：） "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 の使用 クローン 操作：

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 スニペットに対して、このコマンドを繰り返します。

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

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

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

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

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