Plugin for woodpecker to deploy helm charts using helm3
Go to file
Thomas Renger a2304c1f07
ci/woodpecker/push/docker Pipeline was successful Details
fmt.Fprintf does not support error-wrapping directive %w
2023-11-06 17:56:10 +01:00
.github Ask for version information in the bug template [#78] 2020-01-22 10:06:57 -08:00
.woodpecker Update versions 2023-11-06 17:49:44 +01:00
assets Mention that EKS isn't currently supported [#5] 2019-12-27 10:49:22 -08:00
cmd/drone-helm fmt.Fprintf does not support error-wrapping directive %w 2023-11-06 17:56:10 +01:00
docs DEVOPS-2496 add max history setting (#12) 2022-08-16 11:37:13 -07:00
internal add comment 2022-08-16 11:44:57 -07:00
.drone.yml update for CGO 2022-08-23 10:11:21 -06:00
.gitignore Ignore .DS_Store 2023-11-06 17:49:26 +01:00 Use the Contributor Covenant code of conduct [#12] 2019-12-25 11:47:41 -08:00
Dockerfile Update versions 2023-11-06 17:49:44 +01:00
LICENSE Use the apache 2.0 license [#23] 2019-12-27 11:18:13 -08:00 Minimal commit to trigger CI 2023-02-09 22:39:03 +01:00
go.mod Fix godotenv dependency in go.mod 2020-01-08 11:08:39 -08:00
go.sum Load .env files on startup [#6] 2020-01-02 09:05:26 -08:00

Drone plugin for Helm 3

Build Status Go Report

This plugin provides an interface between Drone or Woodpecker and Helm 3:

  • Lint your charts
  • Deploy your service
  • Delete your service

The plugin is inpsired by drone-helm, which fills the same role for Helm 2. It provides a comparable feature-set and the configuration settings are backward-compatible.

Example configuration

The examples below give a minimal and sufficient configuration for each use-case. For a full description of each command's settings, see docs/


  - name: lint
    image: pelotech/drone-helm3
      mode: lint
      chart: ./


  - name: deploy
    image: pelotech/drone-helm3
      mode: upgrade
      chart: ./
      release: my-project
      KUBE_API_SERVER: https://my.kubernetes.installation/clusters/a-1234
        from_secret: kubernetes_token


  - name: uninstall
    image: pelotech/drone-helm3
      mode: uninstall
      release: my-project
      KUBE_API_SERVER: https://my.kubernetes.installation/clusters/a-1234
        from_secret: kubernetes_token

Upgrading from drone-helm

drone-helm3 is largely backward-compatible with drone-helm. There are some known differences:

  • You'll need to migrate the deployments in the cluster helm-v2-to-helm-v3.
  • EKS is not supported. See #5 for more information.
  • The prefix setting is no longer supported. If you were relying on the prefix setting with secrets: [...], you'll need to switch to the from_secret syntax.
  • During uninstallations, the release history is purged by default. Use keep_history: true to return to the old behavior.
  • Several settings no longer have any effect. The plugin will produce warnings if any of these are present:
    • purge -- this is the default behavior in Helm 3
    • recreate_pods
    • tiller_ns
    • upgrade
    • canary_image
    • client_only
    • stable_repo_url
  • Several settings have been renamed, to clarify their purpose and provide a more consistent naming scheme. For backward-compatibility, the old names are still available as aliases. If the old and new names are both present, the updated form takes priority. Conflicting settings will make your .drone.yml harder to understand, so we recommend updating to the new names:
    • helm_command is now mode ° helm_repos is now add_repos
    • api_server is now kube_api_server
    • service_account is now kube_service_account
    • kubernetes_token is now kube_token
    • kubernetes_certificate is now kube_certificate
    • wait is now wait_for_upgrade
    • force is now force_upgrade

Since helm 3 does not require Tiller, we also recommend switching to a service account with less-expansive permissions.


This repo is setup in a way that if you enable a personal drone server to build your fork it will build and publish your image (makes it easier to test PRs and use the image till the contributions get merged)

  • Build local DRONE_REPO_OWNER=josmo DRONE_REPO_NAME=drone-ecs drone exec
  • on your server (or just make sure you have DOCKER_USERNAME, DOCKER_PASSWORD, and PLUGIN_REPO set as secrets