建立元件

通常,所有元件的元件建立方式都相同。

關於這項作業

當您建立元件時,完成下列步驟:

  1. 定義來源類型。

    命名元件,指定代理程式以匯入構件,並識別構件類型及其位置。來源構件可以來自檔案系統、原始碼管理系統(例如 Subversion)或者另一個來源類型外掛程式。元件可以包含任何數目的構件,但必須全部具有相同的來源類型。

  2. 組合程序。

    程序會定義 IBM® UrbanCode Deploy 對元件構件執行的動作。程序可能包含任何數目的步驟,例如停止和啟動伺服器以及移動檔案。除了部署之外,其他程序可以匯入構件,並執行各種公用程式作業。

元件包含單一來源類型的構件,以及一個以上程序。除了手動建立元件之外,您可以使用範本來建立一個(請參閱元件範本),也可以直接匯入元件(請參閱匯入元件)。

程序

  1. 在「元件」頁面上,按一下建立新的元件 針對每個來源,「建立新的元件」視窗中的數個欄位都相同,而其他欄位則取決於使用來源配置類型欄位選取的來源類型外掛程式。
    「建立新的元件」視窗
  2. 定義標準參數。 下表中的欄位可用於每種來源類型。如果您在來源配置類型欄位中選取一個來源外掛程式,則還會顯示特定於所選取類型的欄位。
    表 1. 可用於所有來源類型的欄位
    欄位 說明
    名稱 識別元件。這個欄位的值包括在許多使用者介面特性中。
    說明 說明可用來傳送元件的更多相關資訊。如果多個應用程式使用元件,例如,輸入在應用程式 A 與 B 中使用可協助識別如何使用元件。
    團隊 用於管理元件的團隊。先前定義的團隊與角色可用。如需團隊的相關資訊,請參閱Security
    範本

    元件範本可讓您重複使用元件定義。基於範本的元件會繼承範本的來源配置、內容及程序。系統會列出先前建立的範本。元件可以具有與其相關聯的單一範本。預設值為「」。

    如果您選取範本,則會顯示用來選取範本版本的範本版本欄位。透過控制版本,您可以根據需要實施範本變更。預設值是最新版本,表示元件使用最新版本(依建立日期)。請參閱元件範本

    註: 如果您選取包括來源類型的範本,則對話框會變更,以反映為範本定義的值。包括來源配置類型欄位在內的數個欄位變為已移入且已鎖定。
    元件類型 識別元件是否基於 IBM z/OS® 構件。 如果您選取 z/OS,則無法使用來源配置控制項。儲存在 z/OS 中的構件不使用來源配置。如果要進一步瞭解配置和部署 z/OS 元件,請參閱部署至 z/OS 平台
    來源配置類型 定義元件構件的來源類型。所有構件都必須具有相同的來源類型。選取外掛程式會顯示與外掛程式相關聯的其他欄位。來源相關欄位用來識別並配置元件的構件。如果您選取一個範本,則這個欄位會鎖定,且其值繼承自範本。

    如需建立特定類型元件的相關資訊,請參閱從檔案系統建立元件從建置整合工具中建立元件從原始碼管理系統建立元件

    自動匯入版本 如果選取,則會定期輪詢來源位置是否有新的版本。系統會自動匯入找到的版本。預設輪詢期間是 15 秒,可以使用「系統設定」窗格變更該項目。如果保持未勾選,則可以透過使用「版本」窗格來手動建立版本。依預設,不勾選該方框。
    複製到 CodeStation 建立構件的防竄改副本,並將它們儲存在內嵌的構件管理系統 CodeStation 中。如果未勾選,則只會匯入構件相關 meta 資料。在大部分情況下,選取此勾選框。
    預設版本類型 定義如何將版本匯入至 CodeStation。「完整」值表示版本是綜合性的,且包含所有構件。「增量」值表示版本包含元件構件子集。預設值為「完整」。
    使用系統的預設版本匯入代理程式/標籤 如果選取,則您在「系統設定」頁面上指定的代理程式或標籤用來匯入元件構件。代理程式或含標籤的代理程式必須具有對構件所在系統的存取權。請參閱System settings
    使用單一代理程式匯入新的元件版本 如果選取,請使用版本匯入項目的代理程式欄位,來指定將構件匯入至元件的代理程式。代理程式必須具有對構件所在之系統的存取權。若要從伺服器位置匯入構件,請將代理程式安裝在相同的位置,並指定該代理程式。
    使用任何含指定標籤的代理程式匯入新的元件版本 如果選取,請使用版本匯入項目的代理程式標籤欄位,來指定用來識別可以將構件匯入至元件之代理程式的標籤。含標籤的代理程式必須具有對構件所位於之系統的存取權。
    繼承清除設定 判定在 CodeStation 中保存的元件版本數目,以及它們的保存時間。如果選取,則元件會使用「系統設定」窗格上的值。如果清除此欄位,則會顯示保存版本的天數(最初設為 -1,表示無限保存)及要保存的版本數目(最初設為 -1,表示全部保存)欄位。使用此選項,您可以定義自訂值。依預設,選取該勾選框。
    在建立新版本之後執行程序 如果選取此選項,則指定的應用程式程序在每次建立新元件版本時選取的環境中執行。
  3. 如果您選取來源類型外掛程式,請將值輸入至來源特定欄位中。

    如需建立特定類型元件的相關資訊,請參閱從檔案系統建立元件從建置整合工具中建立元件從原始碼管理系統建立元件

  4. 完成時,儲存您的工作。儲存的元件列在「元件」窗格中。

意見