自定义VCL快速入门

Fastly支持自定义版本的Varnish Configuration Language (VCL)，以根据您的要求定制Fastly服务配置。

自定义VCL代码段是添加到已上传到Adobe Commerce站点的活动VCL版本中的VCL逻辑块。 自定义VCL代码段可修改Fastly缓存服务响应请求流量的方式。 例如，您可以添加自定义VCL代码片段，以仅允许来自指定客户端IP地址的请求流量。 或者，创建一个代码片段以阻止来自已知向Adobe Commerce网站发送推荐垃圾邮件的网站的流量。

自定义VCL片段（生成、编译并传输到所有Fastly缓存）无需服务器停机即可加载和激活。

Fastly支持两种类型的自定义VCL片段：

我们建议将自定义VCL片段与Edge字典和访问控制列表(ACL)结合使用，以存储自定义代码中使用的数据。

字典和ACL数据会部署到可跨网络区域访问的Fastly Edge节点。 此外，数据可以跨网络动态更新，无需您为暂存或生产环境重新部署VCL代码。

教程

本教程和示例演示了如何结合使用常规自定义VCL片段与Edge字典和Edge ACL来自定义Adobe Commerce的Fastly服务配置。 有关更多详细信息，请参阅Fastly文档：

您可以从Adobe Commerce管理员或使用Fastly API创建和管理自定义VCL片段：

示例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

您可以从Admin的​ Fastly配置 > 自定义VCL片段 ​部分添加自定义VCL片段。

自定义VCL代码片段 ​视图仅显示通过管理员添加的代码片段。 如果使用Fastly API添加代码片段，请使用该API 管理它们。

以下示例显示如何从管理员创建和管理自定义VCL代码段，以及如何使用Fastly Edge模块和Edge词典：

使用API管理VCL

以下演练向您展示了如何使用Fastly API创建常规VCL代码片段文件并将其添加到您的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
}

将活动的版本号保存在bash环境变量中，以供在后续API请求中使用：

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代码片段

在JSON文件中创建并保存自定义VCL代码，该代码具有以下内容和格式：

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

这些值包括：

步骤4：将VCL代码段添加到Fastly配置

使用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代码片段后，Fastly会将该代码片段插入到正在编辑的VCL版本中。 要应用更改，请完成以下步骤以验证VCL代码段并激活VCL版本。

VCL代码片段的API快速参考

这些API请求示例使用导出的环境变量提供凭据来通过Fastly进行身份验证。 有关这些命令的详细信息，请参阅Fastly API引用。