plugins/docker

drone-docker

镜像概述和主要用途

drone-docker是Drone CI的官方Docker插件，用于将Docker镜像的构建和推送步骤集成到Drone CI/CD流程中。该插件由https://github.com/drone-plugins/drone-docker%E9%A1%B9%E7%9B%AE%E7%BB%B4%E6%8A%A4%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87Drone CI自身构建和推送，确保与Drone CI生态的兼容性和稳定性。其核心用途是简化Drone CI用户在自动化流程中对Docker镜像的构建、标记和推送操作。

核心功能和特性

• Drone CI无缝集成：作为Drone CI的原生插件，可直接在Drone pipeline中配置，无需额外适配
• Docker镜像构建：支持基于Dockerfile构建Docker镜像，兼容多阶段构建等Docker特性
• 镜像推送能力：支持将构建后的镜像推送到Docker Hub、私有仓库等主流容器镜像仓库
• 配置灵活性：通过环境变量或Drone secrets管理敏感信息（如仓库认证），支持自定义镜像标签、仓库地址等参数

使用场景和适用范围

适用于所有使用Drone CI作为持续集成/持续部署工具的开发团队，特别是需要在CI/CD流程中包含Docker镜像构建和推送步骤的场景，例如：

• 应用程序发布前自动构建镜像并推送到私有仓库
• 多环境部署（开发、测试、生产）中根据分支或标签生成差异化镜像标签
• 开源项目通过Drone CI自动构建并推送镜像到公共仓库（如Docker Hub）

使用方法和配置说明

基本配置示例（drone.yml）

在Drone pipeline中添加以下步骤即可使用：

yaml
steps:
  - name: build-and-push-docker-image
    image: docker.xuanyuan.run/plugins/docker
    settings:
      # Docker仓库地址（默认为Docker Hub，私有仓库需指定完整URL）
      repo: my-registry.example.com/my-app
      # 镜像标签（支持多个标签，用逗号分隔）
      tags: latest,${DRONE_COMMIT_SHA:0:8}
      # 仓库认证信息（建议通过Drone secrets管理，避免明文）
      username: 
        from_secret: docker_username
      password: 
        from_secret: docker_password
      # 可选：指定Dockerfile路径（默认为当前目录Dockerfile）
      dockerfile: ./path/to/Dockerfile
      # 可选：构建参数
      build_args:
        - APP_VERSION=${DRONE_TAG}

关键配置参数

环境变量支持

插件支持通过环境变量覆盖部分配置，常用变量包括：

• DOCKER_REGISTRY：覆盖repo中的仓库域名
• DOCKER_USERNAME：覆盖username配置
• DOCKER_PASSWORD：覆盖password配置
• DOCKER_TAGS：覆盖tags配置

注意事项

• 确保Drone Runner环境已安装Docker且有权限执行docker命令
• 敏感信息（如仓库密码）必须通过Drone secrets存储，通过from_secret引用
• 多平台构建需额外配置platforms参数（如linux/amd64,linux/arm64）
• 推送镜像前需确保目标仓库已存在且用户有推送权限