Lint Passed + Helm Collector

✓ Guardrail ↓ Collector Beta Deployment And Infrastructure

Enforce Lint Passed using data collected by Helm Collector. Automatically check deployment and infrastructure standards on every PR.

Guardrail: Validates that all Helm charts pass helm lint. Charts that fail linting may have template errors, missing required values, or invalid YAML that will cause deployment failures.

Data Source: Parse Helm charts to extract chart metadata, lint validation results, values schema presence, and dependency version constraints. Runs helm lint on discovered charts and normalizes results for policy evaluation.

Get Started View on GitHub

How Helm Collector Powers This Guardrail

The Helm Collector gathers metadata from your orchestration systems. This data flows into Lunar's Component JSON, where the Lint Passed guardrail evaluates it against your standards.

When enabled, this check runs automatically on every PR and in AI coding workflows, providing real-time enforcement with actionable feedback.

↓ Helm Collector Gathers Data Collector

Extracts metadata from code, configs, and tool outputs

{ } Component JSON

Data centralized in structured format for evaluation

✓ Lint Passed Checks Guardrail

Pass/fail result with actionable feedback in PRs

Quick Start Configuration

Add both the collector and policy to your lunar-config.yml to enable this guardrail.

📄 lunar-config.yml

# Step 1: Enable the Helm Collector
collectors:
  - uses: github://earthly/lunar-lib/collectors/helm@v1.0.5
    # with: ...

# Step 2: Enable the Helm Guardrails
policies:
  - uses: github://earthly/lunar-lib/policies/helm@v1.0.5
    include: [lint-passed]
    # with: ...

What Helm Collector Collects

This collector gathers the following data that the Lint Passed guardrail evaluates.

Collector code

`charts`

Finds all Helm charts in the repository (directories containing Chart.yaml) and collects:

Chart metadata (name, version, appVersion)
Helm lint validation results and errors
Values schema presence (values.schema.json)
Chart dependencies with version constraints

Collector ci-after-command

`cicd`

Tracks helm commands executed in CI pipelines (install, upgrade, template, package, etc.). Records every invocation for audit trails and captures the helm version used.

Example Data Flow

Here's an example of the data that Helm Collector writes to the Component JSON, which Lint Passed then evaluates.

{ } component.json From Helm Collector

{
  "k8s": {
    "helm": {
      "source": {
        "tool": "helm",
        "version": "3.14.0"
      },
      "charts": [
        {
          "path": "charts/api",
          "name": "api",
          "version": "1.2.3",
          "app_version": "2.0.0",
          "version_is_semver": true,
          "lint_passed": true,
          "lint_errors": [],
          "has_values_schema": true,
          "schema_path": "charts/api/values.schema.json",
          "dependencies": [
            {
              "name": "postgresql",
              "version": "~11.9.0",
              "repository": "https://charts.bitnami.com/bitnami",
              "is_pinned": true
            },
            {
              "name": "redis",
              "version": "*",
              "repository": "https://charts.bitnami.com/bitnami",
              "is_pinned": false
            }
          ]
        }
      ],
      "cicd": {
        "cmds": [
          {"cmd": "helm upgrade --install api ./charts/api -f values-prod.yaml", "version": "3.14.0"},
          {"cmd": "helm template api ./charts/api", "version": "3.14.0"}
        ],
        "source": {"tool": "helm", "integration": "ci"}
      }
    }
  }
}

Configuration Options

Helm Collector Inputs

Input	Required	Default	Description
`find_command`	Optional	`find . -type f \( -name 'Chart.yaml' -o -name 'Chart.yml' \)`	Command to find Chart.yaml files (must output one file path per line)
`lint_strict`	Optional	`false`	Enable strict mode for helm lint (true/false)

Learn More

Guardrail · Helm Guardrails Lint Passed View all compatible integrations

→

Collector Helm Collector View full documentation

→

Ready to Automate Your Standards?

See how Lunar can turn your AGENTS.md, engineering wiki, compliance docs, or postmortem action items into automated guardrails with our 200+ built-in guardrails.

Works with any process

AI agent rules & prompt files

Post-mortem action items

Security & compliance policies

Testing & quality requirements

Automate Now

Paste your AGENTS.md or manual process doc and get guardrails in minutes

Book a Demo