docker-qemu-setup/README.md at d11e3282b262b2705465c1a56bec7e09710faa1f

mirror of https://github.com/docker/setup-qemu-action.git synced 2024-12-22 19:52:18 -05:00

Solomon Jacobs d11e3282b2 Provide usage examples in README.md

We provide two simple examples of invoking `qemu-{arch}-static` (or more
precisely, we let the kernel do the invocation.)

Closes: #95

Signed-off-by: Solomon Jacobs <solomonjacobs@protonmail.com>

2024-12-15 10:54:34 +01:00

3 KiB

Raw Blame History

About

GitHub Action to install QEMU static binaries.

Usage
Customizing
- inputs
- outputs
Contributing

Usage

name: ci

on:
  push:

jobs:
  qemu:
    runs-on: ubuntu-latest
    steps:
      -
        name: Set up QEMU
        uses: docker/setup-qemu-action@v3
        with:
          platforms: arm64, i386
      -
        name: Create an example binary for AArch64
        run: |
          go mod init hello
          cat << EOL > hello.go
          package main

          func main() {
            println("Hello, AArch64!")
          }
          EOL
          GOARCH=arm64 go build hello.go          
      -
        name: This would fail without docker/setup-qemu-action
        run: ./hello
      -
        name: You can also run images from other platforms
        run: docker run --platform linux/i386 hello-world

Customizing

inputs

The following inputs can be used as step.with keys:

Name	Type	Default	Description
`image`	String	`tonistiigi/binfmt:latest`	QEMU static binaries Docker image
`platforms`	String	`all`	Platforms to install (e.g., `arm64,riscv64,arm`)

outputs

The following outputs are available:

Name	Type	Description
`platforms`	String	Available platforms (comma separated)

Contributing

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

3 KiB Raw Blame History