buildctl/README.md
2025-06-06 21:53:23 +02:00

4.8 KiB

buildctl Plugin

pulls size dockerfile license issues

A Woodpecker CI plugin for buildctl to build container images using a remote buildkit instance. Also usable with Gitlab, Github or locally, see examples for usage.

Features

  • preconfigure buildctl parameters
  • searches for yaml files recursive
  • runnable with local docker daemon

Example

Woodpecker:

steps:
  buildctl:
    image: kokuwaio/buildctl
    depends_on: []
    settings:
      no-warnings: true
      format: json
    when:
      event: pull_request
      path: [.buildctl.yaml, "**/*.y*ml"]

Gitlab:

buildctl:
  stage: lint
  needs: []
  image: kokuwaio/buildctl
  variables:
    PLUGIN_NO_WARNINGS: true
    PLUGIN_FORMAT: json
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      changes: [.buildctl.yaml, "**/*.y*ml"]

CLI:

docker run --rm --volume=$(pwd):$(pwd):ro --workdir=$(pwd) kokuwaio/buildctl --no-warnings --format=json

Settings

Settings Name Environment Default Description
config-file PLUGIN_CONFIG_FILE none Configuration file to use, if none is configured default is used
strict PLUGIN_STRICT true Fail on warnings
no-warnings PLUGIN_NO_WARNINGS false Output only error level problems
format PLUGIN_FORMAT colored Format for parsing output: parsable, standard, colored, github, auto

Alternatives

Image Comment amd64 arm64
kokuwaio/buildctl Woodpecker plugin size size
pipelinecomponents/buildctl not a Woodpecker plugin size size
giantswarm/buildctl not a Woodpecker plugin size size
cytopia/buildctl not a Woodpecker plugin, outdated size size
sdesbure/buildctl not a Woodpecker plugin, outdated size size