Docker 插件可用于构建容器镜像并将其发布到 Docker 注册表。

YAML 配置示例

kind: pipeline
name: default

steps:
- name: docker
  image: plugins/docker
  settings:
    username: kevinbacon
    password: pa55word
    repo: foo/bar
    tags:
    - latest
    - main
    ssh-agent-key:
      from_secret: private_key

字段属性说明

  • registry

    string可选项

    对该注册表进行认证

    默认值:none

  • username

    string可选项

    使用该用户名进行身份验证

    默认值:none

  • password

    string可选项

    使用该密码进行身份验证

    推荐使用密钥 (Secret) 功能

    默认值:none

  • repo

    string可选项

    容器镜像的存储库名称

    默认值:none

  • tags

    array可选项

    容器镜像的存储库标签

    默认值:none

  • secret

    string可选项

    使用 buildkit 向 dockerbuild 传递秘密。例如`id=mysecret,src=secret-file`。

    默认值:none

  • dockerfile

    string可选项

    要使用的 dockerfile

    默认值:Dockerfile

  • dry_run

    string可选项

    布尔型,如果最后不推送 docker 镜像

    默认值:none

  • purge

    boolean可选项

    是否在最后清理 docker 镜像的布尔值

    默认值:true

  • context

    string可选项

    要使用的上下文路径,默认为 git 仓库的根目录

    默认值:none

  • target

    string可选项

    必须在 docker 文件中定义。

    默认值:none

  • force_tag

    boolean可选项

    替换现有的匹配容器镜像标签

    默认值:false

  • insecure

    boolean可选项

    启用与该注册表的不安全通信

    默认值:false

  • mirror

    string可选项

    使用镜像注册表,而不是直接从中心枢纽提取容器镜像

    默认值:none

  • bip

    boolean可选项

    用于传递网桥 IP 地址

    默认值:false

  • custom_dns

    string可选项

    为容器设置自定义 dns 服务器

    默认值:none

  • custom_dns_search

    string可选项

    docker 守护进程 dns 搜索域

    默认值:none

  • storage_driver

    string可选项

    支持 `aufs`、`overlay` 或 `vfs` 驱动程序

    默认值:none

  • storage_path

    string可选项

    docker 守护进程存储路径

    默认值:none

  • build_args

    string可选项

    将自定义参数传递给 docker build

    默认值:none

  • build_args_from_env

    string可选项

    将 envvars 作为自定义参数传递给 docker build

    默认值:none

  • auto_tag

    boolean可选项

    根据 git 分支和 git 标签自动生成标签名

    默认值:false

  • auto_tag_suffix

    string可选项

    生成以此为后缀的标签名

    默认值:none

  • debug

    boolean可选项

    以详细调试模式启动 docker 守护进程

    默认值:false

  • launch_debug

    boolean可选项

    以详细调试模式启动 docker 守护进程

    默认值:false

  • mtu

    string可选项

    docker 守护进程自定义 mtu 设置

    默认值:none

  • ipv6

    string可选项

    docker 守护进程 IPv6 网络

    默认值:none

  • experimental

    boolean可选项

    docker 守护进程 实验模式

    默认值:false

  • daemon_off

    boolean可选项

    不启动 docker 守护进程

    默认值:false

  • cache_from

    string可选项

    可作为缓存源的容器镜像

    默认值:none

  • squash

    boolean可选项

    在构建时压扁图层

    默认值:false

  • pull_image

    boolean可选项

    在构建时强制拉取基础容器镜像

    默认值:false

  • compress

    boolean可选项

    使用 gzip 压缩构建上下文

    默认值:false

  • custom_labels

    string可选项

    附加 k=v 标签

    默认值:none

  • label_schema

    string可选项

    标签模式标签

    默认值:none

  • email

    string可选项

    docker 电子邮件

    默认值:none

  • no_cache

    string可选项

    不使用缓存的中间容器

    默认值:none

  • add_host

    string可选项

    附加主机:IP 映射

    默认值:none

  • platform

    string可选项

    指定联编输出的目标平台(例如 linux/amd64、linux/arm64 或 darwin/amd64)。

    默认值:none

  • ssh-agent-key

    string可选项

    用于 ssh 直通的私钥,请参见 https://docs.docker.com/engine/reference/commandline/buildx_build/#ssh

    推荐使用密钥 (Secret) 功能

    默认值:none