-
Notifications
You must be signed in to change notification settings - Fork 169
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
04b61fc
commit e905722
Showing
554 changed files
with
135,971 additions
and
4 deletions.
There are no files selected for viewing
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,22 @@ | ||
# Patterns to ignore when building packages. | ||
# This supports shell glob matching, relative path matching, and | ||
# negation (prefixed with !). Only one pattern per line. | ||
.DS_Store | ||
# Common VCS dirs | ||
.git/ | ||
.gitignore | ||
.bzr/ | ||
.bzrignore | ||
.hg/ | ||
.hgignore | ||
.svn/ | ||
# Common backup files | ||
*.swp | ||
*.bak | ||
*.tmp | ||
*~ | ||
# Various IDEs | ||
.project | ||
.idea/ | ||
*.tmproj | ||
.vscode/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
dependencies: | ||
- name: kube-prometheus-stack | ||
repository: https://prometheus-community.github.io/helm-charts | ||
version: 40.5.0 | ||
- name: falco | ||
repository: https://falcosecurity.github.io/charts | ||
version: 3.8.7 | ||
- name: metrics-server | ||
repository: https://charts.bitnami.com/bitnami | ||
version: 6.13.1 | ||
- name: telegraf-operator | ||
repository: https://helm.influxdata.com/ | ||
version: 1.4.0 | ||
- name: tailing-sidecar-operator | ||
repository: https://sumologic.github.io/tailing-sidecar | ||
version: 0.16.0 | ||
- name: opentelemetry-operator | ||
repository: https://open-telemetry.github.io/opentelemetry-helm-charts | ||
version: 0.56.1 | ||
- name: prometheus-windows-exporter | ||
repository: https://prometheus-community.github.io/helm-charts | ||
version: 0.3.1 | ||
digest: sha256:a8255b7e24517ab0c571158094f77fc00048696844db41b62bc4440b13429aca | ||
generated: "2024-10-14T15:33:30.163836591Z" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,49 @@ | ||
annotations: | ||
catalog.cattle.io/certified: partner | ||
catalog.cattle.io/display-name: Sumo Logic | ||
catalog.cattle.io/kube-version: '>=1.18-0' | ||
catalog.cattle.io/release-name: sumologic | ||
apiVersion: v2 | ||
appVersion: 4.11.0 | ||
dependencies: | ||
- condition: kube-prometheus-stack.enabled,sumologic.metrics.enabled | ||
name: kube-prometheus-stack | ||
repository: https://prometheus-community.github.io/helm-charts | ||
version: 40.5.0 | ||
- condition: falco.enabled | ||
name: falco | ||
repository: https://falcosecurity.github.io/charts | ||
version: 3.8.7 | ||
- condition: metrics-server.enabled | ||
name: metrics-server | ||
repository: https://charts.bitnami.com/bitnami | ||
version: 6.13.1 | ||
- condition: telegraf-operator.enabled | ||
name: telegraf-operator | ||
repository: https://helm.influxdata.com/ | ||
version: 1.4.0 | ||
- condition: tailing-sidecar-operator.enabled | ||
name: tailing-sidecar-operator | ||
repository: https://sumologic.github.io/tailing-sidecar | ||
version: 0.16.0 | ||
- condition: opentelemetry-operator.enabled,sumologic.metrics.collector.otelcol.enabled | ||
name: opentelemetry-operator | ||
repository: https://open-telemetry.github.io/opentelemetry-helm-charts | ||
version: 0.56.1 | ||
- condition: prometheus-windows-exporter.enabled,sumologic.metrics.collector.otelcol.enabled | ||
name: prometheus-windows-exporter | ||
repository: https://prometheus-community.github.io/helm-charts | ||
version: 0.3.1 | ||
description: A Helm chart for collecting Kubernetes logs, metrics, traces and events | ||
into Sumo Logic. | ||
home: https://github.com/SumoLogic/sumologic-kubernetes-collection | ||
icon: file://assets/icons/sumologic.png | ||
keywords: | ||
- monitoring | ||
- logging | ||
kubeVersion: '>=1.18-0' | ||
name: sumologic | ||
sources: | ||
- https://github.com/SumoLogic/sumologic-kubernetes-collection | ||
type: application | ||
version: 4.11.0 |
Large diffs are not rendered by default.
Oops, something went wrong.
21 changes: 21 additions & 0 deletions
21
charts/sumologic/sumologic/4.11.0/charts/falco/.helmignore
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
# Patterns to ignore when building packages. | ||
# This supports shell glob matching, relative path matching, and | ||
# negation (prefixed with !). Only one pattern per line. | ||
.DS_Store | ||
# Common VCS dirs | ||
.git/ | ||
.gitignore | ||
.bzr/ | ||
.bzrignore | ||
.hg/ | ||
.hgignore | ||
.svn/ | ||
# Common backup files | ||
*.swp | ||
*.bak | ||
*.tmp | ||
*~ | ||
# Various IDEs | ||
.project | ||
.idea/ | ||
*.tmproj |
192 changes: 192 additions & 0 deletions
192
charts/sumologic/sumologic/4.11.0/charts/falco/BREAKING-CHANGES.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,192 @@ | ||
# Helm chart Breaking Changes | ||
|
||
- [3.0.0](#300) | ||
- [Falcoctl](#falcoctl-support) | ||
- [Rulesfiles](#rulesfiles) | ||
- [Falco Images](#drop-support-for-falcosecurityfalco-image) | ||
- [Driver Loader Init Container](#driver-loader-simplified-logic) | ||
|
||
|
||
## 3.0.0 | ||
The new chart deploys new *k8s* resources and new configuration variables have been added to the `values.yaml` file. People upgrading the chart from `v2.x.y` have to port their configuration variables to the new `values.yaml` file used by the `v3.0.0` chart. | ||
|
||
If you still want to use the old values, because you do not want to take advantage of the new and shiny **falcoctl** tool then just run: | ||
```bash= | ||
helm upgrade falco falcosecurity/falco \ | ||
--namespace=falco \ | ||
--reuse-values \ | ||
--set falcoctl.artifact.install.enabled=false \ | ||
--set falcoctl.artifact.follow.enabled=false | ||
``` | ||
This way you will upgrade Falco to `v0.34.0`. | ||
|
||
**NOTE**: The new version of Falco itself, installed by the chart, does not introduce breaking changes. You can port your previous Falco configuration to the new `values.yaml` by copy-pasting it. | ||
|
||
|
||
### Falcoctl support | ||
|
||
[Falcoctl](https://https://github.com/falcosecurity/falcoctl) is a new tool born to automatize operations when deploying Falco. | ||
|
||
Before the `v3.0.0` of the charts *rulesfiles* and *plugins* were shipped bundled in the Falco docker image. It precluded the possibility to update the *rulesfiles* and *plugins* until a new version of Falco was released. Operators had to manually update the *rulesfiles or add new *plugins* to Falco. The process was cumbersome and error-prone. Operators had to create their own Falco docker images with the new plugins baked into it or wait for a new Falco release. | ||
|
||
Starting from the `v3.0.0` chart release, we add support for **falcoctl** in the charts. By deploying it alongside Falco it allows to: | ||
- *install* artifacts of the Falco ecosystem (i.e plugins and rules at the moment of writing) | ||
- *follow* those artifacts(only *rulesfile* artifacts are recommended), to keep them up-to-date with the latest releases of the Falcosecurity organization. This allows, for instance, to update rules detecting new vulnerabilities or security issues without the need to redeploy Falco. | ||
|
||
The chart deploys *falcoctl* using an *init container* and/or *sidecar container*. The first one is used to install artifacts and make them available to Falco at start-up time, the latter runs alongside Falco and updates the local artifacts when new updates are detected. | ||
|
||
Based on your deployment scenario: | ||
|
||
1. Falco without *plugins* and you just want to upgrade to the new Falco version: | ||
```bash= | ||
helm upgrade falco falcosecurity/falco \ | ||
--namespace=falco \ | ||
--reuse-values \ | ||
--set falcoctl.artifact.install.enabled=false \ | ||
--set falcoctl.artifact.follow.enabled=false | ||
``` | ||
When upgrading an existing release, *helm* uses the new chart version. Since we added new template files and changed the values schema(added new parameters) we explicitly disable the **falcoctl** tool. By doing so, the command will reuse the existing configuration but will deploy Falco version `0.34.0` | ||
|
||
2. Falco without *plugins* and you want to automatically get new *falco-rules* as soon as they are released: | ||
```bash= | ||
helm upgrade falco falcosecurity/falco \ | ||
--namespace=falco \ | ||
``` | ||
Helm first applies the values coming from the new chart version, then overrides them using the values of the previous release. The outcome is a new release of Falco that: | ||
* uses the previous configuration; | ||
* runs Falco version `0.34.0`; | ||
* uses **falcoctl** to install and automatically update the [*falco-rules*](https://github.com/falcosecurity/rules/); | ||
* checks for new updates every 6h (default value). | ||
|
||
|
||
3. Falco with *plugins* and you want just to upgrade Falco: | ||
```bash= | ||
helm upgrade falco falcosecurity/falco \ | ||
--namespace=falco \ | ||
--reuse-values \ | ||
--set falcoctl.artifact.install.enabled=false \ | ||
--set falcoctl.artifact.follow.enabled=false | ||
``` | ||
Very similar to scenario `1.` | ||
4. Falco with plugins and you want to use **falcoctl** to download the plugins' *rulesfiles*: | ||
* Save **falcoctl** configuration to file: | ||
```yaml= | ||
cat << EOF > ./falcoctl-values.yaml | ||
#################### | ||
# falcoctl config # | ||
#################### | ||
falcoctl: | ||
image: | ||
# -- The image pull policy. | ||
pullPolicy: IfNotPresent | ||
# -- The image registry to pull from. | ||
registry: docker.io | ||
# -- The image repository to pull from. | ||
repository: falcosecurity/falcoctl | ||
# -- Overrides the image tag whose default is the chart appVersion. | ||
tag: "main" | ||
artifact: | ||
# -- Runs "falcoctl artifact install" command as an init container. It is used to install artfacts before | ||
# Falco starts. It provides them to Falco by using an emptyDir volume. | ||
install: | ||
enabled: true | ||
# -- Extra environment variables that will be pass onto falcoctl-artifact-install init container. | ||
env: {} | ||
# -- Arguments to pass to the falcoctl-artifact-install init container. | ||
args: ["--verbose"] | ||
# -- Resources requests and limits for the falcoctl-artifact-install init container. | ||
resources: {} | ||
# -- Security context for the falcoctl init container. | ||
securityContext: {} | ||
# -- Runs "falcoctl artifact follow" command as a sidecar container. It is used to automatically check for | ||
# updates given a list of artifacts. If an update is found it downloads and installs it in a shared folder (emptyDir) | ||
# that is accessible by Falco. Rulesfiles are automatically detected and loaded by Falco once they are installed in the | ||
# correct folder by falcoctl. To prevent new versions of artifacts from breaking Falco, the tool checks if it is compatible | ||
# with the running version of Falco before installing it. | ||
follow: | ||
enabled: true | ||
# -- Extra environment variables that will be pass onto falcoctl-artifact-follow sidecar container. | ||
env: {} | ||
# -- Arguments to pass to the falcoctl-artifact-follow sidecar container. | ||
args: ["--verbose"] | ||
# -- Resources requests and limits for the falcoctl-artifact-follow sidecar container. | ||
resources: {} | ||
# -- Security context for the falcoctl-artifact-follow sidecar container. | ||
securityContext: {} | ||
# -- Configuration file of the falcoctl tool. It is saved in a configmap and mounted on the falcotl containers. | ||
config: | ||
# -- List of indexes that falcoctl downloads and uses to locate and download artiafcts. For more info see: | ||
# https://github.com/falcosecurity/falcoctl/blob/main/proposals/20220916-rules-and-plugin-distribution.md#index-file-overview | ||
indexes: | ||
- name: falcosecurity | ||
url: https://falcosecurity.github.io/falcoctl/index.yaml | ||
# -- Configuration used by the artifact commands. | ||
artifact: | ||
# -- List of artifact types that falcoctl will handle. If the configured refs resolves to an artifact whose type is not contained | ||
# in the list it will refuse to downloade and install that artifact. | ||
allowedTypes: | ||
- rulesfile | ||
install: | ||
# -- Do not resolve the depenencies for artifacts. By default is true, but for our use carse we disable it. | ||
resolveDeps: false | ||
# -- List of artifacts to be installed by the falcoctl init container. | ||
refs: [k8saudit-rules:0.5] | ||
# -- Directory where the *rulesfiles* are saved. The path is relative to the container, which in this case is an emptyDir | ||
# mounted also by the Falco pod. | ||
rulesfilesDir: /rulesfiles | ||
# -- Same as the one above but for the artifacts. | ||
pluginsDir: /plugins | ||
follow: | ||
# -- List of artifacts to be installed by the falcoctl init container. | ||
refs: [k8saudit-rules:0.5] | ||
# -- Directory where the *rulesfiles* are saved. The path is relative to the container, which in this case is an emptyDir | ||
# mounted also by the Falco pod. | ||
rulesfilesDir: /rulesfiles | ||
# -- Same as the one above but for the artifacts. | ||
pluginsDir: /plugins | ||
EOF | ||
``` | ||
* Set `falcoctl.artifact.install.enabled=true` to install *rulesfiles* of the loaded plugins. Configure **falcoctl** to install the *rulesfiles* of the plugins you are loading with Falco. For example, if you are loading **k8saudit** plugin then you need to set `falcoctl.config.artifact.install.refs=[k8saudit-rules:0.5]`. When Falco is deployed the **falcoctl** init container will download the specified artifacts based on their tag. | ||
* Set `falcoctl.artifact.follow.enabled=true` to keep updated *rulesfiles* of the loaded plugins. | ||
* Proceed to upgrade your Falco release by running: | ||
```bash= | ||
helm upgrade falco falcosecurity/falco \ | ||
--namespace=falco \ | ||
--reuse-values \ | ||
--values=./falcoctl-values.yaml | ||
``` | ||
5. Falco with **multiple sources** enabled (syscalls + plugins): | ||
1. Upgrading Falco to the new version: | ||
```bash= | ||
helm upgrade falco falcosecurity/falco \ | ||
--namespace=falco \ | ||
--reuse-values \ | ||
--set falcoctl.artifact.install.enabled=false \ | ||
--set falcoctl.artifact.follow.enabled=false | ||
``` | ||
2. Upgrading Falco and leveraging **falcoctl** for rules and plugins. Refer to point 4. for **falcoctl** configuration. | ||
|
||
|
||
### Rulesfiles | ||
Starting from `v0.3.0`, the chart drops the bundled **rulesfiles**. The previous version was used to create a configmap containing the following **rulesfiles**: | ||
* application_rules.yaml | ||
* aws_cloudtrail_rules.yaml | ||
* falco_rules.local.yaml | ||
* falco_rules.yaml | ||
* k8s_audit_rules.yaml | ||
|
||
The reason why we are dropping them is pretty simple, the files are already shipped within the Falco image and do not apport any benefit. On the other hand, we had to manually update those files for each Falco release. | ||
|
||
For users out there, do not worry, we have you covered. As said before the **rulesfiles** are already shipped inside the Falco image. Still, this solution has some drawbacks such as users having to wait for the next releases of Falco to get the latest version of those **rulesfiles**. Or they could manually update them by using the [custom rules](https://https://github.com/falcosecurity/charts/tree/master/falco#loading-custom-rules). | ||
|
||
We came up with a better solution and that is **falcoctl**. Users can configure the **falcoctl** tool to fetch and install the latest **rulesfiles** as provided by the *falcosecurity* organization. For more info, please check the **falcoctl** section. | ||
|
||
**NOTE**: if any user (wrongly) used to customize those files before deploying Falco please switch to using the [custom rules](https://https://github.com/falcosecurity/charts/tree/master/falco#loading-custom-rules). | ||
|
||
### Drop support for `falcosecurity/falco` image | ||
|
||
Starting from version `v2.0.0` of the chart the`falcosecurity/falco-no-driver` is the default image. We were still supporting the `falcosecurity/falco` image in `v2.0.0`. But in `v2.2.0` we broke the chart when using the `falcosecurity/falco` image. For more info please check out the following issue: https://github.com/falcosecurity/charts/issues/419 | ||
|
||
#### Driver-loader simplified logic | ||
There is only one switch to **enable/disable** the driver-loader init container: driver.loader.enabled=true. This simplification comes as a direct consequence of dropping support for the `falcosecurity/falco` image. For more info: https://github.com/falcosecurity/charts/issues/418 |
Oops, something went wrong.