banzaicloud/drone-kaniko

drone-kaniko

drone-kaniko是Google Kaniko官方镜像的轻量包装，旨在让Kaniko在Drone CI/CD系统中表现得与Drone Docker插件一致，支持无需root权限构建Docker镜像。

核心功能

• 支持推送镜像到Docker Hub、GCR等镜像仓库
• 提供缓存功能以加速镜像构建
• 支持通过.tags文件自定义镜像标签
• 支持自动打标签（auto_tag）
• 可跳过TLS验证（仅测试环境使用）
• 允许传递构建参数（build_args）

使用场景

• Drone CI/CD流水线中的Docker镜像构建与推送环节
• 无root权限环境下的镜像构建需求
• 需要缓存优化构建速度的场景

配置说明

推送到Docker Hub示例（Drone 1.0）

yaml
kind: pipeline
name: default

steps:
- name: publish
  image: banzaicloud/drone-kaniko
  settings:
    registry: registry.example.com # 未提供则默认使用index.docker.io
    repo: registry.example.com/example-project
    tags: ${DRONE_COMMIT_SHA}
    cache: true
    skip_tls_verify: false # 仅测试环境使用自签名证书时设为true
    build_args:
    - COMMIT_SHA=${DRONE_COMMIT_SHA}
    - COMMIT_AUTHOR_EMAIL=${DRONE_COMMIT_AUTHOR_EMAIL}
    username:
      from_secret: docker-username
    password:
      from_secret: docker-password

推送到GCR示例

yaml
kind: pipeline
name: default

steps:
- name: publish
  image: banzaicloud/drone-kaniko
  settings:
    registry: gcr.io
    repo: example.com/example-project
    tags: ${DRONE_COMMIT_SHA}
    cache: true
    json_key:
      from_secret: google-application-credentials

使用.tags文件自定义标签

yaml
kind: pipeline
name: default

steps:
- name: build
  image: golang
  commands:
      - go get 
      - go build
      - make versiontags > .tags
- name: publish
  image: banzaicloud/drone-kaniko
  settings:
    registry: registry.example.com 
    repo: registry.example.com/example-project
    # 需留空tags以使用.tags文件
    username:
      from_secret: docker-username
    password:
      from_secret: docker-password

自动打标签

yaml
kind: pipeline
name: default

steps:
- name: build
  image: golang
  commands:
      - go get 
      - go build
- name: publish
  image: banzaicloud/drone-kaniko
  settings:
    registry: registry.example.com 
    repo: registry.example.com/example-project
    auto_tag: true # 优先级高于.tags文件
    # 需留空tags以使用auto_tag
    username:
      from_secret: docker-username
    password:
      from_secret: docker-password

本地测试构建

bash
docker run -it --rm -w /src -v $PWD:/src -e PLUGIN_USERNAME=${DOCKER_USERNAME} -e PLUGIN_PASSWORD=${DOCKER_PASSWORD} -e PLUGIN_REPO=banzaicloud/drone-kaniko-test -e PLUGIN_TAGS=test -e PLUGIN_DOCKERFILE=Dockerfile.test banzaicloud/drone-kaniko

测试缓存功能

1. 启动本地镜像仓库：

bash
docker run -d -p 5000:5000 --restart always --name registry --hostname registry.local registry:2

2. 预热缓存：

bash
docker run -v $PWD:/cache gcr.io/kaniko-project/warmer:latest --verbosity=debug --image=alpine:3.8

3. 运行带缓存的构建：

bash
docker run --net=host -it --rm -w /src -v $PWD:/cache -v $PWD:/src -e PLUGIN_USERNAME=${DOCKER_USERNAME} -e PLUGIN_PASSWORD=${DOCKER_PASSWORD} -e PLUGIN_REPO=banzaicloud/drone-kaniko-test -e PLUGIN_TAGS=test -e PLUGIN_DOCKERFILE=Dockerfile.test -e PLUGIN_CACHE=true banzaicloud/drone-kaniko