Skip to content

Latest commit

 

History

History
130 lines (87 loc) · 2.94 KB

DOCS.md

File metadata and controls

130 lines (87 loc) · 2.94 KB
Raw

Drone Kubernetes

This drone kubernetes plugin does the equivalent of:

kubectl apply -f deployment.yaml

If the deployment does not exists, it will be created.

The advantages of this plugin is that the deployment.yaml file can be a template file. We are able to substitute values like {{ build.number }} inside the file so you can update docker image names.

Basic example:

pipeline:
  deploy:
  	 image: vallard/drone-kube
     template: deployment.yaml

Example configuration with non-default namespace:

pipeline:
  kube:
  	image: vallard/drone-kube
    template: deployment.yaml
+   namespace: mynamespace

You can also specify the server in the configuration as well. It could alternatively be specified as an environment variable as shown in the next section.

pipeline:
  kubernetes:
  	image: vallard/drone-kube
    template: deployment.yaml
+   namespace: mynamespace
+   server: https://10.93.234.28:6433

Secrets

The kube plugin supports reading credentials from the Drone secret store. This is strongly recommended instead of storing credentials in the pipeline configuration in plain text.

The following secrets should be set:

KUBE_TOKEN This plugin has one authentication method and that is to use the token to authorize the user.

KUBE_CA This should be the base64 encoding of your certificate authority. You can get this string by running the command:

export KUBE_CA=$(cat ca.pem | base64)

KUBE_SERVER This is the server url for your kubernetes cluster. e.g: https://10.99.2.1:6443

Template Reference

You can substitute the following values between {{ }} in your deployment template

repo.owner : repository owner

repo.name : repository name

build.status : build status type enumeration, either success or failure

build.event : build event type enumeration, one of push, pull_request, tag, deployment

build.number : build number

build.commit : git sha for current commit

build.branch : git branch for current commit

build.tag : git tag for current commit

build.ref : git ref for current commit

build.author : git author for current commit

build.link : link the the build results in drone

build.created : unix timestamp for build creation

build.started : unix timestamp for build started

Template Function Reference

uppercasefirst : converts the first letter of a string to uppercase

uppercase : converts a string to uppercase

lowercase : converts a string to lowercase. Example {{lowercase build.author}}

datetime : converts a unix timestamp to a date time string. Example {{datetime build.started}}

success : returns true if the build is successful

failure : returns true if the build is failed

truncate : returns a truncated string to n characters. Example {{truncate build.sha 8}}

urlencode : returns a url encoded string

since : returns a duration string between now and the given timestamp. Example {{since build.started}}