Back to Charts

Running Buildkite agent - DEPRECATED

stable/buildkite/README.md

latest2.7 KB
Original Source

Running Buildkite agent - DEPRECATED

This chart is deprecated! You can find the new chart in:

bash
helm repo add buildkite https://buildkite.github.io/charts/

Introduction

This chart bootstraps a buildkite agent builder on a Kubernetes cluster using the Helm package manager. As it sets service account it can be used to build Docker images and deploy them using kubectl and helm clients in the same cluster where agents run, without any extra setup.

Installing the Chart

In order for the chart to configure the Buildkite Agent properly during the installation process, you must provide some minimal configuration which can't rely on defaults. This includes at least one element in the agent list token:

To install the chart with the release name bk-agent:

bash
$ helm install stable/buildkite --name bk-agent --namespace buildkite --set agent.token="BUILDKITE_AGENT_TOKEN"

To install the chart with the release name bk-agent and set Agent meta-data and git repo SSH key:

console
$ helm install stable/buildkite --name bk-agent --namespace buildkite \
  --set agent.token="$(cat buildkite.token)",agent.meta="role=production",privateSshKey="$(cat buildkite.key)"

Where --set values contain:

agentToken: Buildkite token read from file
agentMeta: tagging agent with - role=production
privateSshKey: private SSH key read from file

Tip: List all releases using helm list

Uninstalling the Chart

To uninstall/delete the bk-agent release:

bash
$ helm delete bk-agent

The command removes all the Kubernetes components associated with the chart and deletes the release.

Configuration

The following table lists the configurable parameters of the buildkite chart and their default values.

ParameterDescriptionDefault
replicaCountReplicas count1
image.repositoryImagebuildkite/agent
image.tagImage tag3.0
image.pullPolicyImage pull policyIfNotPresent
agent.tokenAgent tokenMust be specified
agent.metaAgent meta-datarole=agent
extraEnvAgent extra env varsnil
privateSshKeyAgent ssh key for git accessnil
registryCreds.gcrServiceAccountKeyGCP Service account json keynil
registryCreds.dockerConfigPrivate registry docker config.jsonnil
resourcespod resource requests & limits{}
nodeSelectornode labels for pod assignment{}

Buildkite pipeline examples

Check for examples of pipeline.yml and build/deploy scripts here.