全部產品
Search
文件中心

Cloud Architect Design Tools:模板變數配置

更新時間:May 27, 2026

定義模板變數

配置局部變數

  1. 我的解決方案頁面找到需要定義變數的模板,單擊編輯模板,此處以一個ECS模板為例。

  2. 雙擊產品表徵圖,開啟配置框,定義參數變數,支援定義變數的屬性都有標識fx

  3. 單擊右側fx彈出自訂變數對話方塊,配置項具體說明請見下表。

    屬性

    說明

    格式

    要求

    變數值

    設定變數名稱

    ${變數名稱}

    • “${}”為固定格式

    • “變數名稱”只能是大小寫字母、數字、中劃線或底線四種字元任意組成的字串。

    定位器

    設定在架構描述檔案中寫入的定位器格式

    ${變數名}加上字元組合(1-9,A-Z等)

    一般情況下與變數值保持一直,

    在使用全域變數時需要將全域變數的變數名添加到預留位置中。

    預設值

    用作變數的預設值,如果使用者不對變數賦值,則變數使用預設值。

    二級屬性值暫不支援配置預設值

  4. 這裡我們定義一下ECS屬性“數量”和“執行個體名稱”的變數,單擊右側fx設定自訂變數。例如,將變數名稱和預留位置均設定為 ${count},預設值設定為 1,然後單擊添加變數完成變數配置。例如,在變數名稱中填寫 ${instance_name}預留位置中填寫 ${instance_name}預設值中填寫 ecs,然後單擊添加變數完成配置。

重要

配置局部變數時,變數名稱與預留位置需要保持一致。

配置全域變數

說明

適用情境:全域變數可用於配置多類型、多節點執行個體之間添加相同變數的情境。例如:我們需要為下圖模板中的執行個體添加統一的名稱首碼或尾碼,此時我們就可以通過配置全域變數來解決當前問題。

ecs1

  1. 變數定義完成後,在我的解決方案頁面找到對應模板,單擊查看模板變數

  2. 點擊左上方的添加全域變數,配置方式與局部變數一致。在彈窗中配置自訂變數:變數類型選擇String變數名稱填寫${prefix}(格式為${變數名},僅支援大小寫字母、數字、中劃線、底線),預設值填寫prefix(可選,填寫後作為預設值填充),然後單擊添加變數。在彈出的 自訂變數 彈窗中,全域變數 地區顯示已定義的變數 ${prefix},變數類型為 String,預設值為 prefix。

  3. 修改局部變數,使用 -(中劃線)將全域變數拼接到局部變數的前端或後端,儲存配置。例如,將 ECS 執行個體名稱的變數名稱修改為 ${prefix}-${instance_name}預留位置修改為 ${prefix}-${instance_name},然後單擊添加變數完成配置。同理,將 Kafka 執行個體名稱的局部變數也修改為 ${prefix}-${kafka_name} 的拼接格式,單擊添加變數完成配置。

    重要

    由於全域變數不綁定具體資源屬性,所以沒有預留位置。全域變數給局部變數賦值時,全域變數和局部變數的資料類型必須相同。

  4. 基於模板建立後的執行個體名稱

ecs11kafka11

說明

上文中示範配置全域變數使用的-(中劃線)可用任一字元或字串替換(需滿足執行個體的命名規則),替換變數時會保留用於拼接的字元。

查看模板變數

  1. 變數定義完成後,在我的解決方案頁面找到對應模板,單擊查看模板變數

  2. 可以看到定義的模板變數詳情。

    • 變數名稱:定義的變數名稱。

    • 預設值:用作變數的預設值, 當使用者不對變數賦值時,變數使用預設值。

    • 變數類型:變數的資料類型,需要重點關注,與如何給變數賦值相關。

    • 預留位置:局部變數定義的預留位置。在自訂變數彈窗中,上方全域變數地區定義了變數 ${prefix}(類型 String,預設值 prefix)。下方自訂變數地區展示各資源變數,其中預留位置列通過引用全域變數實現名稱組合,例如 ${prefix}-${ecsName}${prefix}-${kafkaName}。自訂變數還包含RefId屬性名稱等欄位,用於關聯資源屬性。

刪除模板變數

刪除模板變數,有兩種操作方式:

  1. 在查看模板變數的對話方塊中刪除。在變數所在行的操作列,單擊刪除

  2. 在定義變數的對話方塊中刪除當前變數。單擊 刪除當前變數 按鈕即可刪除該變數。