Sysdig Helm Charts

This GitHub repository is the official source for Sysdig's Helm charts.

For instructions about how to install charts from this repository, visit the public website at https://charts.sysdig.com

Contribute

Development

- Make changes to an existing chart without publishing

If you make changes to an existing chart, but do not change its version, nothing new will be published to the charts repository.

Pull Requests

Checklist to comply-with when doing the PR

• Title of the PR starts with chart name (e.g. [mychartname])
• Chart Version bumped
• Variables are documented in the README.md (or README.tpl in some charts)
• Check GithubAction checks (like lint) to avoid merge-check stoppers

- GithubAction Checks

Make sure to comply with

• lint checks, running

  $ make lint

• docs autogeneration, based on values.yaml. this does only apply to charts with README.tpl templates (ex.: admission-controller)

  $ make docs

To do this automatically, you can install pre-commit plugin, configured in /.pre-commit-config.yaml, to automate this step, and validate/detect the issues when committing from your local.

GithubPages / Documentation

https://charts.sysdig.com is managed through GithubPages action. .github/workflows/release.yml will merge each charts/*/README.md into the gh-pages branch.

- Add a new chart

To add a new chart, create a directory inside charts with it contents at master branch.

When you commit it, it will be picked up by the GitHub action, and if it contains a chart and version that doesn't already exist in the charts repository, a new release with the package for the chart will be published on the GitHub repository, and the list of all charts at index.yaml on gh-pages branch will be updated on the charts repository.

Release

- Publishing a new version of a chart

TL;DR
When a commit to master includes a new version of a chart, a GitHub action will make it available on the charts repository.

With each commit to master, a GitHub action will compare all charts versions at the charts folder on master branch with published versions at the index.yaml chart list on gh-pages branch.

When it detects that the version in the folder doesn't exist in index.yaml, it will create a release with the packaged chart content on the GitHub repository, and update index.yaml to include it on the charts repository.

index.yaml is accesible from https://sysdiglabs.github.io/charts/index.yaml and is the list of all charts and their versions available when you interact with the charts repository using Helm.

The packaged referenced in index.yaml, when it's updated using the GitHub action, will link for download to the URL provided by the GitHub repository release files.

More information

You can find more information at:

• charts.sysdig.com/ / sysdiglabs.github.io/charts
• The Helm package manager
• Chart Releaser
• Chart Releaser GitHub Action