Plugin for woodpecker to deploy helm charts using helm3
Go to file
2019-12-20 10:37:32 -08:00
cmd/drone-helm Non-0 exit status on error 2019-12-16 15:46:37 -08:00
docs Advise that some settings aren't yet functional [#8] 2019-12-20 10:37:32 -08:00
internal Prod maintainers to keep the docs and code in sync [#8] 2019-12-20 10:05:50 -08:00
.drone.yml update drone.yml to publish to docker hub 2019-12-19 13:38:04 -08:00
.gitignore Make it so 2019-11-21 11:35:50 -08:00
Dockerfile Initialize kubernetes config on upgrade 2019-12-16 15:41:04 -08:00
go.mod Run golint during drone builds 2019-12-09 15:27:56 -08:00
go.sum Run golint during drone builds 2019-12-09 15:27:56 -08:00
kubeconfig Initialize kubernetes config on upgrade 2019-12-16 15:41:04 -08:00
README.md Rename the setting description files to _settings [#8] 2019-12-20 09:41:36 -08:00

Drone plugin for Helm 3

This plugin provides an interface between Drone 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 backwards-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/lint_settings.yml, docs/upgrade_settings.yml, and docs/uninstall_settings.yml.

Linting

steps:
  - name: lint
    image: pelotech/drone-helm3
    settings:
      helm_command: lint
      chart: ./

Deployment

steps:
  - name: deploy
    image: pelotech/drone-helm3
    settings:
      helm_command: upgrade
      chart: ./
      release: my-project
    environment:
      API_SERVER: https://my.kubernetes.installation/clusters/a-1234
      KUBERNETES_TOKEN:
        from_secret: kubernetes_token

Deletion

steps:
  - name: uninstall
    image: pelotech/drone-helm3
    settings:
      helm_command: uninstall
      release: my-project
    environment:
      API_SERVER: https://my.kubernetes.installation/clusters/a-1234
      KUBERNETES_TOKEN:
        from_secret: kubernetes_token

Upgrading from drone-helm

The setting names for drone-helm3 are backwards-compatible with those for drone-helm, so the only mandatory step is to update the image clause so that drone uses the new plugin.

There are several settings that no longer have any effect:

  • purge -- this is the default behavior in Helm 3
  • recreate_pods
  • tiller_ns
  • upgrade
  • canary_image
  • client_only
  • stable_repo_url

If your .drone.yml contains those settings, we recommend removing them.