Drone 插件市场 Drone 插件文档 原文地址 - Docker 插件的手册

Docker 插件可以用于构建镜像及发布镜像到 Docker registry。下面的 pipeline 配置，就使用了 Docker 插件来构建和发布镜像：

pipeline: docker: image: plugins/docker username: kevinbacon password: pa55word repo: foo/bar tags: latest

使用多个 tag 的示例配置：

pipeline: docker: image: plugins/docker repo: foo/bar - tags: latest + tags: + - latest + - 1.0.1 + - 1.0

使用 .tag 文件（用逗号分隔的 tag 列表）的示例配置：

pipeline: build: image: golang:1.10.0-alpine commands: - [...] + - echo -n "5.2.6,5.2.4" > .tags docker: image: plugins/docker repo: foo/bar - tags: latest

使用 build_args 参数的示例配置：

pipeline: docker: image: plugins/docker repo: foo/bar + build_args: + - HTTP_PROXY=http://yourproxy.com

使用备用 Dockerfile 的示例配置：

pipeline: docker: image: plugins/docker repo: foo/bar - dockerfile: Dockerfile + dockerfile: path/to/Dockerfile

使用自定义 registry 的示例配置：

pipeline: docker: image: plugins/docker - repo: foo/bar + repo: index.company.com/foo/bar + registry: index.company.com

使用行内凭据（inline credentials）的示例配置：

pipeline: docker: image: plugins/docker + username: kevinbacon + password: pa55word repo: foo/bar

使用 secrets 中的凭据（通过 Drone 的 web 页面添加）的示例配置：

pipeline: docker: image: plugins/docker - username: kevinbacon - password: pa55word repo: foo/bar + secrets: [ docker_username, docker_password ]

自动打标签 Autotag

Docker 插件可以被配置成自动为你的镜像创建 tag。当开启这个特性且事件类型是 tag 时，插件会自动使用标准的 major、minor、release 惯例为镜像创建 tag。例如：

1.0.0 生成 docker tag 1, 1.0, 1.0.01.0.0-rc.1 生成 docker tag 1.0.0-rc.1

当事件类型是 push 并且目标分支是你的默认分支（例如 master）时，插件会自动为镜像添加 latest 这个 tag。所有其他的事件类型和分支都会被忽略。

示例配置：

pipeline: docker: image: plugins/docker repo: foo/bar + auto_tag: true secrets: [ docker_username, docker_password ]

使用了 tag 后缀的示例配置：

pipeline: docker: image: plugins/docker repo: foo/bar + auto_tag: true + auto_tag_suffix: linux-amd64 secrets: [ docker_username, docker_password ]

请注意，自动标记 auto_tag 是故意简单和无法定制的，目前不接受 pull 请求以进一步定制逻辑。

多阶段构建（Multi-stage builds）

Docker 插件允许在 官方文档 中描述的 Dockerfile 中定义的特定阶段停止构建。如果未定义 target 属性，则 Docker 插件不会在任何阶段停止，此时只会构建完整的 Docker 镜像。

The Docker plugin allow to stop build at a specific stage defined in Dockerfile as described in the official docs. If the target attribute is not defined, the Docker plugin will not stop at any stage and build the full docker image.

Dockerfile 示例：

FROM golang as builder WORKSPACE /go/src/github.com/foo/bar RUN CGO_ENABLED=0 GOOS=linux go build -o demo main.go FROM scratch as production COPY --from=builder /go/src/github.com/foo/bar/demo . CMD ["./demo"] FROM alpine as debug COPY --from=builder /go/src/github.com/foo/bar/demo . CMD ["./demo"]

允许构建生产环境 Docker 镜像的示例配置：

pipeline: docker: image: plugins/docker repo: foo/bar + target: production secrets: [ docker_username, docker_password ]

下面这个会构建 debug 环境 Docker 镜像：

pipeline: docker: image: plugins/docker repo: foo/bar + target: debug secrets: [ docker_username, docker_password ]

Secret 手册

docker_username：使用此用户名进行身份验证docker_password：使用此密码进行身份验证

Parameter 手册

registry：向这个 registry 进行验证username：使用此用户名进行身份验证password：使用此密码进行身份验证repo：用于存储镜像的仓库名tags：用于镜像的仓库的 tagdockerfile：要使用的 dockerfile，默认是 Dockerfileauth：registry 的身份验证 tokencontext：要使用的上下文路径，默认为 git 仓库的根目录target：要使用的构建目标，必须在 dockerfile 中定义force_tag=false：替换现有的匹配到的镜像的 taginsecure=false：启用对此 registry 的不安全通信mirror：使用 registry 镜像，而不是直接从 Docker 默认的 Hub 中获取镜像bip=false：用于传递 bridge IPcustom_dns：为容器设置自定义 DNS 服务器storage_driver：支持 aufs，overlay 或 vfs 驱动程序build_args：自定义参数传递给 docker buildauto_tag=false：根据 git 分支和 git 标签自动生成标签名称auto_tag_suffix：用这个后缀生成标签名称debug, launch_debug：以详细调试模式启动 docker 守护进程

转载于:https://www.cnblogs.com/kika/p/10851589.html

相关资源：drone-telegram：用于发送电报通知的Drone插件-源码