如何通过Azure DevOps经典UI集成JFrog Artifactory与XLDeploy并部署War包

一、先搞定XLDeploy的基础准备 #

• 拿到XLDeploy核心信息：找运维要XLDeploy的服务器地址（比如http://xld-server:4516）、有权限部署的账号密码，确认目标环境（比如测试/预发）和对应的应用服务器（比如Tomcat）已经在XLDeploy里配置好。
• 验证网络连通：从你的CI/CD服务器（比如GitHub Actions runner、Jenkins节点）ping XLDeploy服务器，确保端口4516（默认）没被防火墙挡住。
• 提前在XLDeploy中创建对应环境：比如在XLDeploy里新建test-environment，关联已配置好的Tomcat服务器，避免部署时找不到目标。

二、用GitHub Actions集成XLDeploy（适配GitHub Enterprise） #

因为你用的是GitHub Enterprise，直接用GitHub Actions完成部署最顺手，步骤如下：

1. 配置敏感信息：在仓库的Settings > Secrets and variables > Actions里添加以下Secrets：
   • XLDEPLOY_URL：XLDeploy服务器地址
   • XLDEPLOY_USER：XLDeploy部署账号
   • XLDEPLOY_PASSWORD：XLDeploy账号密码
   • ARTIFACTORY_USER：Artifactory读取账号
   • ARTIFACTORY_PASSWORD：Artifactory账号密码
2. 编写部署步骤：在你的CI配置文件（比如.github/workflows/build-deploy.yml）里，在Artifactory上传步骤之后添加XLDeploy部署步骤：

   - name: Install XLDeploy CLI
     run: |
       wget https://download.xebialabs.com/xl-deploy/10.1.0/xl-deploy-cli-10.1.0-server.zip
       unzip xl-deploy-cli-10.1.0-server.zip
       export PATH=$PATH:./xl-deploy-cli-10.1.0/bin
   
   - name: Login to XLDeploy
     run: xl login -u ${{ secrets.XLDEPLOY_USER }} -p ${{ secrets.XLDEPLOY_PASSWORD }} -url ${{ secrets.XLDEPLOY_URL }}
   
   - name: Import War from Artifactory to XLDeploy
     run: |
       xl import --url "https://your-artifactory-url/repo-name/com/yourcompany/yourapp/${{ env.APP_VERSION }}/yourapp-${{ env.APP_VERSION }}.war" \
       --username ${{ secrets.ARTIFACTORY_USER }} \
       --password ${{ secrets.ARTIFACTORY_PASSWORD }} \
       --name "yourapp" \
       --version "${{ env.APP_VERSION }}" \
       --type "tomcat.War"
       # 注意替换你的Artifactory地址、仓库名、包路径，APP_VERSION可以从Maven构建步骤中传递
   
   - name: Deploy to XLDeploy Environment
     run: xl deploy --application "yourapp" --version "${{ env.APP_VERSION }}" --environment "test-environment" --force
   

   说明：tomcat.War是XLDeploy针对Tomcat War包的内置类型，如果你的应用服务器是其他类型（比如Jetty），换成对应的类型即可。

三、如果用Jenkins集成的简化步骤 #

如果你的CI工具是Jenkins，操作更直观：

• 安装XLDeploy Jenkins插件：在Jenkins插件市场搜索XL Deploy Plugin并安装。
• 配置XLDeploy服务器：进入Jenkins系统管理 > 系统配置，找到XLDeploy部分，添加服务器地址、账号密码并测试连接。
• 添加部署任务：在构建流水线的Post-build Actions里选择XL Deploy: Deploy a package，配置应用名、版本、目标环境，选择从Artifactory拉取War包的路径即可。

四、新手常见坑排查 #

• 连接XLDeploy失败：先确认账号密码是否正确，CI服务器和XLDeploy之间的防火墙是否开放端口，账号是否有deploy权限。
• War包拉取失败：检查Artifactory的路径是否正确，账号是否有读取该仓库的权限，CI服务器能否访问Artifactory地址。
• 部署后应用不启动：检查XLDeploy里的应用服务器配置（比如Tomcat的端口、部署目录），War包是否兼容该服务器版本，查看XLDeploy的部署日志定位问题。

内容的提问来源于stack exchange，提问作者Rahul Deb