BuildForge 可以搭配 Rational ClearCase 使用來管理原始碼。
這個主題說明整合 Rational ClearCase 時額外的設定需求,並彙總所提供之範例配接器範本的性質。
ClearCase 配接器範本範例提供了分析基準線變更的方法。一般而言,變更分析是用於省略建置:如果基準線元件未變更,則不會重建
ClearCase 配接器額外的設定需求
請參閱配接器需求以取得一般需求。除了滿足配接器的一般需求之外,請執行下列動作:
- 在可以連接至 ClearCase 伺服器的主機上安裝 Build Forge 代理程式。
- 在代理主機上安裝 ClearCase 完整用戶端。
- 設定代理程式的環境,以便透過 ClearCase 用戶端來執行指令。
- 決定所需 ClearCase 視圖的實作方式、啟動方式及啟動時間。提供的範本假設使用動態視圖,並且包含在執行 cleartool 指令時啟動該視圖。在代理主機上安裝 ClearCase 完整用戶端。

ClearCase 視圖
ClearCase 採用視圖作為供您存取資料的方法。您可以使用兩種類型的視圖:
- 動態視圖:動態視圖可讓您查看指定 VOB 中最新版本的元素,而無需將其複製到本端系統。必須啟動視圖。您還會指定要在視圖中裝載的 VOB。
- Snapshot 視圖:Snapshot 視圖是儲存庫副本。您可以指定要使用的物件版本。必須手動更新 Snapshot 視圖,以便取得已移入的最新項目。
- 動態視圖
- 只要您選擇查看的視圖環境定義中發生任何變更,動態視圖便會顯示持續更新的工作區。只有您移出的元素才會複製到工作區,且您必須將其移入,才能供其他使用者使用。使用動態視圖時,您會進行下列三項指定,以存取所需的資料:
- 視圖:定義要呈現的版本清單(透過配置規格)。必須使用指令來啟動視圖。在本端磁碟上,視圖表示為內容的根目錄。它也稱為起始視圖。常用的目錄如下所示:
- Windows:磁碟機 M:,共用磁碟機
- UNIX 或 Linux:/view,已裝載的檔案系統
- 視圖環境定義:透過視圖標籤來定義要使用的內容目錄。在 ClearCase 中可以定義視圖標籤。啟動視圖後,您即可使用此目錄。
- VOB(已版本化的物件庫):定義視圖環境定義的子目錄。在 ClearCase 中可以定義 VOB。您會在視圖環境定義中明確裝載 VOB。此子目錄包含已版本化的構件(原始檔及其他構件)。
本端機器上的 VOB 路徑由上述三個項目組成:
- Windows 系統的範例路徑(使用預設值):M:\view_tag\vob_name
- UNIX 及 Linux 系統的範例路徑(使用預設值):/view/view_tag/vob_name
- Snapshot 視圖
- 使用 Snapshot 視圖時,您會指定視圖環境定義,同時還必須載入資料。然後即會擁有您指定所有資料的本端副本。必須重新載入 Snapshot 視圖,以便取得自前次載入資料後移入的變更。
支援動態視圖的 Rational Build Forge 特性
您可以使用特殊環境變數,從 Build Forge 工作中定義及啟動動態視圖。
- CLEARCASE_VIEW
- 啟動指定的 ClearCase 視圖。這個變數中指定的視圖必須存在,而且使用這個變數的步驟必須設為 "absolute"。在執行 Microsoft Windows 的系統中,此變數必須搭配 bfagent.conf 中代理程式的 cc_suppress_server_root 參數來使用。
- _CLEARCASE_VIEWS
- 指定指令執行之前要啟動的 ClearCase 視圖清單。將此值設為以逗點區隔的視圖清單;例如,"View1,View2,View3"。
- _CLEARCASE_VOBS
- 指定指令執行之前要裝載的 ClearCase VOB 清單。將此值設為以逗點區隔的 VOB 清單;例如,"\Vob1,\Vob2,\Vob3"。
您可能還需要使用代理程式參數,來管理代理主機上的視圖。如果您搭配 ClearCase 使用的代理程式是在 Windows 系統上執行,則必須設定代理程式參數。當您要透過此代理程式使用的起始視圖,與工作所設定的起始視圖不相同時,這些代理程式參數也會很有用。如果您針對多個代理程式使用此工作,並且需要在每個代理主機系統上進行不同的指定,則會發生此情況。
- ccviewroot root-path
- 指定此主機的預設起始視圖。請參閱
ClearCase 文件,以取得 init 的詳細資訊。內部預設值如下所示:
- Windows 系統:ccviewroot M:
- UNIX 或 Linux 系統:ccviewroot /view
- cc_suppress_server_root
- 若已設定,請檢視路徑是 ccviewroot 所設定的路徑。若未設定,則在伺服器定義中所設定的路徑就會附加至 ccviewroot 所設定的路徑。此設定不需要值。如果已在 bfagent.conf 中出現,則表示已設定。
ClearCase 配接器範本範例
所提供的配接器範本範例如下所示。
- ClearCaseBaseline
- 在 ClearCase 視圖中掃描目錄。
- 將 ClearCase 所提出的分支與版本資訊寫入 BOM 報告中。
使用的變數:
- INT_STREAM
- VIEW
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- ClearCaseByBaselineActivities
- 從 ClearCase 視圖的內容建立新的基準線。
- 比較新的基準線與配接器前次執行時的基準線,以找出變更活動。
- 針對每次的變更活動,將下列資訊寫入 BOM 報告:活動、已變更的檔案、使用者、日期、註解與版本。
- 針對每個已變更的檔案,將變更詳細資料(從 diff 指令輸出)寫入 BOM 報告。
使用的變數:
- CurDate
- LAST_RUN
- BASELINE
- VIEW
- VOB_PATH
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- ClearCaseByBaselineVersions
- 從 ClearCase 視圖的內容建立新的基準線。
- 比較新的基準線與配接器前次執行時的基準線,以找出變更過的檔案。
- 針對每個已變更的檔案,將下列資訊寫入 BOM 報告:檔名、版本、日期、使用者與註解。
- 針對每個已變更的檔案,將變更詳細資料(從 diff 指令輸出)寫入 BOM 報告。
使用的變數:
- CurDate
- LAST_RUN
- LABEL
- BASELINE
- VIEW
- VOB_PATH
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- _CHAR_NATIVE
- ClearCaseByDate
- 在 ClearCase 視圖中,查詢兩個日期之間的變更。預設日期為現行時間戳記與配接器前次執行的時間戳記。
- 針對每個已變更的檔案,將下列資訊寫入 BOM 報告:檔名、版本、日期、使用者與註解。
- 針對每個已變更的檔案,將變更詳細資料(從 diff 指令輸出)寫入 BOM 報告。
使用的變數:
- CurDate
- LAST_RUN
- LABEL
- BASELINE
- VIEW
- VOB_PATH
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- _CHAR_NATIVE
- ClearCaseByLabel
- 建立新的標籤,並套用至 ClearCase 視圖的內容。
- 比較新的標籤與配接器前次執行時的標籤,以找出變更過的檔案。
- 針對每個已變更的檔案,將下列資訊寫入 BOM 報告:檔名、版本、日期、使用者與註解。
- 針對每個已變更的檔案,將變更詳細資料(從 diff 指令輸出)寫入 BOM 報告。
使用的變數:
- CurDate
- LAST_RUN
- LABEL
- BASELINE
- VIEW
- VOB_PATH
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- _CHAR_NATIVE
ClearCase 配接器變數
這份表格是配接器範本之變數清單的參照。
環境變數名稱 |
說明 |
BASELINE |
如果是使用 ByBaseline 配接器,當您根據基準線以配接器產生差異時,系統會將此值作為基準線使用。 |
CCSERVER |
將這個變數設為已安裝 ClearCase 用戶端和 Build Forge 代理程式的主機名稱。 |
CurDate |
使用 .date 指令產生 ClearCase 預期格式的日期,來提供現行日期給配接器。請勿變更此值。 |
LABEL |
如果是使用 ByLabel 配接器,當您根據標籤以配接器產生差異時(使用 ByLabel 配接器),系統會將此值作為標籤使用。 |
LAST_RUN |
若為 ByDate 配接器,系統會使用此值來判斷是否發生任何變更;此值是前次順利執行的日期。您可以在測試配接器時操作此值,挑選在某些變更發生之前的日期,以強迫配接器執行。如果配接器容許繼續執行,它會自動將此值更新為現行日期。預設值為 1-Jan-05.00:00:00。 |
PROJECT_VOB |
當您使用 ByBaseline 配接器時,請將這個變數設為 VOB 專案的名稱(只能與 UCM ClearCase 搭配使用)。範例:\ProjectVob |
UNIXCLIENT |
用來設定平台專用的資訊。如果用戶端是在 Windows 上執行,請設為 0。如果用戶端是在 UNIX 或 Linux 上執行,請設為 1。 |
VIEW |
將這個變數設為您要搭配配接器使用的 ClearCase 視圖名稱。 |
VOB_PATH |
將這個值設為元件 VOB 的名稱及其子目錄(後者為選用)。請使用逗點區隔的清單來指定多個名稱。 |
_CHAR_NATIVE |
供內部使用且一律設為 1。 |
下列觸發變數也可用來啟動視圖並裝載 VOB。不過,其與配接器變數中設定的視圖和 VOB 無關。
- CLEARCASE_VIEW
- _CLEARCASE_VIEWS
- _CLEARCASE_VOBS
請參閱觸發變數參照。