SourceOffSite 任務使用者手冊

作者

版本 1.1 2002/01/23

目錄

簡介

這些任務提供介面連接 Microsoft Visual SourceSafe SCM，透過 SourceGear 的 SourceOffSite 產品。SourceOffSite 是 Microsoft VSS 的附加元件，允許遠端開發團隊和遠距上班者透過任何 TCP/IP 連線快速且安全地讀取/寫入集中式 SourceSafe 資料庫。SOS 提供 Linux、Solaris 和 Windows 用戶端。org.apache.tools.ant.taskdefs.optional.sos 套件包含一個簡單的架構，支援 SOS 功能，以及一些封裝常用 SOS 指令的 Apache Ant 任務。雖然可以在桌面上使用這些指令，但它們主要用於自動化建置系統。這些任務已使用 SourceOffSite 版本 3.5.1 進行測試，連線至 VisualSourceSafe 6.0。這些任務已使用 Linux、Solaris 和 Windows 2000 進行測試。

任務

sosget 擷取指定專案或檔案的唯讀副本。
soslabel 指定標籤給指定的專案。
soscheckin 使用已簽出的檔案或專案所做的變更更新 VSS，並解除 VSS 主副本的鎖定。
soscheckout 擷取指定專案或檔案的讀寫副本，並鎖定 VSS 主副本

任務說明

SOSGet

說明

使用 SOS 執行 Get 指令的任務

參數

屬性 值 必要
soscmd 包含 soscmd(.exe) 的目錄 否；預設情況下，可執行檔必須在路徑中
vssserverpath 前往 srcsafe.ini 的路徑，例如 \\server\vss\srcsafe.ini 是
sosserverpath SOS 伺服器的位址和埠，例如 192.168.0.1:8888 是
projectpath SourceSafe 專案路徑，例如 $/SourceRoot/Project1 是
file 要執行的檔案名稱 否；預設情況下，對專案執行動作
username SourceSafe 使用者名稱 是
password SourceSafe 密碼 否
localpath 覆寫工作目錄並取得指定的路徑 否
soshome SourceOffSite 主目錄的路徑 否
nocompress true|false—停用壓縮 否
recursive true|false—僅適用於 GetProject 指令 否
version 要取得的版本號碼—僅適用於 GetFile 指令 否
label 要取得的標籤版本—僅適用於 GetProject 指令 否
nocache true|false—僅在將 SOSHOME 設定為環境變數時需要 否
verbose true|false—顯示狀態訊息 否

範例

使用 build、build 作為使用者名稱和密碼，連線到 192.168.10.6:8888 上的 SourceOffsite 伺服器。SourceSafe 資料庫與 SOS 伺服器位於同一台電腦，而 VSS 資料庫位於 d:\vss\srcsafe.ini。使用 tmp 作為工作目錄，對 $/SourceRoot/project1 執行遞迴 GetProject。

<sosget verbose="true"
        recursive="true"
        username="build"
        password="build"
        localpath="tmp"
        projectpath="$/SourceRoot/project1"
        sosserverpath="192.168.10.6:8888"
        vssserverpath="d:\vss\srcsafe.ini"/>

SOSLabel

說明

使用 SOS 執行 Label 指令的任務

參數

屬性 值 必要
soscmd 包含 soscmd(.exe) 的目錄 否；預設情況下，可執行檔必須在路徑中
vssserverpath 前往 srcsafe.ini 的路徑，例如 \\server\vss\srcsafe.ini 是
sosserverpath SOS 伺服器的位址和埠號—例如 192.168.0.1:8888 是
projectpath SourceSafe 專案路徑，例如 $/SourceRoot/Project1 是
username SourceSafe 使用者名稱 是
password SourceSafe 密碼 否
label 要套用至專案的標籤 是
comment 要套用至所有已標籤檔案的註解 否
verbose true|false—顯示狀態訊息 否

範例

使用 build、build 作為使用者名稱和密碼，連線到 192.168.10.6:8888 上的 SourceOffsite 伺服器。SourceSafe 資料庫與 SOS 伺服器位於同一台電腦，而 VSS 資料庫位於 d:\vss\srcsafe.ini。使用 test label 標籤 $/SourceRoot/project1 專案。

<soslabel username="build"
          password="build"
          label="test label"
          projectpath="$/SourceRoot/project1"
          sosserverpath="192.168.10.6:8888"
          vssserverpath="d:\vss\srcsafe.ini"/>

SOSCheckIn

說明

使用 SOS 執行 CheckIn 指令的任務

參數

屬性 值 必要
soscmd 包含 soscmd(.exe) 的目錄 否；預設情況下，可執行檔必須在路徑中
vssserverpath 前往 srcsafe.ini 的路徑，例如 \\server\vss\srcsafe.ini 是
sosserverpath SOS 伺服器的位址和埠號—例如 192.168.0.1:8888 是
projectpath SourceSafe 專案路徑，例如 $/SourceRoot/Project1 是
file 要執行的檔案名稱 否；預設情況下，對專案執行動作
username SourceSafe 使用者名稱 是
password SourceSafe 密碼 否
localpath 覆寫工作目錄並取得指定的路徑 否
soshome SourceOffSite 主目錄的路徑 否
nocompress true|false—停用壓縮 否
recursive true|false—僅適用於 CheckOutProject 指令 否
nocache true|false—僅在將 SOSHOME 設定為環境變數時需要 否
verbose true|false—顯示狀態訊息 否
comment 要套用至所有已簽入檔案的註解 否

範例

使用 build、build 作為使用者名稱和密碼，連線到 server1:8888 上的 SourceOffsite 伺服器。SourceSafe 資料庫位於不同的電腦 (server2)，而 VSS 資料庫位於稱為 vss 的共用資料夾。僅簽入 foobar.txt 檔案，並新增註解 comment abc。額外的狀態訊息將顯示在螢幕上。

<soscheckin username="build"
            password="build"
            file="foobar.txt"
            verbose="true"
            comment="comment abc"
            projectpath="$/SourceRoot/project1"
            sosserverpath="server1:8888"
            vssserverpath="\\server2\vss\srcsafe.ini"/>

SOSCheckOut

說明

使用 SOS 執行 CheckOut 指令的任務

參數

屬性 值 必要
soscmd 包含 soscmd(.exe) 的目錄 否；預設情況下，可執行檔必須在路徑中
vssserverpath 前往 srcsafe.ini 的路徑，例如 \\server\vss\srcsafe.ini 是
sosserverpath SOS 伺服器的位址和埠號—例如 192.168.0.1:8888 是
projectpath SourceSafe 專案路徑，例如 $/SourceRoot/Project1 是
file 要執行的檔案名稱 否；預設情況下，對專案執行動作
username SourceSafe 使用者名稱 是
password SourceSafe 密碼 否
localpath 覆寫工作目錄並取得指定的路徑 否
soshome SourceOffSite 主目錄的路徑 否
nocompress true|false—停用壓縮 否
recursive true|false—僅適用於 CheckOutProject 指令 否
nocache true|false—僅在將 SOSHOME 設定為環境變數時需要 否
verbose true|false—顯示狀態訊息 否

範例

使用 build、build 作為使用者名稱和密碼，連線到 server1:8888 上的 SourceOffsite 伺服器。SourceSafe 資料庫位於不同的電腦 (server2)，而 VSS 資料庫位於稱為 vss 的共用資料夾。簽出 project1，由於未設定遞迴選項，因此僅會鎖定 project1 目錄。額外的狀態訊息將顯示在螢幕上。要使用的 soscmd(.exe) 檔案位於 /usr/local/bin。

<soscheckout soscmd="/usr/local/bin"
             verbose="true"
             username="build"
             password="build"
             projectpath="$/SourceRoot/project1"
             sosserverpath="192.168.10.6:8888"
             vssserverpath="\\server2\vss\srcsafe.ini"/>