Skip to content

Targets

targets specifies the different 'deployment targets' to use for the project. The target match Kubernetes cluster configurations to deploy projects. Setting up Kubernetes contexts and namespaces is not handled by these tools.

The only required configuration is context and <name> must be unique.

targets:
  <name>:
    context:
    namespace:
    kubeconfig:
Parameter Default Description
context Which context in the Kubernetes configuration to use
namespace default Specific namespace to deploy to
kubeconfig value of KUBECONFIG environment variable Full path to a specific kubeconfig file to use

The KUBECONFIG_CONTENT environment variable (probably most useful in CI/CD pipelines) can be used to provide the content of a "kubeconfig" file. If set, buildtools will create a temporary file with that content to use as the kubeconfig value. KUBECONFIG_CONTENT can be either a base64 encoded string or plain text.

When deploying from inside a cluster, set context: in-cluster and make sure that the Pod has the appropriate permissions.

Note: the kubeconfig parameter in config file overrides both the KUBECONFIG and KUBECONFIG_CONTENT environment variables if set.

Examples

targets:
  local:
    context: docker-desktop
    namespace: default
  local-test:
    context: docker-desktop
    namespace: test