arillso.container.helm role – Deploy Helm charts to Kubernetes clusters

Note

This role is part of the arillso.container collection (version 1.0.2).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install arillso.container.

To use it in a playbook, specify: arillso.container.helm.

Entry point main – Deploy Helm charts to Kubernetes clusters

Synopsis

  • This role manages Helm chart deployments to Kubernetes clusters. Supports repository management, chart installation, and validation.

Parameters

Parameter

Comments

helm_chart_defaults

dictionary

Default values for all chart deployments

Default: {"create_namespace": false, "namespace": "default", "timeout": "5m"}

helm_charts

list / elements=dictionary

List of Helm charts to deploy. Each chart requires: - name: Chart release name - chart: Chart name - repository: Repository key from helm_repositories - version: Chart version - namespace: Target namespace - create_namespace: Create namespace if missing - values: Chart values override

Default: []

helm_debug_enabled

boolean

Enable debug output for Helm commands

Choices:

  • false ← (default)

  • true

helm_deployment_timeout

integer

Timeout for deployment in seconds

Default: 600

helm_deployment_wait

boolean

Wait for deployment to complete

Choices:

  • false

  • true ← (default)

helm_enable_charts

boolean

Enable Helm chart deployment

Choices:

  • false ← (default)

  • true

helm_kubectl_context

string

Kubernetes context to use for Helm operations

Default: ""

helm_log_level

string

Helm log level

Choices:

  • "debug"

  • "info" ← (default)

  • "warn"

  • "error"

helm_repositories

dictionary

Dictionary of Helm repositories. Key is repository name, value is repository URL.

Default: {}

helm_target_groups

list / elements=string

Inventory groups to target for Helm operations

Default: ["kubernetes_masters", "k3s_servers", "k8s_masters", "control_plane"]

helm_target_host

string

Target host for Helm operations

Default: "{{ inventory_hostname }}"

helm_validation_delay

integer

Delay between validation retries in seconds

Default: 30

helm_validation_enabled

boolean

Enable post-deployment validation

Choices:

  • false

  • true ← (default)

helm_validation_retries

integer

Number of validation retry attempts

Default: 10

helm_validation_timeout

integer

Timeout for validation checks in seconds

Default: 300

Authors

  • Simon Bärlocher