GitHub工作流中如何实现同一Azure存储账户内的文件夹复制

架构老林

2026-8-29

方案选型结论

直接选AzCopy，不优先用az storage的批量复制命令，核心原因：

az storage blob copy start-batch默认是异步提交任务，命令执行完就返回，复制操作在Azure存储服务端后台运行，默认拿不到实时进度。就算加等待参数，它的进度反馈非常粗糙，大批量文件复制场景下可能十几分钟没有日志输出，很容易触发GitHub Actions的60秒无输出超时规则，导致任务被强制终止。
AzCopy是专门为Blob传输场景开发的工具，同存储账户内复制走服务端直传，不占用Action运行器的本地公网带宽，命令默认同步阻塞执行，实时输出每个文件的复制状态、整体进度、传输速率，GitHub日志可以完整跟踪整个执行过程，自带错误重试机制，稳定性远高于az cli的存储相关命令。

GitHub Actions 配置步骤

不需要找第三方封装的AzCopy Action，用微软官方维护的Azure登录Action即可，uses字段直接填azure/login@v2。GitHub官方托管的运行器默认预装了AzCopy，如果是自托管运行器，只需要提前把AzCopy安装后加入系统PATH就能直接调用。
具体配置分两步：

配置Azure授权
提前创建对应存储账户的服务主体，给服务主体分配目标存储账户的存储Blob数据参与者权限，把服务主体的JSON凭证存在仓库的Secrets中，命名为AZURE_CREDENTIALS，然后在工作流中加入登录步骤：
```
- name: 登录Azure
  uses: azure/login@v2
  with:
    creds: ${{ secrets.AZURE_CREDENTIALS }}
```
注意：不要用存储账户密钥做硬编码授权，权限粒度过粗存在安全风险。

执行同步复制
登录步骤执行完成后，AzCopy会自动注入授权上下文，不需要额外执行azcopy login命令，直接写复制逻辑即可。命令会同步阻塞直到所有任务完成，GitHub Action会等复制全部结束后才会执行后续步骤：

- name: 同账户跨文件夹复制Blob
  shell: bash
  run: |
    azcopy copy \
      "https://<你的存储账户名>.blob.core.windows.net/<源容器名>/<源文件夹路径>/*" \
      "https://<你的存储账户名>.blob.core.windows.net/<目标容器名>/<目标文件夹路径>/" \
      --recursive=true \
      --overwrite=ifSourceNewer

如果需要目标文件夹和源文件夹完全一致（自动删除目标文件夹中源端不存在的文件），把上面命令里的azcopy copy替换为azcopy sync即可，参数逻辑保持一致。
如果遇到超大文件复制长时间没有输出的情况，可以追加--log-level=INFO参数，工具会定期输出心跳日志，避免触发Action的无输出超时。

备选：强制使用az storage命令的配置方式

如果受环境限制必须用az cli，记得给批量复制命令加--wait-until-complete参数，强制命令同步等待所有复制任务完成，不要使用默认的异步模式：

az storage blob copy start-batch \
  --source-container <源容器名> \
  --source-path <源文件夹路径> \
  --destination-container <目标容器名> \
  --destination-path <目标文件夹路径> \
  --account-name <存储账户名> \
  --auth-mode login \
  --wait-until-complete

该方案的缺陷很明确：进度反馈差、无内置重试、容易触发超时，非必要不选择。

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