Skip to main content

No project description provided

Project description

The Idem Helm provider


An Idem plug-in to manage Helm resources. Helm is a package manager for Kubernetes.

What is POP?

This project is built with pop, a Python-based implementation of Plugin Oriented Programming (POP). POP seeks to bring together concepts and wisdom from the history of computing in new ways to solve modern computing problems.

For more information:

Getting Started


  • Python 3.7+

  • git (if installing from source or contributing to the project)

    To contribute to the project and set up your local development environment, see CONTRIBUTING.rst in the source repository for this project.


You can install idem-helm with the Python package installer (PyPI) or from source.

Install from PyPI

pip install idem-helm

Install from Source

# Clone repo
git clone git@<your-project-path>/idem-helm.git
cd idem-helm

# Set up venv
python3 -m venv .venv
source .venv/bin/activate
pip install -e .



After installation, idem-helm execution and state modules are accessible to the pop hub.

For more information:

To use idem-helm execution and state modules to manage cluster resources, you need to set up authentication in one of the following ways.

With environment variables

Set KUBE_CONFIG_PATH and KUBE_CTX environment variables to the Kubernetes configuration file and context found in your kube_config file.

In the Idem config file

Edit the Idem config file to include the kube_config_path and context under account extras. Use the following example as a guideline.

        kube_config_path: ~/.kube/config
        context: default

In a credentials.yaml file

Create or edit an Idem credentials.yaml file to add the kube_config_path and context to a Helm profile. Use the following example as a guideline.

    kube_config_path: ~/.kube/config
    context: kubernetes-admin@kubernetes

For more about Idem credentials files, including recommended steps for encryption and environment variables, see Authenticating with Idem

You are now ready to use idem-helm.


Idem SLS files use states to ensure that resources are in a desired configuration. An idem-helm SLS file supports three state functions: present, absent, and describe.


The present function ensures that a resource exists. If a resource doesn’t exist, running present creates it. If the resource already exists, running present might leave it unchanged, or update it if there are any configuration changes.


The absent function ensures that a resource does not exist. If the resource exists, running absent deletes it. If the resource doesn’t exist, running absent has no effect.


The describe function returns a list of all resources in the Kubernetes cluster of the same type as specified in the credential profile.

Accessing States

States can be accessed by their relative location in idem-helm/idem_helm/states.

For example, a Helm release state can be created with the present function as shown in the following SLS file.


  - name: idem-redis
  - repository:
  - chart: redis
  - namespace: kube-system
  - resource_id: idem-redis
  - values:
            pullPolicy: IfNotPresent

The Idem command to create the preceding release state is:

idem state $PWD/helm_release.sls

Current Supported Resources



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

idem-helm-2.0.0.tar.gz (16.9 kB view hashes)

Uploaded Source

Built Distribution

idem_helm-2.0.0-py3-none-any.whl (17.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page