docker / Setup Buildx Action

About

GitHub Action to set up Docker Buildx.

This action will create and boot a builder that can be used in the following steps of your workflow if you're using buildx. By default, the docker-container builder driver will be used to be able to build multi-platform images and export cache thanks to the BuildKit container.

💡 See also:

• login action
• setup-qemu action
• build-push action

• Usage
  • Quick start
  • With QEMU
  • Install by default
• Customizing
  • inputs
  • outputs
  • environment variables
• Keep up-to-date with GitHub Dependabot
• Limitation

Usage

Quick start

name: ci

on:
  push:

jobs:
  buildx:
    runs-on: ubuntu-latest
    steps:
      -
        name: Checkout
        uses: actions/[email protected]
      -
        name: Set up Docker Buildx
        id: buildx
        uses: docker/[email protected]
      -
        name: Builder instance name
        run: echo ${{ steps.buildx.outputs.name }}
      -
        name: Available platforms
        run: echo ${{ steps.buildx.outputs.platforms }}

With QEMU

If you want support for more platforms you can use our setup-qemu action:

name: ci

on:
  push:

jobs:
  buildx:
    runs-on: ubuntu-latest
    steps:
      -
        name: Checkout
        uses: actions/[email protected]
      -
        name: Set up QEMU
        uses: docker/[email protected]
      -
        name: Set up Docker Buildx
        id: buildx
        uses: docker/[email protected]
      -
        name: Available platforms
        run: echo ${{ steps.buildx.outputs.platforms }}

Install by default

Implemented with https://github.com/docker/buildx#setting-buildx-as-default-builder-in-docker-1903

name: ci

on:
  push:

jobs:
  buildx:
    runs-on: ubuntu-latest
    steps:
      -
        name: Checkout
        uses: actions/[email protected]
      -
        uses: docker/[email protected]
        id: buildx
        with:
          install: true
      -
        name: Build
        run: |
          docker build . # will run buildx

Customizing

inputs

Following inputs can be used as step.with keys

CSV type must be a newline-delimited string

driver-opts: image=moby/buildkit:master

driver-opts: |
  image=moby/buildkit:master
  network=host

outputs

Following outputs are available

environment variables

The following official docker environment variables are supported:

Keep up-to-date with GitHub Dependabot

Since Dependabot has native GitHub Actions support, to enable it on your GitHub repo all you need to do is add the .github/dependabot.yml file:

version: 2
updates:
  # Maintain dependencies for GitHub Actions
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "daily"

Limitation

This action is only available for Linux virtual environments.