helm - Manages Kubernetes packages with the Helm package manager

New in version 2.4.

Synopsis

  • Install, upgrade, delete and list packages with the Helm package manage

Requirements

The below requirements are needed on the host that executes this module.

  • pyhelm
  • grpcio

Parameters

Parameter Choices/Defaults Comments
chart Default:
{}
A map describing the chart to install. For example: chart: name: memcached version: 0.4.0 source: type: repo location: https://kubernetes-charts.storage.googleapis.com
disable_hooks
bool
    Choices:
  • no ←
  • yes
Whether to disable hooks during the uninstall process
host Default:
"localhost"
Tiller's server host
name
Release name to manage
namespace Default:
"default"
Kubernetes namespace where the chart should be installed
port Default:
44134
Tiller's server port
state
    Choices:
  • absent
  • purged
  • present ←
Whether to install present, remove absent, or purge purged a package.
values Default:
{}
A map of value options for the chart.

Examples

- name: Install helm chart
  helm:
    host: localhost
    chart:
      name: memcached
      version: 0.4.0
      source:
        type: repo
        location: https://kubernetes-charts.storage.googleapis.com
    state: present
    name: my-memcached
    namespace: default

- name: Uninstall helm chart
  helm:
    host: localhost
    state: absent
    name: my-memcached

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • Flavio Percoco (flaper87)

Hint

If you notice any issues in this documentation you can edit this document to improve it.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/helm_module.html