drone-docker-buildx/README.md

71 lines
2.9 KiB
Markdown
Raw Normal View History

2021-01-10 23:47:55 +01:00
# drone-docker-buildx
2015-05-15 07:12:50 +02:00
2021-01-10 23:47:55 +01:00
Drone plugin to build multiarch Docker images with buildx
2019-01-21 00:19:15 +01:00
2021-01-17 15:22:43 +01:00
[![Build Status](https://img.shields.io/drone/build/thegeeklab/drone-docker-buildx?logo=drone&server=https%3A%2F%2Fdrone.thegeeklab.de)](https://drone.thegeeklab.de/thegeeklab/drone-docker-buildx)
2021-01-10 23:47:55 +01:00
[![Docker Hub](https://img.shields.io/badge/dockerhub-latest-blue.svg?logo=docker&logoColor=white)](https://hub.docker.com/r/thegeeklab/drone-docker-buildx)
[![Quay.io](https://img.shields.io/badge/quay-latest-blue.svg?logo=docker&logoColor=white)](https://quay.io/repository/thegeeklab/drone-docker-buildx)
[![Go Report Card](https://goreportcard.com/badge/github.com/thegeeklab/drone-docker-buildx)](https://goreportcard.com/report/github.com/thegeeklab/drone-docker-buildx)
[![GitHub contributors](https://img.shields.io/github/contributors/thegeeklab/drone-docker-buildx)](https://github.com/thegeeklab/drone-docker-buildx/graphs/contributors)
[![Source: GitHub](https://img.shields.io/badge/source-github-blue.svg?logo=github&logoColor=white)](https://github.com/thegeeklab/drone-docker-buildx)
[![License: MIT](https://img.shields.io/github/license/thegeeklab/drone-docker-buildx)](https://github.com/thegeeklab/drone-docker-buildx/blob/main/LICENSE)
2021-01-22 12:40:09 +01:00
Drone plugin to build multiarch Docker images with buildx. This plugin is a fork of [drone-plugins/drone-docker](https://github.com/drone-plugins/drone-docker).
2016-01-18 00:20:19 +01:00
2021-01-17 20:45:28 +01:00
## Docker Tags
Tags are following the main Docker version e.g. `20.10`, the second part is reflecting the plugin "version". A full example would be `20.10.5`.
2016-05-04 01:17:16 +02:00
## Build
2021-01-10 23:47:55 +01:00
Build the binary with the following command:
2016-05-04 01:17:16 +02:00
2021-01-10 23:47:55 +01:00
```Shell
export GOOS=linux
export GOARCH=amd64
export CGO_ENABLED=0
export GO111MODULE=on
2021-01-10 23:47:55 +01:00
go build -v -a -tags netgo -o release/drone-docker-buildx
2016-05-04 01:17:16 +02:00
```
2015-05-15 07:12:50 +02:00
2021-01-10 23:47:55 +01:00
Build the Docker image with the following command:
2015-05-15 07:12:50 +02:00
2021-01-10 23:47:55 +01:00
```Shell
docker build --file docker/Dockerfile.amd64 --tag thegeeklab/drone-docker-buildx .
2016-05-04 01:17:16 +02:00
```
## Usage
2021-01-10 23:47:55 +01:00
> Notice: Be aware that the tis plugin requires privileged capabilities, otherwise the integrated Docker daemon is not able to start.
2016-05-04 01:17:16 +02:00
2019-02-15 11:58:33 +01:00
```console
2016-05-04 01:17:16 +02:00
docker run --rm \
-e PLUGIN_TAG=latest \
-e PLUGIN_REPO=octocat/hello-world \
2021-01-10 23:47:55 +01:00
-e DRONE_COMMIT_SHA=00000000 \
-v $(pwd):$(pwd) \
2016-05-04 01:34:08 +02:00
-w $(pwd) \
--privileged \
2021-01-10 23:47:55 +01:00
thegeeklab/drone-docker-buildx --dry-run
2015-05-15 07:12:50 +02:00
```
2021-01-10 23:47:55 +01:00
2021-07-03 15:26:01 +02:00
## Community
<!-- prettier-ignore-start -->
<!-- spellchecker-disable -->
- [BitProcessor/drone-docker-buildx-ecr](https://github.com/BitProcessor/drone-docker-buildx-ecr) by [@BitProcessor](https://github.com/BitProcessor)
<!-- spellchecker-enable -->
<!-- prettier-ignore-end -->
2021-01-10 23:47:55 +01:00
## Contributors
Special thanks goes to all [contributors](https://github.com/thegeeklab/drone-docker-buildx/graphs/contributors). If you would like to contribute,
please see the [instructions](https://github.com/thegeeklab/drone-docker-buildx/blob/main/CONTRIBUTING.md).
## License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/thegeeklab/drone-docker-buildx/blob/main/LICENSE) file for details.