136 lines
3.8 KiB
Markdown
136 lines
3.8 KiB
Markdown
# drone-kaniko
|
|
|
|
> Note: this is a remote working branch of https://github.com/drone/drone-kaniko\
|
|
> with my personal changes on top. GH would call it a "fork".\
|
|
> Development occurs in the `dev` branch while the `main` branch remains a\
|
|
> perfect clone of the remote `main` (as long as I keep it updated).
|
|
|
|
Drone kaniko plugin uses [kaniko](https://github.com/GoogleContainerTools/kaniko) to build and publish Docker images to a container registry.
|
|
|
|
## Build
|
|
|
|
Build the binaries with the following commands:
|
|
|
|
```console
|
|
export GOOS=linux
|
|
export GOARCH=amd64
|
|
export CGO_ENABLED=0
|
|
export GO111MODULE=on
|
|
|
|
go build -v -a -tags netgo -o release/linux/amd64/kaniko-docker ./cmd/kaniko-docker
|
|
go build -v -a -tags netgo -o release/linux/amd64/kaniko-gcr ./cmd/kaniko-gcr
|
|
go build -v -a -tags netgo -o release/linux/amd64/kaniko-ecr ./cmd/kaniko-ecr
|
|
```
|
|
|
|
## Docker
|
|
|
|
Build the Docker images with the following commands:
|
|
|
|
```console
|
|
docker build \
|
|
--label org.label-schema.build-date=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
|
|
--label org.label-schema.vcs-ref=$(git rev-parse --short HEAD) \
|
|
--file docker/docker/Dockerfile.linux.amd64 --tag plugins/kaniko .
|
|
|
|
docker build \
|
|
--label org.label-schema.build-date=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
|
|
--label org.label-schema.vcs-ref=$(git rev-parse --short HEAD) \
|
|
--file docker/gcr/Dockerfile.linux.amd64 --tag plugins/kaniko-gcr .
|
|
|
|
docker build \
|
|
--label org.label-schema.build-date=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
|
|
--label org.label-schema.vcs-ref=$(git rev-parse --short HEAD) \
|
|
--file docker/ecr/Dockerfile.linux.amd64 --tag plugins/kaniko-ecr .
|
|
```
|
|
|
|
## Usage
|
|
### Manual Tagging
|
|
|
|
```console
|
|
docker run --rm \
|
|
-e PLUGIN_TAGS=1.2,latest \
|
|
-e PLUGIN_DOCKERFILE=/drone/Dockerfile \
|
|
-e PLUGIN_REPO=foo/bar \
|
|
-e PLUGIN_USERNAME=foo \
|
|
-e PLUGIN_PASSWORD=bar \
|
|
-v $(pwd):/drone \
|
|
-w /drone \
|
|
plugins/kaniko:linux-amd64
|
|
```
|
|
|
|
With expanded tagging enabled, semantic versions can be passed to PLUGIN_TAGS directly for expansion.
|
|
|
|
**Note**: this feature only works for build labels. Artifact labels are not supported.
|
|
|
|
```console
|
|
docker run --rm \
|
|
-e PLUGIN_TAGS=v1.2.3,latest \
|
|
-e PLUGIN_EXPAND_TAG=true \
|
|
-v $(pwd):/drone \
|
|
-w /drone \
|
|
plugins/kaniko:linux-amd64
|
|
```
|
|
would both be equivalent to
|
|
|
|
```
|
|
PLUGIN_TAGS=1,1.2,1.2.3,latest
|
|
```
|
|
|
|
This allows for passing `$DRONE_TAG` directly as a tag for repos that use [semver](https://semver.org) tags.
|
|
|
|
To avoid confusion between repo tags and image tags, `PLUGIN_EXPAND_TAG` also recognizes a semantic version
|
|
without the `v` prefix. As such, the following is also equivalent to the above:
|
|
|
|
```console
|
|
docker run --rm \
|
|
-e PLUGIN_TAGS=1.2.3,latest \
|
|
-e PLUGIN_EXPAND_TAG=true \
|
|
-v $(pwd):/drone \
|
|
-w /drone \
|
|
plugins/kaniko:linux-amd64
|
|
```
|
|
|
|
### Auto Tagging
|
|
The [auto tag feature](https://plugins.drone.io/drone-plugins/drone-docker) of docker plugin is also supported.
|
|
|
|
When auto tagging is enabled, if any of the case is matched below, a docker build will be pushed with auto generated tags. Otherwise the docker build will be skipped.
|
|
|
|
**Note**: this feature only works for build labels. Artifact labels are not supported.
|
|
|
|
#### Git Tag Push:
|
|
|
|
```console
|
|
docker run --rm \
|
|
-e DRONE_COMMIT_REF=refs/tags/v1.2.3 \
|
|
-e PLUGIN_REPO=foo/bar \
|
|
-e PLUGIN_USERNAME=foo \
|
|
-e PLUGIN_PASSWORD=bar \
|
|
-e PLUGIN_AUTO_TAG=true \
|
|
-v $(pwd):/drone \
|
|
-w /drone \
|
|
plugins/kaniko:linux-amd64
|
|
```
|
|
|
|
Tags to push:
|
|
- 1.2.3
|
|
- 1.2
|
|
- 1
|
|
|
|
#### Git Commit Push in default branch:
|
|
|
|
```console
|
|
docker run --rm \
|
|
-e DRONE_COMMIT_REF=refs/heads/master \
|
|
-e DRONE_REPO_BRANCH=main \
|
|
-e PLUGIN_REPO=foo/bar \
|
|
-e PLUGIN_USERNAME=foo \
|
|
-e PLUGIN_PASSWORD=bar \
|
|
-e PLUGIN_AUTO_TAG=true \
|
|
-v $(pwd):/drone \
|
|
-w /drone \
|
|
plugins/kaniko:linux-amd64
|
|
```
|
|
|
|
Tags to push:
|
|
- latest
|