README.md

🧪 Experimental

This repository is considered EXPERIMENTAL and under active development until further notice. It is subject to non-backward compatible changes or removal in any future version, so you should pin to a specific tag/commit of this action in your workflow (i.e docker/bake-action@v1.1.3).

About

GitHub Action to use Docker Buildx Bake as a high-level build command.

---

• Usage
• Customizing
  • inputs
  • outputs
• Contributing

Usage

name: ci

on:
  push:
    branches:
      - 'master'

jobs:
  bake:
    runs-on: ubuntu-latest
    steps:
      -
        name: Checkout
        uses: actions/checkout@v3
      -
        name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v2
      -
        name: Login to DockerHub
        uses: docker/login-action@v2
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}
      -
        name: Build and push
        uses: docker/bake-action@v2
        with:
          push: true

Customizing

inputs

Following inputs can be used as step.with keys

List type is a newline-delimited string

set: target.args.mybuildarg=value

set: |
  target.args.mybuildarg=value
  foo*.args.mybuildarg=value

CSV type is a comma-delimited string

targets: default,release

Name	Type	Description
builder	String	Builder instance (see setup-buildx action)
files	List/CSV	List of bake definition files
workdir	String	Working directory of execution
targets	List/CSV	List of bake targets (default target used if empty)
no-cache	Bool	Do not use cache when building the image (default false)
pull	Bool	Always attempt to pull a newer version of the image (default false)
load	Bool	Load is a shorthand for --set=*.output=type=docker (default false)
provenance	Bool/String	Provenance is a shorthand for --set=*.attest=type=provenance
push	Bool	Push is a shorthand for --set=*.output=type=registry (default false)
sbom	Bool/String	SBOM is a shorthand for --set=*.attest=type=sbom
set	List	List of targets values to override (eg: targetpattern.key=value)
source	String	Remote bake definition to build from

outputs

Following outputs are available

Name	Type	Description
metadata	JSON	Build result metadata

Contributing

Want to contribute? Awesome! You can find information about contributing to this project in the CONTRIBUTING.md