buildctl/README.md

buildctl Plugin

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
• 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
pipelinecomponents/buildctl	not a Woodpecker plugin
giantswarm/buildctl	not a Woodpecker plugin
cytopia/buildctl	not a Woodpecker plugin, outdated
sdesbure/buildctl	not a Woodpecker plugin, outdated