使用Terraform配置重写URL规则 - 边缘安全加速

使用Terraform可以快速为站点配置URL重写规则，将访问路径与查询字符串按表达式转换。

安装Terraform并配置权限

在本地安装和配置Terraform

您可以参考安装和配置Terraform，在本地使用Terraform。

由于阿里云账号（主账号）拥有资源的所有权限，其AccessKey一旦泄露风险巨大，所以建议您使用满足最小化权限需求的RAM用户的AccessKey。具体操作方式请参见创建AccessKey。
创建环境变量，用于存放身份认证信息。
在AccessKey管理页面上创建和查看您的AccessKey。
若无对应环境变量，在执行terraform模板时无法确认身份信息，将会导致调用失败。

使用在线服务（免安装和权限配置）

如果您不想安装Terraform，可以直接使用在线服务Cloud Shell。

阿里云Cloud Shell是一款帮助您运维的免费产品，预装了Terraform的组件，并配置好身份凭证（Credentials）。因此您可直接在Cloud Shell中运行Terraform的命令。更多信息，请参见使用Terraform快速创建资源。

重要

通过Cloud Shell使用Terraform时，由于其销毁特性会导致数据丢失，因此建议您使用Cloud Shell做简单、快速的操作，例如调试。更多使用限制，请参见使用限制。

涉及的资源

查询站点信息：alicloud_esa_sites（数据源，用于引用已有站点）
配置重写 URL 规则：alicloud_esa_rewrite_url_rule

配置重写URL规则

创建一个名为 main.tf 的配置文件，然后将以下代码复制到配置文件中，用于为站点创建一条重写URL规则。

# 1. 查询已有站点信息
data "alicloud_esa_sites" "default" {
  site_name = "{{DOMAIN}}"  # 替换为您已接入边缘安全加速的站点域名，如 example.com
}

# 2. 配置重写URL：将以 /images/ 开头的路径改为 /static/img/，并移除全部查询参数
resource "alicloud_esa_rewrite_url_rule" "example" {
  site_id                   = data.alicloud_esa_sites.default.sites[0].site_id
  rule_name                 = "rewrite-images-prefix"
  rule_enable               = "on"
  rule                      = "starts_with(http.request.uri.path, \"/images/\")"
  rewrite_uri_type          = "dynamic"
  uri                       = "regex_replace(http.request.uri.path, \"^/images/\", \"/static/img/\")"
  rewrite_query_string_type = "static"
  query_string              = ""  # 空字符串表示删除全部查询参数
}

进入配置文件所在目录，执行如下命令，初始化Terraform环境。
```
terraform init
```
执行如下命令，验证Terraform语法与配置。
```
terraform validate
```
执行如下命令，预览执行结果。
```
terraform plan
```
执行如下命令，执行Terraform脚本。
```
terraform apply
```
依据提示输入yes确认执行即可。

验证结果

执行 terraform show 命令

您可以在工作目录中，使用以下命令查询 Terraform 已创建资源的详细信息：

terraform show

登录控制台查看

在ESA控制台选择站点管理，在站点列单击目标站点。
在左侧导航栏，选择规则 > 转换规则。在对应子功能页查看已创建的规则及配置。

（可选）清理资源

当您不再需要上述通过Terraform创建或管理的资源时，请运行terraform destroy命令以释放资源。

terraform destroy

取值	含义	说明
`static`	静态	将请求路径重写为固定的目标路径。
`dynamic`	动态	使用表达式根据请求动态计算目标路径。

取值	含义	说明
`static`	静态	将查询字符串替换为 `query_string` 指定的固定值；设为空字符串可删除全部查询参数。
`dynamic`	动态	使用表达式动态生成查询字符串。

边缘安全加速：使用Terraform配置重写URL规则