在 Cloud Assembly 中建立雲端範本時,資源類型調色盤包括支援雲端帳戶的資源類型和整合端點。可能會出現需要根據資源類型的擴充清單建立雲端範本的使用案例。您可以建立自訂資源類型,將其新增至設計畫布,並建立支援您的設計和部署需求的雲端範本。
自訂資源名稱和資源類型
自訂資源名稱可在雲端範本資源類型調色盤中識別您的自訂資源。
自訂資源的資源類型必須以 Custom. 開頭,並且每個資源類型必須是唯一的。例如,您可以將 Custom.ADUser
設定為用於新增 Active Directory 使用者的自訂資源的資源類型。雖然文字方塊中未驗證是否包含 Custom.,但是如果您移除該字串,則會自動將其新增。
擴充性動作自訂資源
使用自訂資源類型,您可以在雲端範本中使用擴充性動作來建置複雜的應用程式。例如,可以使用擴充性動作與 Amazon Web Services 和 Microsoft Azure 的原生整合,以便輕鬆整合其各自的服務。可以透過按一下自訂資源編輯器中的依據選項,並選取 ABX 使用者定義的架構建立擴充性動作自訂資源。
擴充性動作自訂資源的生命週期動作
對自訂資源使用擴充性動作時,您可以定義以下生命週期動作:
- 建立:啟動部署時呼叫此擴充性動作。
- 讀取:使用此擴充性動作擷取已部署資源的最新狀態。
- 更新:更新雲端範本內容時呼叫此擴充性動作。只有在內容未標記為
recreateOnUpdate
時,才會觸發此動作。 - 銷毀:刪除部署時呼叫此擴充性動作。
可以從現有擴充性動作中手動選取這些生命週期動作,也可以透過選取產生動作自動產生這些動作。選取產生動作時,必須指定將在其中產生新擴充性動作的專案。
vRealize Orchestrator 自訂資源
Properties
、
Date
、
string
和
number
。
AD:UserGroup
是用於管理 Active Directory 使用者群組的 SDK 物件類型。
vRealize Orchestrator 自訂資源外部類型
外部類型內容定義了 vRealize Orchestrator 自訂資源的類型。在 Cloud Assembly 中,如果在自訂資源類型中選取「建立」工作流程,將在其下方顯示 [外部類型] 下拉式清單。下拉式清單中包括從 vRealize Orchestrator 工作流程的輸出參數中選取的外部類型內容。下拉式清單中包括的所選工作流程輸出內容必須是非陣列 SDK 物件類型,例如 VC:VirtualMachine
或 AD:UserGroup
。
DynamicTypesManager.getObject()
方法來定義其變數。
定義自訂資源類型時,還可以定義選取外部類型的可用性範圍。選取的外部類型可以:
- 在專案之間共用。
- 僅適用於選取的專案。
每個定義的範圍只能有一個具有特定外部類型值的自訂資源類型。例如,如果您在專案中建立使用 VC:VirtualMachine
作為外部類型的自訂資源,則無法為同一專案建立使用相同外部類型的其他自訂資源。同時,無法建立兩個使用相同外部類型的共用自訂資源。
vRealize Orchestrator 生命週期動作驗證
將「建立」、「刪除」和「更新」工作流程作為生命週期動作新增至自訂資源時,Cloud Assembly 會驗證所選工作流程是否具有正確的輸入和輸出內容定義。
- 「建立」工作流程的輸出參數必須為 SDK 物件類型,例如
SSH:Host
或SQL:Database
。如果選取的工作流程未通過驗證,則無法新增「更新」或「刪除」工作流程,也無法儲存對自訂資源的變更。 - 「刪除」工作流程的輸入參數必須為與自訂資源之外部類型相符的 SDK 物件類型。
- 「更新」工作流程的輸入和輸出參數必須為與自訂資源之外部類型相符的 SDK 物件類型。
自訂資源內容架構
domain
和
location
,則
讀取動作也必須傳回具有相同名稱的相同內容。
可以透過導覽至內容索引標籤,然後使用代碼或表單索引標籤,編輯自訂資源的內容架構。
- 代碼:使用 YAML 內容編輯內容架構。選取此選項時,使用 JSON 架構對內容架構進行定義。
- 表單:對於擴充性動作自訂資源,透過按一下新增內容並設定其名稱、顯示名稱、說明、內容類型和預設值,建立新內容。對於 vRealize Orchestrator 自訂資源,還可以透過按一下移除內容,在架構中隱藏非必要內容和非計算內容。
第 2 天作業自訂請求表單
您可以透過新增和修改不同類型的資源內容,簡化自訂資源中包含的第 2 天作業請求表單。
例如,可以將請求表單中輸入參數的值繫結到外部來源 (例如,用於擷取部署名稱或專案名稱的 vRealize Orchestrator 動作)。也可以將特定輸入參數的值繫結到相同請求表單中包含的其他兩個文字方塊的計算值。
第 2 天作業請求表單驗證
可以透過新增外部驗證對第 2 天作業的請求表單進行驗證。透過使用外部驗證,您可以阻止使用者在滿足驗證參數之前提交請求表單。可以從自訂資源或資源動作編輯器的請求參數頁面的驗證索引標籤新增外部驗證。選取該索引標籤後,可以將 Orchestrator 驗證元素拖曳至畫布中,並新增要用於驗證的 vRealize Orchestrator 動作。
例如,可以建立包含變更使用者密碼第 2 天作業的自訂資源。對於此類使用案例,可以新增具有使用 SecureString
類型之 newPassword
和 confirmPassword
輸入參數的 vRealize Orchestrator 動作。
if (newPassword != confirmPassword) { return 'passwords are different'; } if (newPassword.lenght < 7) { return 'password must be at least 10 symbols'; } return null;