Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Use Terraform to configure network optimization rules

Última atualização: Jun 29, 2026

Utilize o Terraform para ativar roteamento inteligente, origem HTTP/2, WebSocket, gRPC e limites de tamanho de upload no seu site ESA.

Instale o Terraform e configure as permissões

Instale e configure o Terraform no seu computador

Para obter mais informações sobre como usar o Terraform no seu computador, consulte Instalar e configurar o Terraform.

  • Crie um par de AccessKey para um usuário RAM. Uma conta Alibaba Cloud possui todas as permissões sobre os recursos. Caso o par de AccessKey da sua conta Alibaba Cloud seja vazado, seus recursos ficarão expostos a grandes riscos. Recomendamos que você utilize o par de AccessKey de um usuário RAM. Para mais detalhes, veja Criar um AccessKey.

  • Crie variáveis de ambiente para armazenar as credenciais de identidade.

    É possível criar e visualizar seu AccessKey na página AccessKey Management.

    Se as variáveis de ambiente não estiverem configuradas, a verificação de identidade falhará durante a execução do modelo do Terraform.

Utilize um serviço online (sem necessidade de instalação ou configuração de permissões)

Caso prefira não instalar o Terraform, utilize o serviço online Cloud Shell.

O Alibaba Cloud Cloud Shell é um produto gratuito de operações e manutenção (O&M). Ele já vem com componentes do Terraform pré-instalados e credenciais de identidade configuradas. Assim, você pode executar comandos do Terraform diretamente no Cloud Shell. Para mais informações, consulte Criar recursos com o Terraform.

Importante

Ao usar o Terraform no Cloud Shell, o recurso destroy pode causar perda de dados. Recomendamos utilizar o Cloud Shell apenas para operações simples e rápidas, como depuração. Para saber mais sobre as limitações, veja Limites.

Recursos

Configure uma regra de otimização de rede

  1. Crie um arquivo chamado main.tf com a seguinte definição de regra de otimização de rede.# 1. Specify the name of the site to configure.

    data "alicloud_esa_sites" "default" {

    site_name = "DOMAIN" # Replace DOMAIN with an ESA-connected site, such as example.com.

    }

    2. Configure a network optimization rule.

    resource "alicloud_esa_network_optimization" "default" {

    site_id = data.alicloud_esa_sites.default.sites[0].site_id # The ID of the site to configure.

    rule_name = "example2" # The name of the rule.

    rule_enable = "on" # Enables the rule.

    rule = "true" # The matching condition. If set to true, the rule applies to all incoming requests.

    smart_routing = "on" # Enables smart routing, which uses real-time network probes and route optimization to deliver user requests faster and more reliably, reducing global latency and failure rates.

    http2_origin = "on" # Enables origin requests over HTTP/2 from ESA edge nodes.

    websocket = "on" # If your origin server supports ws:// or wss://, ESA proxies WebSocket origin requests by default. No additional configuration is typically needed.

    grpc = "on" # gRPC: A cross-language, cross-platform RPC framework based on HTTP/2 and Protobuf that reduces bandwidth and latency.

    upload_max_filesize = "300" # The maximum file size for a single upload request, in MB. Default: 300. Range: 100 to 500.

    }

  2. Acesse o diretório que contém seus arquivos de configuração e execute o comando abaixo para inicializar o ambiente do Terraform.

    terraform init
  3. Execute o seguinte comando para validar a sintaxe e a configuração do Terraform.

    terraform validate
  4. Execute o comando a seguir para visualizar o plano de execução.

    terraform plan
  5. Aplique a configuração executando este comando.

    terraform apply
  6. Quando solicitado, insira yes para confirmar e aplicar as alterações.

Verificação

Execute terraform show

No seu diretório de trabalho, execute o comando abaixo para inspecionar os recursos gerenciados pelo Terraform:

terraform show

Verifique no console

  1. No console do ESA, acesse Site Management. Na coluna Website, clique em seu site de destino.

  2. No painel de navegação à esquerda, escolha Rules > Network Optimization e visualize a regra de otimização de rede juntamente com sua configuração.

(Opcional) Limpeza de recursos

Quando esses recursos não forem mais necessários, execute o comando terraform destroy.

terraform destroy

Referências

Referência de parâmetros

As definições dos argumentos e os intervalos de valores válidos estão documentados na referência do recurso alicloud_esa_network_optimization. O valor de upload_max_filesize é expresso em MB e deve estar dentro do intervalo exibido no console.