peterdavehello/azcopy

Docker-AzCopy 镜像文档

一、镜像概述

Docker-AzCopy 是一个基于 Alpine Linux 的轻量级 Docker 镜像，预装了 Azure AzCopy 工具。AzCopy 是 Azure 官方提供的命令行数据传输工具，用于在本地存储与 Azure 存储服务（如 Blob、File Storage 等）之间高效传输文件。本镜像提供多版本 AzCopy 支持，可直接集成到 CI/CD 工作流，简化 Azure 存储数据传输的容器化部署。

二、核心功能与特性

• 轻量级基础：基于 Alpine Linux 构建，镜像体积小，资源占用低。
• 多版本支持：镜像标签与 AzCopy 官方版本一一对应，支持指定具体版本、短版本（如 10）及 latest 标签。
• 多仓库分发：镜像同时发布至 Docker Hub 和 GitHub Container Registry（GHCR），可按需选择拉取源。
• CI/CD 友好：支持非交互式运行，易于集成到自动化流水线中执行数据传输任务。

三、使用场景

• CI/CD 工作流：在自动化构建流程中，将构建产物（如静态网站、应用包）同步至 Azure Blob Storage。
• 本地与 Azure 存储交互：通过容器化方式快速上传/下载本地文件至 Azure 存储，避免本地安装 AzCopy。
• 跨环境数据迁移：在不同环境（开发/测试/生产）中统一使用标准化的 AzCopy 版本执行数据迁移任务。

四、镜像仓库

本镜像同时推送至以下仓库，可根据网络环境或偏好选择：

4.1 GitHub Container Registry（GHCR）

• 镜像名称：ghcr.io/peterdavehello/azcopy
• 仓库地址：https://github.com/PeterDaveHello/azcopy/pkgs/container/azcopy

4.2 Docker Hub

• 镜像名称：peterdavehello/azcopy
• 仓库地址：https://hub.docker.com/r/peterdavehello/azcopy

提示：使用 GHCR 时需添加前缀 ghcr.io/，例如 ghcr.io/peterdavehello/azcopy:10.11.0。

五、版本说明

5.1 标签规则

镜像标签与 https://github.com/Azure/azure-storage-azcopy/releases 对应，标签名不含版本号前缀 v。例如：

• AzCopy 版本 v10.11.0 对应镜像标签 10.11.0。

5.2 特殊标签

• latest：对应最新稳定版 AzCopy。
• 短版本标签：仅包含主版本号（如 10），自动指向该主版本下的最新次版本（如 10.x.y）。

5.3 版本查询

有效标签可通过以下途径查看：

• Docker Hub 标签页：https://hub.docker.com/r/peterdavehello/azcopy/tags
• GHCR 版本页：https://github.com/PeterDaveHello/azcopy/pkgs/container/azcopy

六、使用方法

6.1 基本命令格式

bash
docker run --rm -it \
  -v /本地路径:/容器内路径 \  # 挂载本地目录至容器，供 AzCopy 访问文件
  peterdavehello/azcopy[:<版本标签>] \  # 镜像名及可选版本标签
  azcopy [命令] [参数]  # AzCopy 命令及参数

参数说明：

• --rm：容器退出后自动删除。
• -it：交互式终端（如需手动输入 AzCopy 命令或授权信息）。
• -v /本地路径:/容器内路径：必须项，挂载本地文件目录至容器，确保 AzCopy 可读取/写入文件。

6.2 查看 AzCopy 版本

bash
docker run --rm peterdavehello/azcopy:10.11.0 azcopy --version

输出示例：

azcopy version 10.11.0

6.3 示例：同步本地文件至 Azure Blob Storage

将本地 ./src 目录同步至 Azure Blob 容器 $web（静态网站托管容器）：

bash
docker run --rm -it \
  -v $PWD/src:/src \  # 挂载当前目录下的 src 至容器内 /src
  peterdavehello/azcopy:10.11.0 \
  azcopy sync /src https://azcopydockertest.blob.core.windows.net/$web

注：执行前需确保已通过 azcopy login 完成 Azure 授权（可在交互式模式下执行），或使用 SAS 令牌直接授权（如 https://<storage-account>.blob.core.windows.net/<container>?<sas-token>）。

七、部署示例

7.1 CI/CD 集成示例（GitLab CI）

在 .gitlab-ci.yml 中添加任务，将构建产物同步至 Azure：

yaml
deploy_to_azure:
  stage: deploy
  image: peterdavehello/azcopy:10
  script:
    - azcopy sync ./dist https://myaccount.blob.core.windows.net/mycontainer?$SAS_TOKEN --delete-destination true
  only:
    - main

7.2 Docker Compose 配置（示例）

创建 docker-compose.yml，定义 AzCopy 服务（适用于需持久化配置的场景）：

yaml
version: '3'
services:
  azcopy:
    image: peterdavehello/azcopy:10
    volumes:
      - ./local-data:/data  # 挂载本地数据目录
    command: sync /data https://myaccount.blob.core.windows.net/mycontainer?$SAS_TOKEN

执行：

bash
SAS_TOKEN="your-sas-token" docker-compose up

参考链接

• https://github.com/Azure/azure-storage-azcopy/#readme
• https://hub.docker.com/r/peterdavehello/azcopy
• https://github.com/PeterDaveHello/azcopy/pkgs/container/azcopy