woodpecker-helm3/docs/parameter_reference.md

Parameter reference

Global

Param name	Type	Purpose
helm_command	string	Indicates the operation to perform. Recommended, but not required. Valid options are upgrade, uninstall, lint, and help.
update_dependencies	boolean	Calls helm dependency update before running the main command.
helm_repos	list<string>	Calls helm repo add $repo before running the main command. Each string should be formatted as repo_name=https://repo.url/. Not currently implemented; see #26.
namespace	string	Kubernetes namespace to use for this operation.
prefix	string	Expect environment variables to be prefixed with the given string. For more details, see "Using the prefix setting" below. Not currently implemented; see #19.
debug	boolean	Generate debug output within drone-helm3 and pass --debug to all helm commands. Use with care, since the debug output may include secrets.

Linting

Linting is only triggered when the helm_command setting is "lint".

Param name	Type	Required	Purpose
chart	string	yes	The chart to be linted. Must be a local path.
values	list<string>		Chart values to use as the --set argument to helm lint.
string_values	list<string>		Chart values to use as the --set-string argument to helm lint.
values_files	list<string>		Values to use as --values arguments to helm lint.

Installation

Installations are triggered when the helm_command setting is "upgrade." They can also be triggered when the build was triggered by a push, tag, deployment, pull_request, promote, or rollback Drone event.

Param name	Type	Required	Purpose
chart	string	yes	The chart to use for this installation.
release	string	yes	The release name for helm to use.
api_server	string	yes	API endpoint for the Kubernetes cluster.
kubernetes_token	string	yes	Token for authenticating to Kubernetes.
service_account	string		Service account for authenticating to Kubernetes. Default is helm.
kubernetes_certificate	string		Base64 encoded TLS certificate used by the Kubernetes cluster's certificate authority.
chart_version	string		Specific chart version to install.
dry_run	boolean		Pass --dry-run to helm upgrade.
wait	boolean		Wait until kubernetes resources are in a ready state before marking the installation successful.
timeout	duration		Timeout for any individual Kubernetes operation. The installation's full runtime may exceed this duration.
force	boolean		Pass --force to helm upgrade.
values	list<string>		Chart values to use as the --set argument to helm upgrade.
string_values	list<string>		Chart values to use as the --set-string argument to helm upgrade.
values_files	list<string>		Values to use as --values arguments to helm upgrade.
reuse_values	boolean		Reuse the values from a previous release.
skip_tls_verify	boolean		Connect to the Kubernetes cluster without checking for a valid TLS certificate. Not recommended in production.

Uninstallation

Uninstallations are triggered when the helm_command setting is "uninstall" or "delete." They can also be triggered when the build was triggered by a delete Drone event.

Param name	Type	Required	Purpose
release	string	yes	The release name for helm to use.
api_server	string	yes	API endpoint for the Kubernetes cluster.
kubernetes_token	string	yes	Token for authenticating to Kubernetes.
service_account	string		Service account for authenticating to Kubernetes. Default is helm.
kubernetes_certificate	string		Base64 encoded TLS certificate used by the Kubernetes cluster's certificate authority.
dry_run	boolean		Pass --dry-run to helm uninstall.
timeout	duration		Timeout for any individual Kubernetes operation. The uninstallation's full runtime may exceed this duration.
skip_tls_verify	boolean		Connect to the Kubernetes cluster without checking for a valid TLS certificate. Not recommended in production.
chart	string		Required when the global update_dependencies parameter is true. No effect otherwise.

Where to put settings

Any setting (with the exception of prefix; see below), can go in either the settings or environment section.

Formatting non-string values

• Booleans can be yaml's true and false literals or the strings "true" and "false".
• Durations are strings formatted with the syntax accepted by golang's ParseDuration function (e.g. 5m30s)
  • For backward-compatibility with drone-helm, a duration can also be an integer, in which case it will be interpreted to mean seconds.
• List<string>s can be a yaml sequence or a comma-separated string.

All of the following are equivalent:

values: "foo=1,bar=2"
values: ["foo=1", "bar=2"]
values:
  - foo=1
  - bar=2

Note that list members must not contain commas. Both of the following are equivalent:

values_files: [ "./over_9,000.yml" ]
values_files: [ "./over_9", "000.yml" ]

Using the prefix setting

Because the prefix setting is meta-configuration, it has some inherent edge-cases. Here is what it does in the cases we've thought of:

Unlike the other settings, it must be declared in the settings block, not environment:

settings:
  prefix: helm # drone-helm3 will look for environment variables called HELM_VARNAME
environment:
  prefix: armet # no effect

It does not apply to configuration in the settings block, only in environment:

settings:
  prefix: helm
  helm_timeout: 5m # no effect
environment:
  helm_timeout: 2m # timeout will be 2 minutes

If the environment contains a variable in non-prefixed form, it will still be applied:

settings:
  prefix: helm
environment:
  timeout: 2m # timeout will be 2 minutes

If the environment contains both the prefixed and non-prefixed forms, drone-helm3 will use the prefixed form:

settings:
  prefix: helm
environment:
  timeout: 5m # overridden
  helm_timeout: 2m # timeout will be 2 minutes