全部產品
Search
文件中心

Edge Security Acceleration:Terraform參考

更新時間:Sep 12, 2025

Terraform是一個開源的基礎設施即代碼工具,允許開發人員通過聲明式的語言來定義和管理基礎設施的配置,提供了一種簡潔的方式來添加、修改或刪除ESA資源,減少手動操作的繁瑣和錯誤,提高基礎設施的可管理性和可維護性。您可以參考本文查看 Terraform 支援的 ESA 資源,以及學習如何安裝與配置Terraform。

支援的資源清單

Resources

alicloud_esa_cache_reserve_instance:提供 ESA緩衝預留執行個體資源。建立了一個緩衝預留執行個體,開啟自動續約,為雲端儲存加速服務預分配高吞吐緩衝資源,提升高頻訪問資料的響應效能。

alicloud_esa_cache_rule:提供 ESA 緩衝規則資源。配置緩衝規則邊緣節點遵循來源站點緩衝策略、瀏覽器禁用緩衝、忽略查詢字串差異,並包含特定Cookie/Header緩衝控制參數。

alicloud_esa_certificate:提供 ESA認證資源。自動申請並部署免費的Let's Encrypt SSL認證,實現HTTPS通訊加密。

alicloud_esa_client_ca_certificate:提供 ESA 用戶端CA認證資源。上傳用戶端CA根憑證,用於雙向TLS認證(mTLS)情境下驗證用戶端認證的合法性,確保僅允許受信任CA簽發的用戶端認證訪問服務。

alicloud_esa_client_certificate:提供 ESA 用戶端認證資源。建立RSA加密用戶端認證,用於實現雙向TLS認證(mTLS)情境下的用戶端身份強驗證。

alicloud_esa_compression_rule:提供 ESA 壓縮規則資源。網域名稱配置壓縮規則,為後續按需開啟特定壓縮策略提供預置條件。

alicloud_esa_edge_container_app:提供 ESA Edge 容器應用程式資源。建立容器應用,將外部流量轉寄至容器內部,並配置L7層健全狀態檢查(HEAD方法檢測/路徑,每5秒一次,逾時3秒,連續2次成功/5次失敗觸發狀態變更),實現Container Service的自動化健康監控與故障隔離。

alicloud_esa_edge_container_app_record:提供 ESA Edge 容器應用程式記錄資源。部署邊緣容器應用,配置L7層健全狀態檢查(HEAD方法檢測/路徑),同時綁定網域名稱實現流量調度,需確保容器3000連接埠服務可用且健全狀態檢查參數與業務匹配。

alicloud_esa_http_request_header_modification_rule:提供 ESA Http 請求標題修改規則資源。配置要求標頭修改規則,修改要求標頭的值,為後續流量精細化調試提供預置規則支援。

alicloud_esa_http_response_header_modification_rule:提供 ESA Http 響應前序修改規則資源。對網域名稱流量啟用回應標頭修改規則(增/刪/改Header),新增exampleadd頭、刪除exampledel頭、修改examplemodify頭值,實現基於業務情境的HTTP回應標頭精細化管控。

alicloud_esa_https_application_configuration:提供 ESA Https 應用程式配置資源。網域名稱的請求配置了包含HSTS最長有效期間的HTTPS應用程式層參數,啟用規則、HSTS強制、Alt-SVC等安全擴充功能。

alicloud_esa_https_basic_configuration:提供 ESA Https 基本配置資源。強制啟用全域HTTPS加密策略。

alicloud_esa_image_transform:提供 ESA 映像轉換資源。為網域名稱配置映像格式轉換規則。

alicloud_esa_kv:提供 ESA邊緣KVStore for Redis(Key-Value Store)資源,用於在邊緣節點上儲存和管理輕量級的配置資料或靜態內容,支援快速讀取與低延遲訪問。

alicloud_esa_kv_namespace:提供 ESA KV 命名空間資源。建立namespace 的索引值(Key-Value)儲存命名空間,用於隔離儲存和管理安全性原則、動態規則等配置資料(如API密鑰、灰階參數),為安全加速提供可熱更新的輕量級中繼資料管理能力。

alicloud_esa_list:提供 ESA 列表資源。查看ESA的網站列表。

alicloud_esa_network_optimization:提供 ESA 網路最佳化資源。為匹配網域名稱的請求配置網路最佳化規則,支援WebSocket/gRPC/HTTP2回源協議,同時限制檔案上傳最大尺寸,實現針對特定業務流量的網路傳輸最佳化與安全管控。

alicloud_esa_origin_ca_certificate:提供 ESA來源站點CA認證資源。該資源用於將受信任的CA(憑證授權單位)認證 配置到阿里雲邊緣安全加速(ESA)服務中,以便在 ESA 邊緣節點與後端來源站點建立 HTTPS 回源串連 時,對來源站點伺服器憑證進行身分識別驗證,確保回源通訊的安全性和可信性。

alicloud_esa_origin_client_certificate:提供 ESA來源站點用戶端認證資源。該資源用於建立或上傳一個用戶端 TLS 認證(Client Certificate),並將其配置到阿里雲邊緣安全加速(ESA)服務中,以便在 ESA 邊緣節點作為 HTTPS 用戶端向後端來源站點發起回源請求時,向來源站點提供用戶端身份認證,實現 雙向 TLS 認證(mTLS, mutual TLS)中的用戶端驗證。

alicloud_esa_origin_pool:提供 ESA 源池資源。配置多來源站點混合池,包含一個阿里雲OSS來源站點(跨帳號密鑰認證)和兩個相容S3協議的私人儲存來源站點(AWS v2簽名認證),實現跨國流量按比例分發至不同雲端儲存體服務,同時通過Host頭重寫和TLS SNI保障回源相容性。

alicloud_esa_origin_protection:提供 ESA 來源站點保護配置資源。統一配置和管理後端來源站點的安全防護策略,通過隱藏來源站點真實 IP、強制流量經由 ESA 邊緣節點轉寄、啟用安全認證機制等方式,防止來源站點伺服器直接暴露在公網,抵禦 DDoS 攻擊、CC 攻擊、掃描探測等威脅,提升整體後端服務的可用性與安全性。

alicloud_esa_origin_rule:提供 ESA Origin Rule 資源。通過HTTP協議將流量轉寄至來源站點的連接埠,並啟用Host頭傳遞、SNI擴充及分塊傳輸(Range)支援。

alicloud_esa_page:提供 ESA 頁面資源。建立了一個自訂錯誤頁面資源,Base64編碼的HTML模板(解碼後為標準的403禁止訪問頁面,含中文語言聲明)。

alicloud_esa_rate_plan_instance:提供 ESA Rate Plan 執行個體資源。通過訂用帳戶方式建立NS類型資費執行個體,啟用自動續約和自動支付,為後續部署Global Acceleration服務(如網站、路由規則等)提供基礎資源配額和計費架構。

alicloud_esa_record:提供 ESA 記錄資源。添加記錄,設定優先權、權重、TTL,實現基於DNS協議的服務發現與負載平衡。

alicloud_esa_redirect_rule:提供 ESA 重新導向規則資源。配置301永久重新導向規則,自動跳轉至靜態目標地址,同時保留原始請求的查詢參數。

alicloud_esa_rewrite_url_rule:提供 ESA 重寫 URL 規則資源。啟用URL重寫規則,將路徑靜態重寫且固定查詢參數,實現精準的請求路徑控制與參數正常化。

alicloud_esa_routine:提供ESA邊緣函數(Edge Routine)資源。運行於全球邊緣節點的輕量級函數化代碼(Edge Function),允許使用者通過自訂 JavaScript 或類似文法的指令碼,在靠近終端使用者的網路邊緣動態處理 HTTP(S) 請求和響應,實現低延遲、高效能的個人化邏輯控制。

alicloud_esa_routine_route:提供ESA邊緣函數路由資源。該資源用於將已建立的邊緣函數(由 alicloud_esa_routine 定義)與指定的網域名稱、路徑或主機名稱進行綁定,定義在何種請求條件下觸發執行該邊緣函數,從而實現 基於路由規則的邊緣邏輯調度。

alicloud_esa_scheduled_preload_execution:提供ESA定時預熱執行資源。用於觸發已配置的預熱任務在指定時間自動執行,提前將指定URL內容主動載入至邊緣節點緩衝,提升使用者訪問響應速度,適用於周期性或高峰前的內容預先載入情境。

alicloud_esa_scheduled_preload_job:提供ESA定時預熱任務資源。用於建立和管理周期性緩衝預熱任務,通過配置執行頻率、目標URL列表及所屬網域名稱,自動觸發內容預先載入至邊緣節點,提升高頻訪問資源的響應效率,最佳化使用者訪問體驗。

alicloud_esa_site:提供 ESA 網站資源。通過訂閱購買基礎版的NS類型Global Acceleration執行個體,建立網站,將網站與資源群組綁定,實現全球網路加速能力的自動化部署。

alicloud_esa_site_delivery_task:提供 ESA 網站交付任務資源。配置HTTP日誌投遞任務,通過gzip壓縮將包含12個關鍵監控欄位的日誌資料即時傳輸至目標地址,設定單次最大批量、重試機制及逾時控制,保障日誌傳輸的可靠性與時效性。

alicloud_esa_site_origin_client_certificate:提供ESA網站級來源站點用戶端認證資源。用於為特定加速網站配置用戶端TLS認證,使ESA邊緣節點在回源時可基於mTLS向來源站點提供身份認證,確保僅受信邊緣節點可訪問啟用用戶端認證驗證的來源站點服務,增強回源通訊安全性。

alicloud_esa_version:提供ESA網站版本(Site Version)資源。通過 esa_version,使用者可以為加速網站(如網域名稱網站)建立、儲存和復原不同版本的配置,包括緩衝規則、認證、路由策略、邊緣函數等設定,實現配置變更的灰階發布、版本對比與快速復原,保障網站更新過程中的穩定性與可維護性。

alicloud_esa_video_processing:提供ESA視頻處理資源。支援在邊緣節點對視頻內容進行即時轉碼、截圖、浮水印、格式轉換、碼率自適應(如產生 HLS/DASH 分區)等操作。通過該資源,使用者可定義視頻處理模板或任務規則,結合加速網域名稱自動觸發視頻處理流程,在靠近使用者的位置完成輕量級ApsaraVideo for Media Processing,降低來源站點壓力,提升視頻載入速度與播放體驗。

alicloud_esa_waiting_room:提供 ESA 等候室資源。配置等待室,包含基於FIFO隊列的流量管控規則(活躍使用者上限、會話時間長度、多子域路徑配置),為突發流量情境提供預置的灰階管控能力。

alicloud_esa_waiting_room_event:提供 ESA 等候室事件資源。配置等待室及其事件規則,用於在需要時通過隊列管理機制FIFO控制突發流量,防止服務端過載。

alicloud_esa_waiting_room_rule:提供 ESA 等候室規則資源。基於規則對符合流量匹配條件的請求在突發高流量時自動啟用等待室機制進行排隊管控,從而有效防止伺服器過載。

安裝Terraform並配置許可權

在本地安裝和配置Terraform

您可以參考安裝和配置Terraform,在本地使用Terraform。

  • 由於阿里雲帳號(主帳號)擁有資源的所有許可權,其AccessKey一旦泄露風險巨大,所以建議您使用滿足最小化許可權需求的RAM使用者的AccessKey。具體操作方式請參見建立AccessKey

  • 建立環境變數,用於存放身份認證資訊。

    AccessKey管理頁面上建立和查看您的AccessKey。

    若無對應環境變數,在執行terraform模板時無法確認身份資訊,將會導致調用失敗。

使用線上服務(免安裝和許可權配置)

如果您不想安裝Terraform,可以直接使用線上服務Cloud Shell

阿里雲Cloud Shell是一款協助您營運的免費產品,預裝了Terraform的組件,並配置好身份憑證(Credentials)。因此您可直接在Cloud Shell中運行Terraform的命令。更多資訊,請參見Cloud Shell

重要

通過Cloud Shell使用Terraform時,由於其銷毀特性會導致資料丟失,因此建議您使用Cloud Shell做簡單、快速的操作,例如調試。更多使用限制,請參見使用限制

參考文檔

使用Terraform為ESA網站添加DNS記錄