Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Configure site development mode using Terraform

Última atualização: Jun 29, 2026

Utilize o Terraform para ativar rapidamente o modo de desenvolvimento do seu site. Esse recurso simplifica a depuração e a verificação de alterações no conteúdo de origem.

Instalar o Terraform e configurar 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. Se o par de AccessKey da sua conta Alibaba Cloud for comprometido, seus recursos ficarão expostos a grandes riscos. Recomendamos o uso do par de AccessKey de um usuário RAM. Para mais detalhes, visualize 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.

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

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

Se preferir 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, permitindo a execução direta de comandos do Terraform. Para mais informações, consulte Criar recursos com o Terraform.

Importante

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

Recursos envolvidos

Configure o modo de desenvolvimento do site

Crie um diretório de trabalho. Em seguida, crie arquivos de configuração nesse diretório conforme descrito abaixo e ajuste as definições no código para atender às suas necessidades.

Definir o provider e a versão do Terraform

Primeiramente, crie um arquivo de configuração chamado providers.tf. Copie o código a seguir para o arquivo a fim de gerenciar todas as configurações de provider e restrições de versão.

terraform {
  required_providers {
    alicloud = {
      source  = "aliyun/alicloud"
      version = "1.266.0"
    }
  }
}

provider "alicloud" {
  region = "ap-southeast-1"
}

Definir recursos

  1. Crie um arquivo de configuração chamado main.tf. Depois, copie o código abaixo para o arquivo para criar um site com o modo de desenvolvimento ativado.

    # 1. Purchase a site plan
    resource "alicloud_esa_rate_plan_instance" "default" {
      type       = "NS"        # Site access type: NS (DNS server) or CNAME
      auto_renew = true       # Whether to enable auto-renewal
      period     = "1"         # Purchase period (unit: months)
      coverage   = "overseas"  # Acceleration region. For more information, see the Metric Description section of this topic.
      auto_pay   = true       # Automatic payment
      plan_name  = "basicplan_intl"     # Plan name. For more information, see the Metric Description section of this topic.
      payment_type = "Subscription" # Payment type
    }
    
    # 2. Generate a random number (to generate a unique test domain name)
    resource "random_integer" "default" {
      min = 10000
      max = 99999
    }
    
    # 3. Create a site and enable development mode
    resource "alicloud_esa_site" "default" {
      site_name        = "bcd${random_integer.default.result}.com"  # Site name (domain name). In production environments, replace this with your actual domain name.
      coverage         = "overseas"                                # Acceleration region
      access_type      = "NS"                                      # Site access type: NS or CNAME
      instance_id      = alicloud_esa_rate_plan_instance.default.id  # Plan ID
      development_mode = "on"                                      # Enable development mode. For more information, see the Metric Description section of this topic.
    }
  2. Acesse o diretório que contém seus arquivos de configuração e execute o comando a seguir para inicializar o ambiente do Terraform.

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

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

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

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

Verifique resultados

Execute o comando terraform show

No diretório de trabalho, utilize o comando a seguir para consultar os detalhes dos recursos criados pelo Terraform:

terraform show

Fazer login no console para visualizar

  1. No console ESA, selecione Site Management. Na coluna Website, clique em no site desejado.

  2. No painel de navegação à esquerda, selecione Caching > Settings.

  3. Na página Settings, visualize os detalhes da nova configuração de cache criada.

(Opcional) Limpar recursos

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

terraform destroy

Referências relacionadas

Tipos de plano de site

A tabela a seguir descreve os valores válidos para o parâmetro plan_name no recurso alicloud_esa_rate_plan_instance.

Valor do parâmetro

Nome do plano

Descrição

entranceplan_intl

Entrance

Ideal para testes e cenários de negócios de pequeno porte. Inclui funcionalidades básicas de aceleração e segurança.

basicplan_intl

Pro

Recomendado para websites e aplicações de pequenas e médias empresas.

vipplan_intl

Enterprise

Voltado para médias e grandes corporações. Garante desempenho superior e segurança reforçada.

Descrição dos parâmetros

A tabela abaixo detalha os valores válidos para o campo development_mode no recurso Terraform alicloud_esa_site.

Valor

Função

Descrição

on

Ative modo de desenvolvimento

As solicitações de recursos estáticos ignoram o componente de cache dos POPs do ESA e acessam diretamente o servidor de origem. Isso é útil para depuração, pois permite comparar o desempenho do acesso direto à origem com o do conteúdo em cache.

off

Desativar modo de desenvolvimento (padrão)

As requisições de recursos estáticos seguem o caminho padrão pelos caches dos POPs de borda e retornam o conteúdo conforme a política de cache definida.

Cenários

Utilize o modo de desenvolvimento nas seguintes situações:

  • Depuração de conteúdo de origem: Ative este modo quando precisar que os clientes busquem os recursos estáticos mais recentes diretamente na origem.

  • Testes comparativos de efeito: Compare as diferenças entre o acesso direto ao servidor de origem e o acesso via cache do ESA.

  • Validação rápida de alterações: Após atualizar o conteúdo de origem, valide as mudanças imediatamente sem aguardar a expiração do cache ou realizar uma atualização manual.

Aviso

O modo de desenvolvimento envia todas as solicitações de recursos estáticos diretamente para a origem. Isso pode aumentar a carga no servidor de origem e o tempo de resposta. Utilize-o apenas durante o desenvolvimento e a depuração. Mantenha-o sempre desativado em ambientes de produção.

Perguntas frequentes

O que fazer quando ocorre "StatusCode400 Code: ConfExceedLimit" durante a execução do código Terraform?

Ao definir configurações de cache no console, uma regra correspondente é gerada automaticamente. No entanto, o recurso Terraform alicloud_esa_cache_rule cria novas regras em vez de atualizar as existentes. Para resolver isso, chame a API ListCacheRules para obter o ConfigId da configuração de cache atual e, em seguida, chame a API DeleteCacheRule para excluí-la. Feito isso, aplique o código Terraform.