Ant + Eclipse 企業級部署自動化：多環境配置、CVS 檢出、條件打包與報告

針對多人協作、多環境（開發/測試/生產）部署痛點，利用 Ant 屬性文件隔離差異、Eclipse 強大編輯器提效，構建「一次編譯、多環境打包」的標準化流水線。

痛點場景

• 測試代碼/頁面需手動刪除
• 配置文件（Log4j 路徑、資料源等）散落各處，手動修改易出錯
• 頻繁重複「檢出→改配置→打包」動作，效率低且版本易不一致

解決方案架構

build.xml          # 編譯階段：CVS 檢出、編譯、產出基準 WAR
deploy.xml         # 部署階段：解壓 WAR → 環境屬性替換 → 條件刪除 → 重打包
deploy.properties  # 當前目標環境屬性（由三環境模板複製而來）
develop_deploy.properties
test_deploy.properties
product_deploy.properties

Eclipse Ant 編輯器效能功能

• 語法高亮、錯誤提示、代碼折疊
• Ctrl+Click 跳轉 target/property 定義
• Alt+Shift+R 重構屬性/目標名稱（全工程同步）
• 斷點調試：變量觀察、單步執行、調用堆疊

核心技術實現

1. 屬性文件分層

<property file="deploy.properties"/>  <!-- 統一入口 -->
<!-- deploy.properties 內容示例 -->
log4j.appender.FILE.File=/var/log/app.log
datasource.url=jdbc:mysql://prod-db:3306/app
deploy.isTestEnv=false

2. Filter 任務替換佔位符

<filter filtersfile="deploy_env.properties"/>
<copy todir="${unpack.dir}" filtering="true">
  <fileset dir="${unpack.dir}"/>
</copy>

deploy_env.properties：

@log4j.path@=/var/log/app.log
@db.url@=jdbc:mysql://prod-db:3306/app

源文件中寫 @log4j.path@，複製時自動替換。

3. Replaceregexp 正則替換多行

<replaceregexp byline="false">
  <regexp pattern="<param-name>log4j.path</param-name>\s*<param-value>.*?</param-value>"/>
  <substitution expression="<param-name>log4j.path</param-name><param-value>${log4j.path}</param-value>"/>
  <fileset dir="${unpack.dir}/WEB-INF" includes="web.xml"/>
</replaceregexp>

4. 條件判斷刪除測試代碼

<target name="checkEnv">
  <condition property="isTestEnv">
    <istrue value="${deploy.isTestEnv}"/>
  </condition>
  <antcall target="removeTestCode"/>
  <antcall target="keepTestCode"/>
</target>
<target name="removeTestCode" if="isTestEnv"> <!-- 刪除測試 Servlet/頁面 --> </target>
<target name="keepTestCode" unless="isTestEnv"> <!-- 生產環境保留 --> </target>

5. CVS 自動檢出

<cvs cvsRoot="${cvs.root}" package="${cvs.project}" tag="${cvs.tag}" dest="${src.dir}" failonerror="true"/>

需將 cvs.exe 加入系統 PATH。

6. 解壓/重打包 WAR

<unzip src="${base.war}" dest="${unpack.dir}"/>
<war destfile="${target.dir}/app.war" basedir="${unpack.dir}"
     webxml="${unpack.dir}/WEB-INF/web.xml"
     manifest="${unpack.dir}/META-INF/MANIFEST.MF"/>

執行流程

1. 開發/測試階段：運行 build.xml 產出基準 WAR
2. 部署階段：複製對應環境屬性文件為 deploy.properties → 運行 deploy.xml
3. 命令列：ant -f deploy.xml 或 Eclipse 右鍵 Run As → Ant Build

關鍵收益

• 版本一致性：同一基準 WAR 衍生多環境包，消除重複檢出導致的代碼漂移
• 零手工修改：所有差異集中在屬性文件，部署零手工操作
• 可追溯：屬性文件納入版控，環境配置歷史可查
• 擴展性：新增環境只需新增屬性模板

配套完整 build.xml、deploy.xml、屬性模板源碼已整理，可直接落地專案。