106 lines
3.0 KiB
Markdown
106 lines
3.0 KiB
Markdown
---
|
|
title: drone-docker
|
|
---
|
|
|
|
[](https://drone.thegeeklab.de/thegeeklab/drone-docker)
|
|
[](https://hub.docker.com/r/thegeeklab/drone-docker)
|
|
[](https://quay.io/repository/thegeeklab/drone-docker)
|
|
[](https://github.com/thegeeklab/drone-docker/graphs/contributors)
|
|
[](https://github.com/thegeeklab/drone-docker)
|
|
[](https://github.com/thegeeklab/drone-docker/blob/main/LICENSE)
|
|
|
|
Drone plugin to build and publish multiarch Docker images.
|
|
|
|
<!-- prettier-ignore-start -->
|
|
<!-- spellchecker-disable -->
|
|
{{< toc >}}
|
|
<!-- spellchecker-enable -->
|
|
<!-- prettier-ignore-end -->
|
|
|
|
## Versioning
|
|
|
|
The tags follow the major version of Docker, e.g. `19`, and the minor and patch parts reflect the `version` of the plugin. A full example would be `19.6.5`. Minor versions can introduce breaking changes, while patch versions can be considered non-breaking.
|
|
|
|
## Usage
|
|
|
|
{{< hint type=important >}}
|
|
Be aware that the this plugin requires [privileged](https://docs.drone.io/pipeline/docker/syntax/steps/#privileged-mode) capabilities, otherwise the integrated Docker daemon is not able to start.
|
|
{{< /hint >}}
|
|
|
|
```YAML
|
|
kind: pipeline
|
|
name: default
|
|
|
|
steps:
|
|
- name: docker
|
|
image: thegeeklab/drone-docker
|
|
privileged: true
|
|
settings:
|
|
username: octocat
|
|
password: secure
|
|
repo: octocat/example
|
|
tags: latest
|
|
```
|
|
|
|
### Parameters
|
|
|
|
<!-- prettier-ignore-start -->
|
|
<!-- spellchecker-disable -->
|
|
{{< propertylist name=drone-docker.data sort=name >}}
|
|
<!-- spellchecker-enable -->
|
|
<!-- prettier-ignore-end -->
|
|
|
|
### Examples
|
|
|
|
**Push to other registries than DockerHub:**
|
|
|
|
If the created image is to be pushed to registries other than the default DockerHub, it is necessary to set `registry` and `repo` as fully-qualified name.
|
|
|
|
```YAML
|
|
kind: pipeline
|
|
name: default
|
|
|
|
steps:
|
|
- name: docker
|
|
image: thegeeklab/drone-docker
|
|
privileged: true
|
|
settings:
|
|
registry: ghcr.io
|
|
username: octocat
|
|
password: secret-access-token
|
|
repo: ghcr.io/octocat/example
|
|
tags: latest
|
|
```
|
|
|
|
## Build
|
|
|
|
Build the binary with the following command:
|
|
|
|
```Shell
|
|
export GOOS=linux
|
|
export GOARCH=amd64
|
|
export CGO_ENABLED=0
|
|
export GO111MODULE=on
|
|
|
|
make build
|
|
```
|
|
|
|
Build the Docker image with the following command:
|
|
|
|
```Shell
|
|
docker build --file docker/Dockerfile.amd64 --tag thegeeklab/drone-docker .
|
|
```
|
|
|
|
## Test
|
|
|
|
```Shell
|
|
docker run --rm \
|
|
-e PLUGIN_TAG=latest \
|
|
-e PLUGIN_REPO=octocat/hello-world \
|
|
-e DRONE_COMMIT_SHA=00000000 \
|
|
-v $(pwd):$(pwd) \
|
|
-w $(pwd) \
|
|
--privileged \
|
|
thegeeklab/drone-docker --dry-run
|
|
```
|