FTP-Deploy-Action中dry-run模式的使用注意事项

在使用FTP-Deploy-Action进行文件部署时，开发者可能会遇到一个常见问题：日志显示部署成功但实际上服务器上没有任何文件更新。这种情况通常是由于配置中启用了dry-run（试运行）模式导致的。

dry-run模式是FTP-Deploy-Action提供的一个非常有用的功能，它允许开发者在实际部署前模拟整个部署过程。在这个模式下，系统会执行所有常规操作（如计算文件差异、生成同步状态等），但不会真正上传或修改服务器上的任何文件。这种模式特别适合在以下场景使用：

1. 测试部署配置是否正确
2. 验证文件过滤规则是否按预期工作
3. 检查将要上传的文件列表是否符合预期
4. 在正式部署前进行预演

从技术实现角度看，当dry-run设置为true时，FTP-Deploy-Action会：

• 正常计算本地文件和服务器文件的差异
• 生成完整的操作日志
• 创建同步状态文件
• 但跳过所有实际的FTP传输操作

要解决这个问题，开发者只需在配置文件中将dry-run参数设置为false或直接移除该参数（默认为false）。正确的配置示例如下：

- name: 同步文件
  uses: SamKirkland/FTP-Deploy-Action@v4.3.5
  with:
    server: ${{ secrets.FTP_SERVER }}
    username: ${{ secrets.FTP_USERNAME}}
    password: ${{ secrets.FTP_PASSWORD}}
    server-dir: testing.aecc.com.ph/

理解dry-run模式的工作原理对于高效使用FTP-Deploy-Action至关重要。它不仅是调试部署流程的有力工具，也能帮助开发者在正式部署前发现问题，避免不必要的错误。在实际开发中，建议先在dry-run模式下验证配置，确认无误后再进行实际部署。