plugins/ecr

drone-ecr 镜像文档

概述

drone-ecr是Drone CI的官方插件，用于与Amazon ECR（Elastic Container Registry）集成，提供在CI/CD流程中自动化构建、标记和推送Docker镜像到Amazon ECR的能力。该插件由https://github.com/drone-plugins/drone-docker%E9%A1%B9%E7%9B%AE%E7%AE%A1%E7%90%86%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87Drone CI自身构建和推送。

核心功能

• Drone CI无缝集成：作为Drone CI生态插件，可直接配置在Drone pipeline中，与CI/CD流程深度融合
• ECR自动化认证：自动处理与Amazon ECR的身份验证，无需手动配置凭证
• 镜像生命周期管理：支持Docker镜像的构建、多标签标记（如版本号、latest等）及推送至ECR仓库
• 灵活配置：提供丰富的配置参数，支持自定义构建上下文、Dockerfile路径、构建参数等

使用场景

适用于采用Drone CI作为持续集成/持续部署工具，且需要将Docker镜像存储在Amazon ECR的开发团队，主要应用场景包括：

• 自动化应用Docker镜像的CI/CD发布流程
• 多环境（开发、测试、生产）镜像版本管理与推送
• 与ECR镜像生命周期策略联动，优化镜像存储成本

使用方法与配置说明

前提条件

• 已部署Drone CI服务（server与runner）
• 拥有Amazon AWS账号及ECR仓库访问权限（需配置IAM权限：ecr:GetAuthorizationToken、ecr:BatchCheckLayerAvailability、ecr:InitiateLayerUpload、ecr:UploadLayerPart、ecr:CompleteLayerUpload、ecr:PutImage等）
• Drone runner环境需配置AWS凭证（建议通过Drone secret管理敏感信息）

基本Pipeline配置示例

在Drone pipeline中使用drone-ecr插件的典型配置如下（完整参数见官方文档）：

yaml
kind: pipeline
name: ecr-push-example

steps:
- name: build and push to ecr
  image: plugins/ecr
  settings:
    # ECR仓库完整路径（格式：<aws-account-id>.dkr.ecr.<region>.amazonaws.com/<repo-name>）
    repo: 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app
    # 镜像标签（支持数组格式指定多个标签）
    tag: 
      - latest
      - ${DRONE_COMMIT_SHA:0:8}  # 使用Git提交SHA前8位作为标签
    # AWS区域
    region: us-east-1
    # AWS访问密钥（通过Drone secret传入，避免明文）
    access_key:
      from_secret: aws_access_key_id
    # AWS密钥（通过Drone secret传入）
    secret_key:
      from_secret: aws_secret_access_key
    # 可选：构建上下文路径（默认：.）
    context: ./app
    # 可选：Dockerfile路径（默认：Dockerfile）
    dockerfile: ./app/Dockerfile.prod
    # 可选：构建参数
    build_args:
      - APP_VERSION=${DRONE_TAG}

主要配置参数说明

相关链接

• 官方插件文档
• https://github.com/drone-plugins/drone-docker
• Amazon ECR官方文档